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