ansys.mapdl.core.Mapdl.ksel#

Mapdl.ksel(type_='', item='', comp='', vmin='', vmax='', vinc='', kabs='', **kwargs)#

Selects a subset of keypoints or hard points.

Mechanical APDL Command: KSEL

Parameters:
type_str

Label identifying the type of select:

  • S - Select a new set (default).

  • R - Reselect a set from the current set.

  • A - Additionally select a set and extend the current set.

  • U - Unselect a set from the current set.

  • ALL - Restore the full set.

  • NONE - Unselect the full set.

  • INVE - Invert the current set (selected becomes unselected and vice versa).

  • STAT - Display the current select status.

itemstr

Label identifying data. Valid item labels are shown in the table below. Some items also require a component label. If Item = PICK (or simply “P”), graphical picking is enabled and all remaining command fields are ignored (valid only in the GUI). Defaults to KP.

compstr

Component of the item (if required). Valid component labels are shown in the table below.

vminstr

Minimum value of item range. Ranges are keypoint numbers, coordinate values, attribute numbers, etc., as appropriate for the item. A component name (as specified on the cm command) may also be substituted for VMIN ( VMAX and VINC are ignored). If Item = MAT, TYPE, REAL, or ESYS and if VMIN is positive, the absolute value of Item is compared against the range for selection; if VMIN is negative, the signed value of Item is compared. See the klist command for a discussion of signed attributes.

vmaxstr

Maximum value of item range. VMAX defaults to VMIN.

vincstr

Value increment within range. Used only with integer ranges (such as for keypoint numbers). Defaults to 1. VINC cannot be negative.

kabsint or str

Absolute value key:

  • 0 - Check sign of value during selection.

  • 1 - Use absolute value during selection (sign ignored).

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

Selects a subset of keypoints or hard points. For example, to select a new set of keypoints based on keypoint numbers 1 through 7, use ksel,S,KP,,1,7. The selected subset is used when the ALL label is entered (or implied) on other commands, such as klist,ALL. Only data identified by keypoint number are selected. Data are flagged as selected and unselected; no data are actually deleted from the database.

This command is valid in any processor.

For selections based on non-integer numbers (coordinates, results, etc.), items that are within the range VMIN - Toler and VMAX + Toler are selected. The default tolerance Toler is based on the relative values of VMIN and VMAX as follows:

  • If VMIN = VMAX, Toler = 0.005 x VMIN.

  • If VMIN = VMAX = 0.0, Toler = 1.0E-6.

  • If VMAX ≠ VMIN, Toler = 1.0E-8 x ( VMAX - VMIN ).

Use the SELTOL seltol command to override this default and specify Toler explicitly.

KSEL - Valid Item and Component Labels#

Valid Item and Component Labels ksel, Type, Item, Comp, VMIN, VMAX, VINC, KABS#

Item

Comp

Description

KP

Keypoint number.

EXT

Keypoint numbers on exterior of selected lines (ignore remaining fields).

HPT

Hard point number.

LOC

X,Y,Z

X, Y, or Z location in the active coordinate system.

MAT

Material number associated with the keypoint.

TYPE

Element type number associated with the keypoint.

REAL

Real constant set number associated with the keypoint.

ESYS

Element coordinate system associated with the keypoint.