kl

Keypoints.kl(nl1='', ratio='', nk1='', **kwargs)

Generates a keypoint at a specified location on an existing line.

Mechanical APDL Command: KL

Parameters:

nl1str

Number of the line. If negative, the direction of line (as interpreted for RATIO ) is reversed. If NL1 = P, graphical picking is enabled and all remaining command fields are ignored (valid only in the GUI).

ratiostr

Ratio of line length to locate keypoint. Must be between 0.0 and 1.0. Defaults to 0.5 (divide the line in half).

nk1str

Number to be assigned to keypoint generated at division location (defaults to lowest available keypoint number ( numstr )).

Returns:

int

Keypoint number of the generated keypoint.

Examples

Create a keypoint on a line from (0, 0, 0) and (10, 0, 0)

>>> kp0 = (0, 0, 0)
>>> kp1 = (10, 0, 0)
>>> knum0 = mapdl.k("", *kp0)
>>> knum1 = mapdl.k("", *kp1)
>>> lnum = mapdl.l(knum0, knum1)
>>> lnum
1