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 type | Description |
---|---|
All | Selects all objects in the model |
Invert | Inverts the selection |
By_ID | Selection by object ID |
By_Type | Selection by object type |
By_Attribute | Selection by object type and attribute(s) |
By_User | Manual 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 parameter | Assignment | Value format | Input options |
---|---|---|---|
IDs | Required | String | Local, 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 parameter | Assignment | Value format | Input options |
---|---|---|---|
Object type | Required | Predefined strings | Local, 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 name | Object type |
---|---|
Geometry tab | - |
Point | Point |
Line | Line |
Arc | CircleArc |
Two-dimensional figure | Polygon |
Dimension line | Dimension_Line |
Dimension radius and diameter | Dimension_Radius |
Dimension arc | Dimension_Arc |
Dimension angle | Dimension_Angle |
Dimension height | Dimension_Height |
Dimension textbox | Dimension_Textbox |
Structural members tab | - |
Member | Structural_Member |
Plate | Structural_Plate |
Diaphragm | Structural_Diaphragm |
Rigid body | Structural_RigidBody |
Haunch | Haunched_Member |
Tapered member | Tapered_Member |
Concrete beam reinforcement | Concrete_Beam_Place |
Concrete column reinforcement | Concrete_Column_Place |
Point support | Support_Point |
Line support | Support_Edge |
Surface support | Support_Plate |
Shear field | ShearField |
Link | Link |
Smart link | SmartLink |
Purlin line | PurlinLine_Place |
Purlin overlap and support zone | PurlinJoint_Place |
Rectangular cutout | Hole_Rec |
Circular cutout | Hole_Circ |
Hexagonal cutout | Hole_Hex |
Perpendicular plate stiffener | Stiffener_PlatePerp |
Parallel plate stiffener | Stiffener_PlatePar |
Perpendicular section stiffener | Stiffener_Section |
Placed joint | Joint_Place |
Loads tab | - |
Point load | NodeForce |
Line load | MemberForce |
Line wind load | LineWindForce |
Surface load | PlateForce |
Load transfer surface | LoadTransferSurface |
Line temperature load | MemberThermal |
Surface temperature load | PlateThermal |
Prescribed displacement | PresDisp |
Change in length | Elongation |
Tension force | Pretension |
Influence line | MovingLoadPath |
Influence graph | InfluGraph |
Wind surface | WindSurface |
Snow surface | SnowSurface |
Surface wind load | SurfWindForce |
Surface snow load | SurfSnowForce |
Fire load | MemberFireEffect |
Mass tab | - |
Node mass | NodeMass |
Finite element tab | - |
Constraint | Structural_Constraint |
Stiffener warping support | Stiffener_Warping_Support |
Other | - |
Section plane | Result_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 parameter | Assignment | Value format | Input options |
---|---|---|---|
Object type | Required | Predefined strings | Local, variable |
Object attributes | Required | Predefined strings | Local, variable |
Attribute values | Required | String | Local, 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 name | Object type |
---|---|
Geometry tab | - |
Point | Point |
Line | Line |
Arc | CircleArc |
Two-dimensional figure | Polygon |
Dimension line | Dimension_Line |
Dimension radius and diameter | Dimension_Radius |
Dimension arc | Dimension_Arc |
Dimension angle | Dimension_Angle |
Dimension height | Dimension_Height |
Dimension textbox | Dimension_Textbox |
Structural members tab | - |
Member | Structural_Member |
Plate | Structural_Plate |
Diaphragm | Structural_Diaphragm |
Rigid body | Structural_RigidBody |
Haunch | Haunched_Member |
Tapered member | Tapered_Member |
Concrete beam reinforcement | Concrete_Beam_Place |
Concrete column reinforcement | Concrete_Column_Place |
Point support | Support_Point |
Line support | Support_Edge |
Surface support | Support_Plate |
Shear field | ShearField |
Link | Link |
Smart link | SmartLink |
Purlin line | PurlinLine_Place |
Purlin overlap and support zone | PurlinJoint_Place |
Rectangular cutout | Hole_Rec |
Circular cutout | Hole_Circ |
Hexagonal cutout | Hole_Hex |
Perpendicular plate stiffener | Stiffener_PlatePerp |
Parallel plate stiffener | Stiffener_PlatePar |
Perpendicular section stiffener | Stiffener_Section |
Placed joint | Joint_Place |
Loads tab | - |
Point load | NodeForce |
Line load | MemberForce |
Line wind load | LineWindForce |
Surface load | PlateForce |
Load transfer surface | LoadTransferSurface |
Line temperature load | MemberThermal |
Surface temperature load | PlateThermal |
Prescribed displacement | PresDisp |
Change in length | Elongation |
Tension force | Pretension |
Influence line | MovingLoadPath |
Influence graph | InfluGraph |
Wind surface | WindSurface |
Snow surface | SnowSurface |
Surface wind load | SurfWindForce |
Surface snow load | SurfSnowForce |
Fire load | MemberFireEffect |
Mass tab | - |
Node mass | NodeMass |
Finite element tab | - |
Constraint | Structural_Constraint |
Stiffener warping support | Stiffener_Warping_Support |
Other | - |
Section plane | Result_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 parameter | Assignment | Value format | Input options |
---|---|---|---|
Object type | Optional | Predefined strings | Local, 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