Skip to main content
Version: 15

SELECT

Selects objects in the model.

Description

With the SELECT command, objects can be selected from the model. There are several different selection methods available through the Selection type parameter.

Syntax

SELECT [Selection type] Selection parameters...

Selection types

Available selection types:

Selection typeDescription
AllSelects all objects in the model
InvertInverts the selection
By_IDSelection by object ID
By_TypeSelection by object type
By_AttributeSelection by object type and attribute(s)
By_UserManual selection by the user during the script run

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

SELECT All

Detailed description of selection types

SELECT All

Selects all previously created objects in the model.

Syntax

SELECT All

Sample code

Command only:

SELECT All

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

SELECT All

SELECT Invert

Inverts the selection. In other words, selects model objects that were unselected, and deselects model objects that were selected previously.

Syntax

SELECT Invert

Sample code

Command only:

SELECT Invert

With added prerequisites: (object creation and selection)

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

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

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

SELECT BY_ID Mem_ID1

SELECT Invert

SELECT By_ID

Selects specific objects in the model by ID.

Syntax

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

Command parameters

Command parameterAssignmentValue formatInput options
IDsRequiredStringLocal, variable

IDs:

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

Sample code

Command only:

SELECT BY_ID ID1

With added prerequisites (object creation) and multiple objects:

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

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

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

SELECT BY_ID Mem_ID1 Mem_ID2

SELECT By_Type

Selects specific objects in the model by type. All objects within the given object type will be selected.

Syntax

SELECT By_Type [Object type]

Command parameters

Command parameterAssignmentValue formatInput options
Object typeRequiredPredefined stringsLocal, variable

Object type:

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

Available object types:
Object type nameObject type
Geometry tab-
PointPoint
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.

Sample code

Command only:

SELECT 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 By_Type Structural_Member

SELECT By_Attribute

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

Syntax

SELECT 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 selected. Only 1 object type can be given within one SELECT By_Attribute command.

Available object types:
Object type nameObject type
Geometry tab-
PointPoint
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 selection will be restricted within the given object type. An arbitrary number of object attributes can be given for one SELECT By_Attribute command. The final selection will contain 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.

Sample code

Command only:

Selects all structural members that have the name "B1":

SELECT By_Attribute Structural_Member
Name B1

Selects all structural members that have 7 DOF finite element type:

SELECT By_Attribute Structural_Member
FE_Type 7DOFelem

Selects all structural members that have 300 set as their initial bow imperfection L/z value:

SELECT By_Attribute Structural_Member
GeomImpW 300

Selects all points at the (0, 0, 0) global coordinate location:

SELECT By_Attribute Point
X 0
Y 0
Z 0

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 By_Attribute Point
X 0
Y 0
Z 0

SELECT By_Attribute Structural_Member
GeomImpW 300

SELECT By_User

Requests manual selection from the user during the script run.

With this command the user can manually select objects during the script run. A window will pop up which requests the user to select objects from the model.

The steps of the selection are the following:

  • Click on the select button on the dialogue window
  • Select objects in the model
  • End the selection with a right click
    The window after this step should look like this:

     

  • Click on OK

Syntax

SELECT By_User [Object type]

Command parameters

Command parameterAssignmentValue formatInput options
Object typeOptionalPredefined stringsLocal, variable

Object type:

The type of selectable objects can be restricted with this optional parameter. Only 1 object type can be given.

Available object types: same ones as in case of the By_Type selection.

Sample code

Command only:

SELECT By_User

With added prerequisites: (object creation)

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

CREATE MemID1 Structural_member "HEA 200"
0 0 0
0 0 3000

SELECT By_User Structural_Member