CREATE
Creates an object.
Syntax
CREATE [Object ID] [Object type]
Object parameters...
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object type | Required | Predefined strings | Local, variable |
| Object parameters | Required | - | - |
Object ID:
A string of characters that is used to identify the object that is being created. The string can contain letters, numbers and special characters as well.
Object ID-s have to be unique for every object across all object types (eg.: sections, members, plates, loads, etc.).
Object type:
The type of object to be created.
Available object types:| Object type name | Object type |
|---|---|
| Structural members tab | - |
| Structural member | Structural_Member |
| Structural Plate | Structural_Plate |
| Haunch | Haunched_Member |
| Tapered member | Tapered_Member |
| Point support | Support_Point |
| Line support | Support_Edge |
| Link | Link |
| Loads tab | - |
| Load group | LoadGroup |
| Load case | LoadCase |
| Load combination | LoadCombination |
| Point load | NodeForce |
| Line load | MemberForce |
| Surface load (uniform) | PlateForce_Uniform |
| Surface load (linear) | PlateForce_Linear |
| Load transfer surface | LoadTransferSurface |
| Mass tab | - |
| Mass group | MassGroup |
| Mass case | MassCase |
| Mass combination | MassCombination |
| Point mass | NodeMass |
| Other | - |
| Portion | Portion |
Object parameters:
The available object parameters and their meaning depends on the chosen object type. Detailed description of all object parameters for each individual object type can be found below.
Detailed description of object types
Structural member
This command is analogous with the beam creation dialogue in Consteel:
Syntax
CREATE [Object ID] Structural_Member [Section name]
[x1] [y1] [z1]
[x2] [y2] [z2]
Name [Object name]
ReleaseID_A [Release start]
ReleaseID_B [Release end]
Eccentricity_y [Eccentricity y]
Eccentricity_z [Eccentricity z]
Rotation [Rotation]
Geomimpv [Initial bow imperfection L/y]
Geomimpw [Initial bow imperfection L/z]
Fe_type [FE type]
Convergencetype [FE generation type]
Convergence [Number of FEs]
AverageEdgeLength_Web [FE size web]
AverageEdgeLength_flange [FE size flange]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Section name | Required | String | Local, variable |
| x1, y1, z1 | Required | Integer | Local, variable |
| x2, y2, z2 | Required | Integer | Local, variable |
| Object name | Optional | String | Local, variable |
| Release start | Optional | String | Local, variable |
| Release end | Optional | String | Local, variable |
| Eccentricity y | Optional | Integer | Local, variable |
| Eccentricity z | Optional | Integer | Local, variable |
| Rotation | Optional | Numerical | Local, variable |
| Initial bow imperfection L/y | Optional | Numerical | Local, variable |
| Initial bow imperfection L/z | Optional | Numerical | Local, variable |
| FE type | Optional | Predefined strings | Local, variable |
| FE generation type | Optional | Predefined strings | Local, variable |
| Number of FEs | Optional | Integer | Local, variable |
| FE size web | Optional | Numerical | Local, variable |
| FE size flange | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Section name:
Name of the section to be used for the member.
x1, y1, z1:
Coordinates of the starting point of the structural member.
x2, y2, z2:
Coordinates of the end point of the structural member.
Object name:
Name of the structural member.
Release start:
Release type at the starting point of the structural member. Any previously created release type name can be used.
Consteel has these release types already created by default:
- Continuous (default)
- w
- xx,yy,zz,w
- yy
- yy,zz
- yy,zz,w
- zz
Release end:
Release type at the end point of the structural member. Any previously created release type name can be used. The premade and default parameter inputs are the same as in case of the Release start parameter.
Eccentricity y:
Structural member eccentricity in the local y direction.
Eccentricity z:
Structural member eccentricity in the local z direction.
Rotation:
Axial rotation of the structural member.
Initial bow imperfection L/y:
Initial bow imperfection of the member in the local y direction.
Initial bow imperfection L/z:
Initial bow imperfection of the member in the local z direction.
FE type:
Finite element type.
Available finite element types:| Finite element type name | Finite element type |
|---|---|
| 6 Degree Of Freedom beam | 6DOFelem |
| 7 Degree Of Freedom beam | 7DOFelem |
| Tension bar | TensionBar |
| Shell | Shell |
| Tension bar (X Brace) | XBrace |
FE generation type:
Finite element generation type.
Available inputs:- Automatic
- Manual
Number of FEs:
Number of finite elements. This parameter only applies if the FE type is "6DOFelem" or "7DOFelem".
FE size web:
Maximum edge size of shell element in the web. This parameter only applies if the FE type is "Shell".
FE size flange:
Maximum edge size of shell element in the web. This parameter only applies if the FE type is "Shell".
Sample code
Command only: (minimal parameters)
CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 1000
With section creation and all parameters:
LOAD_SECTION_LIBRARY section "HEA 200"
CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 1000
Name "Member 1"
ReleaseID_A Continuous
ReleaseID_B Continuous
Eccentricity_y 0
Eccentricity_z 0
Rotation 0
Geomimpv 0
Geomimpw 0
Fe_type 7dofelem
Convergencetype manual
Convergence 10
AverageEdgeLength_Web 10
AverageEdgeLength_flange 20
Structural plate
This command is analogous with the plate creation dialogue in Consteel, with the "draw polygon" option selected:
Syntax
CREATE [Object ID] Structural_Plate [Material name] [Plate thickness] [FE size]
Name [Object name]
Group [Group ID]
[x1] [y1] [z1]
[x2] [y2] [z2]
[x3] [y3] [z3]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Material name | Required | String | Local, variable |
| Plate thickness | Required | Numerical | Local, variable |
| FE size | Optional | Numerical | Local, variable |
| Object name | Optional | String | Local, variable |
| Group ID | Optional | String | Local, variable |
| x1, y1, z1 | Required | Integer | Local, variable |
| x2, y2, z2 | Required | Integer | Local, variable |
| x3, y3, z3 | Required | Integer | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Material name:
Name of the material to be used.
Plate thickness:
Thickness of the plate in [mm].
FE size:
Maximum edge size of shell elements in [mm].
Object name:
Name of the structural plate.
Group ID:
ID of the element group.
x1, y1, z1:
Coordinates of 1. point of the structural plate.
x2, y2, z2:
Coordinates of 2. point of the structural plate.
x3, y3, z3:
Coordinates of 3. point of the structural plate. At least 3 points have to be defined for a plate creation. More point coordinates can be added into subsequent rows, for a polygon shape defined by more than 3 points.
Sample code
Minimal parameters and 3 points:
CREATE Plate_ID1 Structural_Plate "C25/30 EN 1992-1-1:2010" 200
0 0 0
3000 0 0
3000 3000 0
All parameters and 4 points:
CREATE Plate_ID1 Structural_Plate "C25/30 EN 1992-1-1:2010" 200 400
Name "Plate 1"
Group Group_ID1
0 0 0
3000 0 0
3000 3000 0
0 3000 0
Haunch
This command is analogous with the haunch creation dialogue in Consteel:
Hot rolled or welded haunch
Syntax
Hot rolled haunch:
CREATE [Object ID] Haunched_Member [Member ID] [Format] [L] [hs] [he] [Section name]
[x1] [y1] [z1]
[x2] [y2] [z2]
Welded haunch:
CREATE [Object ID] Haunched_Member [Member ID] [Format] [L] [hs] [he] [tw] [b] [tf]
[x1] [y1] [z1]
[x2] [y2] [z2]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Member ID | Required | String | Local, variable |
| Format | Required | Predefined strings | Local, variable |
| L | Required | Numerical | Local, variable |
| hs | Required | Numerical | Local, variable |
| he | Required | Numerical | Local, variable |
| Section name | Required | String | Local, variable |
| tw | Required | Numerical | Local, variable |
| b | Required | Numerical | Local, variable |
| tf | Required | Numerical | Local, variable |
| x1, y1, z1 | Required | Integer | Local, variable |
| x2, y2, z2 | Required | Integer | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Member ID:
ID of the previously created structural member on which the haunch should be placed.
Format:
Alignment of the haunch.
Available input options:- Lower
- Symmetric
- Upper
L:
Length of the haunch.
hs:
Start height of the haunch.
he:
End height of the haunch.
Section name:
Name of the section to be used for the haunch. Only applicable if the haunch type is hot rolled.
tw:
Web thickness of the haunch. Only applicable if the haunch type is welded.
b:
Flange width of the haunch. Only applicable if the haunch type is welded.
tf:
Flange thickness of the haunch. Only applicable if the haunch type is welded.
x1, y1, z1:
Coordinates of the starting point of the haunch.
x2, y2, z2:
Coordinates for setting the direction of the haunch.
Sample code
Command only:
Hot rolled haunch:
CREATE Hau_ID1 Haunched_Member Mem_ID1 lower 2000 600 50 "IPE 300"
0 0 0
1 0 0
Welded haunch:
CREATE Hau_ID2 Haunched_Member Mem_ID2 lower 2000 600 50 6 150 10
0 2000 0
1 2000 0
With section and member creation:
Hot rolled haunch:
LOAD_SECTION_LIBRARY Sec_ID1 "IPE 300"
CREATE Mem_ID1 Structural_Member "IPE 300"
0 0 0
5000 0 0
CREATE Hau_ID1 Haunched_Member Mem_ID1 lower 2000 600 50 "IPE 300"
0 0 0
1 0 0
Welded haunch:
LOAD_SECTION_MACRO Sec_ID2 WLD-IH "WLD-IH (Descript)" "S 235 EN 10025-2" 150 10 300 8 150 10
CREATE Mem_ID2 Structural_Member "WLD-IH (Descript)"
0 2000 0
5000 2000 0
CREATE Hau_ID2 Haunched_Member Mem_ID2 lower 2000 600 50 6 150 10
0 2000 0
1 2000 0
Tapered member
This command is analogous with the tapered member creation dialogue in Consteel:
Syntax
CREATE [Object ID] Tapered_Member [Member ID] [Start height] [End height]
Format [Format]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Member ID | Required | String | Local, variable |
| Start height | Required | Numerical | Local, variable |
| End height | Required | Numerical | Local, variable |
| Format | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Member ID:
ID of the previously created structural member on which the tapering should be placed.
Starting height:
Starting height of the tapered member in [mm].
End height:
End height of the tapered member in [mm].
Format:
Alignment of the axis of the tapered member.
Available input options:- Bottom (default)
- Centric
- Top
Sample code
Command only: (minimal parameters)
CREATE Tapered_ID1 Tapered_Member MemID0 400 200
With added prerequisites (section and member definition) and all parameters:
LOAD_SECTION_MACRO Sec_ID1 WLD-IH Descript_Section "S 235 EN 10025-2" 100 10 200 6 100 10
CREATE Mem_ID1 Structural_Member Descript_Section
0 0 0
0 0 1000
CREATE Tapered_ID1 Tapered_Member Mem_ID1 400 200
Format Centric
Point support
This command is analogous with the point support creation dialogue in Consteel:
Syntax
CREATE [Object ID] Support_Point [Member ID] [Support type]
[x] [y] [z]
EccType [Eccentricity reference]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Member ID | Required | Member name or ID | Local, variable |
| Support type | Required | String | Local, variable |
| x, y, z | Required | Numerical | Local, variable |
| Eccentricity reference | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Member ID:
ID of the previously created structural member to which the support will be attached. The accepted input is either a member ID or the name of the member with this syntax: "NAME: [Member name]"
Support type:
The type of support. Any previously created support type name can be used.
Consteel has these support types already created by default:- Fixed
- x,y,z
- x,y,z,xx
- x,y,z,yy
- x,y,z,zz
- y,z,xx
- x,z,yy
- x,y,zz
- y,z
- x,z
- x,y
- x
- y
- z
- w
x, y, z:
Coordinates of the point support.
Eccentricity reference:
Available inputs:
| Eccentricity reference name | Eccentricity reference |
|---|---|
| Reference line (0) | EccType_C |
| Bottom Left (1) | EccType_BL |
| Bottom Middle (2) | EccType_BM |
| Bottom Right (3) | EccType_BR |
| Middle Left (4) | EccType_ML |
| Middle Middle (5) | EccType_MM |
| Middle Right (6) | EccType_MR |
| Top Left (7) | EccType_TL |
| Top Middle (8) | EccType_TM |
| Top Right (9) | EccType_TR |
Sample code
Command only: (minimal parameters)
CREATE PSup_ID1 Support_Point Member_ID1 x,y,z
0 0 0
With added prerequisites (section and member definition) and all parameters:
LOAD_SECTION_MACRO Sec_ID1 WLD-IH "Descript Section" "S 235 EN 10025-2" 100 10 200 6 100 10
CREATE Member_ID1 Structural_member "Descript Section"
0 0 0
0 0 3000
CREATE PSup_ID1 Support_Point Member_ID1 Fixed
0 0 0
EccType EccType_TM
Line support
This command is analogous with the line support creation dialogue in Consteel:
Syntax
CREATE [Object ID] Support_Edge [Member ID] [Support type]
Name [Object name]
CoordSys [Coordinate system]
EccType [Eccentricity reference]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Member ID | Required | Member name or ID | Local, variable |
| Support type | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Coordinate system | Optional | Predefined strings | Local, variable |
| Eccentricity reference | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Member ID:
ID of the previously created structural member to which the support will be attached. The accepted input is either a member ID or the name of the member with this syntax: "NAME: [Member name]"
Support type:
The type of support. Any previously created support type name can be used.
Consteel has these support types already created by default:
- Fixed
- Pinned
- y,xx
Object name:
Name of the line support.
Coordinate system:
With this parameter it can be specified which coordinate system to use for the load definition.
Available inputs:- Global (default)
- Local
Eccentricity reference:
Available inputs:| Eccentricity reference name | Eccentricity reference |
|---|---|
| Reference line (0) | EccType_C |
| Bottom Left (1) | EccType_BL |
| Bottom Middle (2) | EccType_BM |
| Bottom Right (3) | EccType_BR |
| Middle Left (4) | EccType_ML |
| Middle Middle (5) | EccType_MM |
| Middle Right (6) | EccType_MR |
| Top Left (7) | EccType_TL |
| Top Middle (8) | EccType_TM |
| Top Right (9) | EccType_TR |
Sample code
Command only: (minimal parameters)
CREATE LSup_ID1 Support_Edge Member_ID1 Fixed
With added prerequisites (section and member definition) and all parameters:
LOAD_SECTION_MACRO Sec_ID1 WLD-IH "WLD-IH (Descript)" "S 235 EN 10025-2" 100 10 200 6 100 10
CREATE Member_ID1 Structural_member "WLD-IH (Descript)"
0 0 0
0 0 3000
CREATE LSup_ID1 Support_Edge Member_ID1 Fixed
Name "Line support 1 (Descript)"
CoordSys Local
EccType EccType_TM
Link
This command is analogous with the link element creation dialogue in Consteel:
Syntax
CREATE [Object ID] Link
[x1] [y1] [z1]
[x2] [y2] [z2]
Rotation [Rotation]
InterfacePos [Interface position]
ReleaseID [Release]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| x1, y1, z1 | Required | Numerical | Local, variable |
| x2, y2, z2 | Required | Numerical | Local, variable |
| Rotation | Optional | Numerical | Local, variable |
| Interface position | Optional | Numerical | Local, variable |
| Release | Optional | String | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
x1, y1, z1:
Coordinates of 1. point of the link.
x2, y2, z2:
Coordinates of 2. point of the link.
Rotation:
Axial rotation of the local coordinate system of the link in degrees. Default: 0.
Interface position:
The position of the interface, or release along the length of the link. Acceptable inputs are decimal fraction numbers from 0 to 1. Default: 0.
Release:
The type of release at the interface position. Any previously created release type name can be used.
Consteel has these release types already created by default:
- Continuous (default)
- w
- xx,yy,zz,w
- yy
- yy,zz
- yy,zz,w
- zz
Sample code
Command only: (minimal parameters)
Create Link_ID1 Link
1000 0 0
1000 0 600
With added prerequisites (section and member definition) and all parameters:
LOAD_SECTION_MACRO Sec_ID1 WLD-IH "Descript Section" "S 235 EN 10025-2" 100 10 200 6 100 10
CREATE Member_ID1 Structural_member "Descript Section"
1000 0 0
5000 0 0
CREATE Member_ID2 Structural_member "Descript Section"
1000 0 600
5000 0 600
CREATE Link_ID1 Link
1000 0 0
1000 0 600
Rotation 20
InterfacePos 0.5
ReleaseID yy
Load group
This command is analogous with the load group creation button in Consteel:
Syntax
CREATE [Object ID] LoadGroup
Name [Object name]
LoadGroupType [Load group type]
Factor_0 [Factor 0]
Factor_1 [Factor 1]
Factor_2 [Factor 2]
Factor_3 [Factor 3]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Required | String | Local, variable |
| Load group type | Required | Predefined strings | Local, variable |
| Factors 0-3 | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the load group.
Load group type:
Type of the load group.
Available load group types:| Load group type name | Load group type |
|---|---|
| EN standard | - |
| EN, Permanent | LGType_EN_P |
| EN, Variable (Transient) | LGType_EN_T |
| EN, Meteorological | LGType_EN_M |
| EN, Wind | LGType_EN_W |
| EN, Snow | LGType_EN_S |
| EN, Crane | LGType_EN_C |
| EN, Accidental | LGType_EN_A |
| EN, Accidental snow | LGType_EN_AS |
| EN, Seismic (Earthquake) | LGType_EN_E |
| AISC standard | - |
| AISC, Dead load | LGType_AISC_D |
| AISC, Fluid load | LGType_AISC_F |
| AISC, Live load | LGType_AISC_L |
| AISC, Roof live load | LGType_AISC_Lr |
| AISC, Rain load | LGType_AISC_R |
| AISC, Snow load | LGType_AISC_S |
| AISC, Weight of ice | LGType_AISC_DI |
| AISC, Wind load | LGType_AISC_W |
| AISC, Wind on ice | LGType_AISC_Wi |
| AISC,Wind load for SLS | LGType_AISC_Wa |
| AISC, Flood load | LGType_AISC_Fa |
| AISC, Load from extraordinary event | LGType_AISC_Ak |
Factors 0-3:
Safety and combination factors attached to the load group.
- Factor 0: safety factor (γG or γQ)
- Factor 1: combination factor (Ψ0)
- Factor 2: factor for frequent load level (Ψ1)
- Factor 3: factor for quasi permanent load level (Ψ2)
Sample code
EN Permanent load group: (minimal parameters)
CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P
EN Variable load group: (all parameters)
CREATE LG_ID1 LoadGroup
Name "Variable (Descript)"
LoadGroupType LGType_EN_T
Factor_0 1.35
Factor_1 1
Factor_2 0.9
Factor_3 0
Load case
This command is analogous with the load case creation button in Consteel:
Syntax
CREATE [Object ID] LoadCase
Name [Object name]
LoadGroupID [Load group ID]
CanBeFavourable [Can be favourable]
NotMainInTransientCmb [Not main in variable combination]
NotMainInAccidentalCmb [Not main in accidental combination]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Load group ID | Optional | String | Local, variable |
| Can be favourable | Optional | Boolean | Local, variable |
| Not main in variable combination | Optional | Boolean | Local, variable |
| Not main in accidental combination | Optional | Boolean | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the load case. If not specified, the default name is: LoadCase.
Load group ID:
ID of the load group that will contain the created load case. If not specified, then the load case will be created within the default permanent load group.
Can be favourable:
Boolean parameter that controls if the load case can be favourable in a combination or not. Accepted inputs: "0" or "1". If not specified the default value is "1".
- 0 → turned off, load can not be favorable
- 1 → turned on, load can be favorable
Not main in variable combination:
Boolean parameter that controls if the load case can be main in permanent and variable combinations or not. Accepted inputs: "0" or "1". If not specified the default value is "0".
- 0 → turned off, load can not be main
- 1 → turned on, load can be main
Not main in accidental combination:
Boolean parameter that controls if the load case can be main in accidental combinations or not. Accepted inputs: "0" or "1". If not specified the default value is "0".
- 0 → turned off, load can not be main
- 1 → turned on, load can be main
Sample code
Command only: (minimal parameters)
CREATE LCaseID01 LoadCase
With load group creation and all parameters:
CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P
CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1
CanBeFavourable 0
NotMainInTransientCmb 0
NotMainInAccidentalCmb 0
Load combination
This command is analogous with the load combination creation button in Consteel:
Syntax
CREATE [Object ID] LoadCombination
Name [Object name]
Type [Combination type]
[Load case ID 1] [Load case combination factor 1]
[Load case ID 2] [Load case combination factor 2]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Combination type | Optional | Predefined strings | Local, variable |
| Load case IDs | Optional | Load case name or ID | Local, variable |
| Load case combination factors | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the load combination. If not specified, the default name is: Load combination1.
Combination type:
Type of the combination.
Available combination types:- ULS (default)
- SLS
Load case IDs:
ID of load cases for which combination factors will be specified. The accepted input is either a load case ID or the name of a load case with this syntax: "NAME: [Load case name]"
Load case combination factors:
Combination factors assigned to load cases in the same row.
Sample code
Command only: (minimal parameters)
CREATE LComb_ID1 LoadCombination
"NAME: Loadcase" 1
With getting load case ID and all parameters:
FILTER LCase_IDs
Objecttypes Loadcase
ARRAY_GET LCase_IDs 0 LCase_ID1
CREATE LComb_ID1 LoadCombination
Name "Load combination (Descript)"
Type ULS
$LCase_ID1 1
Point load
This command is analogous with the point load creation dialogue in Consteel:
Syntax
CREATE [Object ID] NodeForce [Load case ID] [Member ID] [Coordinate system]
[x] [y] [z]
[Fx] [Fy] [Fz]
[Mx] [My] [Mz]
EccType [Eccentricity reference]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Load case ID | Required | Load case name or ID | Local, variable |
| Member ID | Required | Member name or ID | Local, variable |
| Coordinate system | Optional | Predefined string | Local, variable |
| x, y, z | Required | Numerical | Local, variable |
| Fx, Fy, Fz | Required | Numerical | Local, variable |
| Mx, My, Mz | Required | Numerical | Local, variable |
| Eccentricity reference | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Load case ID:
ID of the load case that will contain the load. The accepted input is either a load case ID or the name of a load case with this syntax: "NAME: [Load case name]"
Member ID:
ID of the member to which the load will be attached. The accepted input is either a member ID or the name of the member with this syntax: "NAME: [Member name]"
Coordinate system:
With this parameter it can be specified which coordinate system to use for the load definition. If unspecified the default is the global coordinate system. If specified, the only accepted input is: "local".
x, y, z:
Coordinates of the application point of the load.
Alternatively the location of the point load can be defined relatively along the length of the member it is attached to. For this definition use the following syntax replacing the x, y, z coordinates: "Rel ", where the Relative position parameter can be any number between 0 and 1. For example:
CREATE PLoad_ID1 NodeForce "NAME: Loadcase" Mem_ID1
Rel 0.6
0 100 -100
0 0 0
Fx, Fy, Fz:
Force components of the point load.
Mx, My, Mz:
Moment components of the point load.
Eccentricity reference:
Available inputs:| Eccentricity reference name | Eccentricity reference |
|---|---|
| Reference line (0) | EccType_C |
| Bottom Left (1) | EccType_BL |
| Bottom Middle (2) | EccType_BM |
| Bottom Right (3) | EccType_BR |
| Middle Left (4) | EccType_ML |
| Middle Middle (5) | EccType_MM |
| Middle Right (6) | EccType_MR |
| Top Left (7) | EccType_TL |
| Top Middle (8) | EccType_TM |
| Top Right (9) | EccType_TR |
Sample code
Command only: (minimal parameters)
CREATE PLoad_ID1 NodeForce "NAME: Loadcase" Mem_ID1
0 0 3000
0 100 -100
0 0 0
With section, load group, load case, member creation and all parameters:
Note that in this example the load is given in the member's local coordinate system.
LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"
CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P
CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1
CREATE Mem_ID1 Structural_member "HEA 200"
0 0 0
0 0 3000
CREATE PLoad_ID1 NodeForce LCase_ID1 Mem_ID1 local
0 0 3000
-100 0 0
0 0 0
EccType EccType_TM
Line load
This command is analogous with the line load creation dialogue in Consteel:
Syntax
CREATE [Object ID] MemberForce [Load case ID] [Member ID] [Coordinate system]
[Reference point 1] [Reference point 2]
[Distance 1] [Distance 2]
[Fx1] [Fy1] [Fz1]
[Fx2] [Fy2] [Fz2]
EccType [Eccentricity reference]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Load case ID | Required | Load case name or ID | Local, variable |
| Member ID | Required | Member name or ID | Local, variable |
| Coordinate system | Optional | Predefined string | Local, variable |
| Reference point 1 | Required | Numerical | Local, variable |
| Reference point 2 | Required | Numerical | Local, variable |
| Distance 1 | Required | Numerical | Local, variable |
| Distance 2 | Required | Numerical | Local, variable |
| Fx1, Fy1, Fz1 | Required | Numerical | Local, variable |
| Fx2, Fy2, Fz2 | Required | Numerical | Local, variable |
| Eccentricity reference | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Load case ID:
ID of the load case that will contain the load. The accepted input is either a load case ID or the name of a load case with this syntax: "NAME: [Load case name]"
Member ID:
ID of the member to which the load will be attached. The accepted input is either a member ID or the name of the member with this syntax: "NAME: [Member name]"
Coordinate system:
With this parameter it can be specified which coordinate system to use for the load definition. If unspecified the default is the global coordinate system. If specified, the only accepted input is: "local".
Reference point 1:
Parameter that controls the starting location of the line load.
Available inputs:
- 0 → from end A
- 1 → from end B
Reference point 2:
Parameter that controls the end location of the line load.
Available inputs:
- 0 → from end A
- 1 → from end B
- 2 → Relative
Distance 1:
Distance of the start of the line load from the member end set by the Reference point 1 parameter.
Distance 2:
Distance of the end of the line load from the member end set by the Reference point 2 parameter. If Reference point 2 = 2 (Relative), then the length of the line load is measured from the starting point.
Fx1, Fy1, Fz1:
Force components at the starting point of the line load.
Fx2, Fy2, Fz2:
Force components at the end point of the line load.
Eccentricity reference:
Available inputs:| Eccentricity reference name | Eccentricity reference |
|---|---|
| Reference line (0) | EccType_C |
| Bottom Left (1) | EccType_BL |
| Bottom Middle (2) | EccType_BM |
| Bottom Right (3) | EccType_BR |
| Middle Left (4) | EccType_ML |
| Middle Middle (5) | EccType_MM |
| Middle Right (6) | EccType_MR |
| Top Left (7) | EccType_TL |
| Top Middle (8) | EccType_TM |
| Top Right (9) | EccType_TR |
Sample code
Command only: (minimal parameters)
CREATE LLoad_ID1 MemberForce LCase_ID1 Mem_ID1
0 1
0 0
0 0 -10
0 0 -10
With section, load group, load case, member creation and all parameters:
LOAD_SECTION_LIBRARY Sec_ID1 "IPE 200"
CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P
CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1
CREATE Mem_ID1 Structural_member "IPE 200"
0 0 0
3000 0 0
CREATE LLoad_ID1 MemberForce LCase_ID1 Mem_ID1 local
0 1
200 400
0 0 -10
0 0 -12
EccType EccType_TM
Surface load (uniform)
This command is analogous with the surface load creation dialogue with the uniform tab chosen in Consteel:
Syntax
CREATE PlateForce_Uniform [Load case ID] [Surface ID] [Coordinate system]
[Fx] [Fy] [Fz]
[x1] [y1] [z1]
[x2] [y2] [z2]
[x3] [y3] [z3]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Load case ID | Required | Load case name or ID | Local, variable |
| Surface ID | Required | Member name or ID | Local, variable |
| Coordinate system | Optional | Predefined string | Local, variable |
| Fx, Fy, Fz | Required | Numerical | Local, variable |
| xi, yi, zi | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Load case ID:
ID of the load case that will contain the load. The accepted input is either a load case ID or the name of a load case with this syntax: "NAME: [Load case name]"
Surface ID:
ID of the Surface to which the load will be attached. The accepted input is either a surface ID or the name of the surface with this syntax: "NAME: [Surface name]"
Coordinate system:
With this parameter it can be specified which coordinate system to use for the load definition. If unspecified the default is the global coordinate system. If specified, the only accepted input is: "local".
Fx, Fy, Fz:
Force components of the uniform surface load.
xi, yi, zi:
Coordinates of the corner points of the area where the surface load will be applied on the selected surface. If none is given, then the load will be applied on the entire surface. Otherwise at least 3 corner points have to be given.
Sample code
Command only: (minimal parameters)
CREATE SLoad_ID1 PlateForce_Uniform LCase_ID1 PlateID1
0 0 -10
With load group, load case, plate creation and all parameters:
CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P
CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1
CREATE Plate_ID1 Structural_Plate "C25/30 EN 1992-1-1:2010" 200
0 0 0
3000 0 0
3000 3000 0
0 3000 0
CREATE SLoad_ID1 PlateForce_Uniform LCase_ID1 Plate_ID1 local
0 0 -10
0 0 0
2000 0 0
2000 3000 0
0 3000 0
Surface load (linear)
This command is analogous with the surface load creation dialogue with the linear tab chosen in Consteel:
Syntax
CREATE [Object ID] PlateForce_Linear [Load case ID] [Surface ID] [Coordinate system]
LoadDirection [Load direction]
DistributionType [Distribution type]
[q1x] [q1y] [q1z] [q1]
[q2x] [q2y] [q2z] [q2]
[q3x] [q3y] [q3z] [q3]
[x1] [y1] [z1]
[x2] [y2] [z2]
[x3] [y3] [z3]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Load case ID | Required | Load case name or ID | Local, variable |
| Surface ID | Required | Member name or ID | Local, variable |
| Coordinate system | Optional | Predefined string | Local, variable |
| Load direction | Required | Predefined strings | Local, variable |
| Distribution type | Required | Predefined strings | Local, variable |
| qix, qiy, qiz | Required | Numerical | Local, variable |
| q1, q2, q3 | Required | Numerical | Local, variable |
| xi, yi, zi | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Load case ID:
ID of the load case that will contain the load. The accepted input is either a load case ID or the name of a load case with this syntax: "NAME: [Load case name]"
Surface ID:
ID of the Surface to which the load will be attached. The accepted input is either a surface ID or the name of the surface with this syntax: "NAME: [Surface name]"
Coordinate system:
With this parameter it can be specified which coordinate system to use for the load definition. If unspecified the default is the global coordinate system. If specified, the only accepted input is: "local".
Load direction:
Direction of the surface load. Only 1 load direction can be chosen for 1 CREATE PlateForce_Linear command. The load direction is defined in the given coordinate system (local or global).
Available load directions:- x
- y
- z
Distribution type:
Type of the load distribution.
Available distribution types:- General → In this case the slope of the linear distribution is in a general direction, therefore 3 intensity points have to be defined (q1, q2, q3)
- x → In this case the slope of the linear distribution is parallel with the local x direction, therefore 2 intensity points have to be defined (q1, q2)
- y → In this case the slope of the linear distribution is parallel with the local y direction, therefore 2 intensity points have to be defined (q1, q2)
qix, qiy, qiz:
Coordinates for the load intensity points.
q1, q2, q3:
Load intensities at the given points.
xi, yi, zi:
Coordinates of the corner points of the area where the surface load will be applied on the selected surface. If none is given, then the load will be applied on the entire surface. Otherwise at least 3 corner points have to be given.
Sample code
Command only: (minimal parameters, general distribution)
CREATE PF_ID1 PlateForce_Linear LC01 SPID1
LoadDirection z
DistributionType General
3000 0 0 0
3000 3000 0 -10
0 3000 0 -20
With load group, load case, plate creation and all parameters:
CREATE SP_ID1 Structural_Plate "S 235 EN 10025-2" 16 50
0 0 0
3000 0 0
3000 3000 0
0 3000 0
CREATE LG_01 LoadGroup
Name "Descript Load Group"
LoadGroupType "LGType_EN_P"
CREATE LC_01 LoadCase
Name "Descript Load Case"
LoadGroupID LG_01
CREATE PF_ID1 PlateForce_Linear LC_01 SP_ID1 local
LoadDirection z
DistributionType x
0 0 0 -20
3000 0 0 -10
0 0 0
3000 0 0
2000 3000 0
0 3000 0
Load transfer surface
This command is analogous with the load transfer surface creation dialogue in Consteel, with the "draw polygon" option:
Syntax
CREATE [Object ID] LoadTransferSurface [Object name]
[x1] [y1] [z1]
[x2] [y2] [z2]
[x3] [y3] [z3]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Required | String | Local, variable |
| xi, yi, zi | Required | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the load transfer surface.
xi, yi, zi:
Coordinates of the corner points of the area where the load transfer surface will be. At least 3 corner points have to be given.
Sample code
CREATE LTS_ID1 LoadTransferSurface "LTS 1"
0 0 0
3000 0 0
3000 3000 0
0 3000 0
Mass group
This command is analogous with the mass group creation button in Consteel:
Syntax
CREATE [Object ID] MassGroup
Name [Object name]
MassGroupType [Mass group type]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Mass group type | Required | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the mass group.
Mass group type:
Type of the mass group.
Available mass group types:| Mass group type name | Mass group type |
|---|---|
| Permanent | MGType_EN_P |
| Variable | MGType_EN_T |
| Snow | MGType_EN_S |
Sample code
CREATE MG_ID1 MassGroup
Name "Mass group (Descript)"
MassGroupType MGType_EN_P
Mass case
This command is analogous with the mass case creation button in Consteel:
Syntax
CREATE [Object ID] MassCase
Name [Object name]
MassGroupID [Mass group ID]
SeismicDirection [Seismic direction]
FreeVibrationDirection [Free vibration direction]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Mass group ID | Required | Mass group name or ID | Local, variable |
| Seismic direction | Optional | Predefined strings | Local, variable |
| Free vibration direction | Optional | Predefined strings | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the mass case. If not specified the default name is: "MassCase".
Mass group ID:
ID of the mass group that will contain the created mass case. The accepted input is either a mass group ID or the name of a mass group with this syntax: "NAME: [Mass group name]"
Seismic direction:
Controls the consideration of "z" direction in seismic analysis.
Available inputs:- 0 (default)
- z
Free vibration direction:
Controls the consideration of masses in directions for free vibration analysis.
Available inputs:- x
- y
- z
- x,y
- x,z
- y,z
- x,y,z (default)
Sample code
Command only: (minimal parameters)
CREATE MC_ID1 MassCase
MassGroupID MG_ID1
With mass group creation and all parameters:
CREATE MG_ID1 MassGroup
Name "Mass group (Descript)"
MassGroupType MGType_EN_P
CREATE MC_ID1 MassCase
Name "Mass case (Descript)"
MassGroupID MG_ID1
SeismicDirection 0
FreeVibrationDirection x,y,z
Mass combination
This command is analogous with the mass combination creation button in Consteel:
Syntax
CREATE [Object ID] MassCombination
Name [Object name]
[Mass case ID 1] [Mass case combination factor 1]
[Mass case ID 2] [Mass case combination factor 2]
etc.
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Optional | String | Local, variable |
| Mass case IDs | Optional | Mass case name or ID | Local, variable |
| Mass case combination factors | Optional | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the mass combination. If not specified, the default name is: Load combination1.
Mass case IDs:
ID of mass cases for which combination factors will be specified. The accepted input is either a mass case ID or the name of a mass case with this syntax: "NAME: [Mass case name]"
Mass case combination factors:
Combination factors assigned to mass cases in the same row.
Sample code
Command only: (minimal parameters)
CREATE MComb_ID1 MassCombination
"NAME: Mass case" 1
With mass group, mass case creation and all parameters:
CREATE MG_ID1 MassGroup
Name "Mass group (Descript)"
MassGroupType MGType_EN_P
CREATE MC_ID1 MassCase
MassGroupID MG_ID1
CREATE MComb_ID1 MassCombination
Name "Mass combination (Descript)"
MC_ID1 1
Point mass
This command is analogous with the node mass creation dialogue in Consteel:
Syntax
CREATE [Object ID] NodeMass [Mass case ID] [Member ID]
[x] [y] [z]
[Mass]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Mass case ID | Required | Mass case name or ID | Local, variable |
| Member ID | Required | Member name or ID | Local, variable |
| x, y, z | Required | Numerical | Local, variable |
| Mass | Required | Numerical | Local, variable |
Object ID:
A string of characters that is used to identify the object that is being created.
Mass case ID:
ID of the mass case that will contain the mass. The accepted input is either a mass case ID or the name of a mass case with this syntax: "NAME: [Mass case name]"
Member ID:
ID of the member to which the load will be attached. The accepted input is either a member ID or the name of the member with this syntax: "NAME: [Member name]"
x, y, z:
Coordinates of the application point of the mass.
Mass:
Mass in [kg].
Sample code
Command only: (minimal parameters)
CREATE PMass_ID1 NodeMass MC_ID1 Mem_ID1
0 0 3000
1000
With mass group, mass case, member creation and all parameters:
LOAD_SECTION_LIBRARY section "HEA 200"
CREATE MG_ID1 MassGroup
Name "Mass group (Descript)"
MassGroupType MGType_EN_P
CREATE MC_ID1 MassCase
Name "Mass case (Descript)"
MassGroupID MG_ID1
SeismicDirection 0
FreeVibrationDirection x,y,z
CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 3000
CREATE PMass_ID1 NodeMass MC_ID1 Mem_ID1
0 0 3000
1000
Portion
This command is analogous with the portion creation button in Consteel:
Syntax
CREATE [Object ID] Portion [Object name] [Content array]
Command parameters
| Command parameter | Assignment | Value format | Input options |
|---|---|---|---|
| Object ID | Required | String | Local, variable |
| Object name | Required | String | Local, variable |
| Content array | Required | Object ID(s) | Array |
Object ID:
A string of characters that is used to identify the object that is being created.
Object name:
Name of the portion.
Content array:
The name of the array that contains the IDs of the objects that will be part of the created portion. This array substitutes the manual object selection that is necessary before the portion creation in Consteel. The object IDs have to be collected and put into an array before the execution of this command.
Sample code
Command only:
CREATE Portion_ID1 portion "Portion 1 (Descript)" ObjIDs_to_portion
With object and array creation:
LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"
CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 1000
Name "Structural Member 1"
CREATE Mem_ID2 Structural_Member "HEA 200"
0 0 1000
0 1000 1000
Name "Structural Member 2"
CREATE Mem_ID3 Structural_Member "HEA 200"
0 0 1000
0 1000 0
Name "Structural Member 3"
ARRAY_CREATE ObjIDs_to_portion
ARRAY_SET ObjIDs_to_portion 0 Mem_ID1
ARRAY_SET ObjIDs_to_portion 1 Mem_ID2
CREATE Portion_ID1 portion "Portion 1 (Descript)" ObjIDs_to_portion