ansys.mapdl.core.Mapdl.k

Mapdl.k(npt='', x='', y='', z='', **kwargs)

Defines a keypoint.

Mechanical APDL Command: K

Parameters:

nptstr

Reference number for keypoint. If zero, the lowest available number is assigned ( numstr ).

xstr

Keypoint location in the active coordinate system (may be R, θ, Z or R, θ, Φ). If X = P, graphical picking is enabled and all other fields (including NPT ) are ignored (valid only in the GUI).

ystr

Keypoint location in the active coordinate system (may be R, θ, Z or R, θ, Φ). If X = P, graphical picking is enabled and all other fields (including NPT ) are ignored (valid only in the GUI).

zstr

Keypoint location in the active coordinate system (may be R, θ, Z or R, θ, Φ). If X = P, graphical picking is enabled and all other fields (including NPT ) are ignored (valid only in the GUI).

Returns:

int

The keypoint number of the generated keypoint.

Notes

Defines a keypoint in the active coordinate system ( csys ) for line, area, and volume descriptions. A previously defined keypoint of the same number will be redefined. Keypoints may be redefined only if it is not yet attached to a line or is not yet meshed. Solid modeling in a toroidal system is not recommended.

Examples

Create keypoint at (0, 1, 2)

>>> knum = mapdl.k('', 0, 1, 2)
>>> knum
1

Create keypoint at (10, 11, 12) while specifying the keypoint number.

>>> knum = mapdl.k(5, 10, 11, 12)
>>> knum
5