Skip to main content
Version: 17

DESELECT

Deselects objects in the model.

Description​

With the DESELECT command, objects in the model can be deselected from the current selection. There are several different selection methods available through the Selection type parameter.

Syntax​

DESELECT [Selection type] Selection parameters...

Selection types​

Available selection types:

Selection typeDescription
AllDeselects all objects in the model
By_IDDeselection by object ID
By_TypeDeselection by object type
By_AttributeDeselection by object type and attribute(s)

Command parameters​

Selection type:​

The available selection parameters and their meaning depends on the chosen selection type. Detailed description of all selection parameters for each individual selection type can be found below.

Sample code​

DESELECT All

Detailed description of selection types​

DESELECT All​

Deselects all selected objects in the model.

Syntax​

DESELECT All

Sample code​

Command only:

DESELECT All

With added prerequisites: (object creation)

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

CREATE ID1 Structural_member "HEA 200"
0 0 0
0 0 3000

SELECT ALL

DESELECT ALL

DESELECT By_ID​

Deselects specific objects in the model by ID.

Syntax​

DESELECT By_ID [ID1] [ID2] [ID3] etc.

Command parameters​

Command parameterAssignmentValue formatInput options
IDsRequiredStringLocal, variable

IDs:​

Exact identification strings of the objects chosen for deselection. Multiple IDs can be given within one DESELECT BY_ID command. IDs need to be separated by spaces.

Sample code​

Command only:

DESELECT BY_ID ID1

With added prerequisites (object creation) and multiple objects:

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

CREATE ID1 Structural_member "HEA 200"
0 0 0
0 0 3000

CREATE ID2 Structural_member "HEA 200"
1000 0 0
1000 0 3000

SELECT ALL

DESELECT BY_ID ID1 ID2

DESELECT By_Type​

Deselects specific objects in the model by type.

Syntax​

DESELECT By_Type [Object type]

Command parameters​

Command parameterAssignmentValue formatInput options
Object typeRequiredPredefined stringsLocal, variable

Object type:​

The type of objects to be deselected. Only 1 object type can be given within one DESELECT By_Type command.

Available object types:
Object type nameObject type
Geometry tab-
LineLine
ArcCircleArc
Two-dimensional figurePolygon
Dimension lineDimension_Line
Dimension radius and diameterDimension_Radius
Dimension arcDimension_Arc
Dimension angleDimension_Angle
Dimension heightDimension_Height
Dimension textboxDimension_Textbox
Structural members tab-
MemberStructural_Member
PlateStructural_Plate
DiaphragmStructural_Diaphragm
Rigid bodyStructural_RigidBody
HaunchHaunched_Member
Tapered memberTapered_Member
Concrete beam reinforcementConcrete_Beam_Place
Concrete column reinforcementConcrete_Column_Place
Point supportSupport_Point
Line supportSupport_Edge
Surface supportSupport_Plate
Shear fieldShearField
LinkLink
Smart linkSmartLink
Purlin linePurlinLine_Place
Purlin overlap and support zonePurlinJoint_Place
Rectangular cutoutHole_Rec
Circular cutoutHole_Circ
Hexagonal cutoutHole_Hex
Perpendicular plate stiffenerStiffener_PlatePerp
Parallel plate stiffenerStiffener_PlatePar
Perpendicular section stiffenerStiffener_Section
Placed jointJoint_Place
Loads tab-
Point loadNodeForce
Line loadMemberForce
Line wind loadLineWindForce
Surface loadPlateForce
Load transfer surfaceLoadTransferSurface
Line temperature loadMemberThermal
Surface temperature loadPlateThermal
Prescribed displacementPresDisp
Change in lengthElongation
Tension forcePretension
Influence lineMovingLoadPath
Influence graphInfluGraph
Wind surfaceWindSurface
Snow surfaceSnowSurface
Surface wind loadSurfWindForce
Surface snow loadSurfSnowForce
Fire loadMemberFireEffect
Mass tab-
Node massNodeMass
Finite element tab-
ConstraintStructural_Constraint
Stiffener warping supportStiffener_Warping_Support
Other-
Section planeResult_Plane

