ldiv#
- Mapdl.ldiv(nl1='', ratio='', pdiv='', ndiv='', keep='', **kwargs)#
Divides a single line into two or more lines.
APDL Command: LDIV
Divides a single line NL1 (defined from keypoint P1 to keypoint P2) into two or more lines. Line NL1 becomes the new line beginning with keypoint P1 and new lines are generated ending at keypoint P2. If the line is attached to an area, the area will also be updated. Line divisions are set to zero (use LESIZE, etc. to modify).
- Parameters:
- nl1
Number of the line to be divided. If negative, assume P1 (see below) is the second keypoint of the line instead of the first for RATIO. If ALL, divide all selected lines [LSEL]. A component name may also be substituted for NL1.
- ratio
Ratio of line length P1-PDIV to line length P1-P2. Must be between 0.0 and 1.0. Input ignored if NDIV > 2.
- pdiv
Number to be assigned to keypoint generated at division location (defaults to lowest available keypoint number [NUMSTR]). Input ignored if NL1 = ALL or NDIV > 2. If PDIV already exists and lies on line NL1, divide line at PDIV (RATIO must also be 0.0). If PDIV already exists and does not lie on line NL1, PDIV is projected and moved to the nearest point on line NL1 (if possible). PDIV cannot be attached to another line, area, or volume.
- ndiv
The number of new lines to be generated from old line (defaults to 2).
- keep
Specifies whether to keep the input entities:
0 - Modify old line to use new keypoints and slopes.
- 1 - Do not modify old line. New lines will overlay old
line and have unique keypoints.
- Returns:
str
MAPDL command output.
- Return type:
Examples
Create a single line and divide it exactly half.
>>> k0 = mapdl.k("", 0, 0, 0) >>> k1 = mapdl.k("", 1, 0, 0) >>> l0 = mapdl.l(k0, k1) >>> output = mapdl.ldiv(l0, ratio=0.5) >>> print(output) DIVIDE LINE 1 RATIO= 0.50000 NEW KEYPOINT= 0 NUMBER OF LINES DIVIDED = 1
Create a single line and divide it into 5 pieces.
>>> k0 = mapdl.k("", 0, 0, 0) >>> k1 = mapdl.k("", 1, 0, 0) >>> l0 = mapdl.l(k0, k1) >>> mapdl.ldiv(l0, ndiv=5)