More information about object types can be found at the CREATE command.

Description​

Deselects specific objects in the model by type. All objects within the given object type will be deselected.

Sample code​

Command only:

DESELECT BY_TYPE Structural_Member

With added prerequisites: (object creation)

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

CREATE Mem_ID1 Structural_member "HEA 200"
0 0 0
0 0 3000

CREATE Sup_ID1 Support_Point Mem_ID1 Fixed
0 0 0

SELECT ALL

DESELECT BY_TYPE Structural_Member

DESELECT By_Attribute​

Deselects specific objects in the model by type and attribute.

Syntax​

DESELECT By_Attribute [Object type]
[Object attribute 1] [Attribute value 1]
[Object attribute 2] [Attribute value 2]
[Object attribute 3] [Attribute value 3]
etc.

Command parameters​

Command parameterAssignmentValue formatInput options
Object typeRequiredPredefined stringsLocal, variable
Object attributesRequiredPredefined stringsLocal, variable
Attribute valuesRequiredStringLocal, variable

Object type:​

The type of objects to be deselected. Only 1 object type can be given within one DESELECT By_Attribute command.

Available object types:
Object type nameObject type
Geometry tab-
LineLine
ArcCircleArc
Two-dimensional figurePolygon
Dimension lineDimension_Line
Dimension radius and diameterDimension_Radius
Dimension arcDimension_Arc
Dimension angleDimension_Angle
Dimension heightDimension_Height
Dimension textboxDimension_Textbox
Structural members tab-
MemberStructural_Member
PlateStructural_Plate
DiaphragmStructural_Diaphragm
Rigid bodyStructural_RigidBody
HaunchHaunched_Member
Tapered memberTapered_Member
Concrete beam reinforcementConcrete_Beam_Place
Concrete column reinforcementConcrete_Column_Place
Point supportSupport_Point
Line supportSupport_Edge
Surface supportSupport_Plate
Shear fieldShearField
LinkLink
Smart linkSmartLink
Purlin linePurlinLine_Place
Purlin overlap and support zonePurlinJoint_Place
Rectangular cutoutHole_Rec
Circular cutoutHole_Circ
Hexagonal cutoutHole_Hex
Perpendicular plate stiffenerStiffener_PlatePerp
Parallel plate stiffenerStiffener_PlatePar
Perpendicular section stiffenerStiffener_Section
Placed jointJoint_Place
Loads tab-
Point loadNodeForce
Line loadMemberForce
Line wind loadLineWindForce
Surface loadPlateForce
Load transfer surfaceLoadTransferSurface
Line temperature loadMemberThermal
Surface temperature loadPlateThermal
Prescribed displacementPresDisp
Change in lengthElongation
Tension forcePretension
Influence lineMovingLoadPath
Influence graphInfluGraph
Wind surfaceWindSurface
Snow surfaceSnowSurface
Surface wind loadSurfWindForce
Surface snow loadSurfSnowForce
Fire loadMemberFireEffect
Mass tab-
Node massNodeMass
Finite element tab-
ConstraintStructural_Constraint
Stiffener warping supportStiffener_Warping_Support
Other-
Section planeResult_Plane

More information about object types can be found at the CREATE command.

Object attributes:​

The object attributes by which the deselection will be restricted within the given object type. An arbitrary number of object attributes can be given for one DESELECT By_Attribute command. The final deselection will affect only those objects for which all the given attribute values are true.

The list of available object attributes depends on the object type. The full list of object attributes can be found at the CREATE command for each object type.

Attribute values:​

The actual value of the given attribute.

Description​

Deselects specific objects in the model by type and all given object attributes.

Sample code​

Command only:

DESELECT BY_ATTRIBUTE Structural_Member
GeomImpW 300

With added prerequisites: (object creation)

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

CREATE Mem_ID1 Structural_member "HEA 200"
0 0 0
0 0 3000
GeomimpW 300

CREATE Mem_ID2 Structural_Member "HEA 200"
3000 0 0
3000 0 3000
GeomimpW 500

SELECT ALL

DESELECT BY_ATTRIBUTE Structural_Member
GeomImpW 300