Ugrás a fő tartalomhoz
Verzió: 15

CREATE

Creates an object.

Syntax

CREATE [Object ID] [Object type]
Object parameters...

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object typeRequiredPredefined stringsLocal, variable
Object parametersRequired--

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 nameObject type
Structural members tab-
Structural memberStructural_Member
Structural PlateStructural_Plate
HaunchHaunched_Member
Tapered memberTapered_Member
Steel material (since CS 17)Steel
Coated steel material (since CS 17)Coated_Steel
Concrete material (since CS 17)Concrete
Rebar material (since CS 17)Rebar
Point supportSupport_Point
Line supportSupport_Edge
Surface support (since CS 17)Support_Plate
Point support type (since CS 17)Support
Release type (since CS 17)Release
LinkLink
Loads tab-
Load groupLoadGroup
Load caseLoadCase
Load combinationLoadCombination
Point loadNodeForce
Line loadMemberForce
Surface load (uniform)PlateForce_Uniform
Surface load (linear)PlateForce_Linear
Load transfer surfaceLoadTransferSurface
Mass tab-
Mass groupMassGroup
Mass caseMassCase
Mass combinationMassCombination
Point massNodeMass
Other-
PortionPortion

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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Section nameRequiredStringLocal, variable
x1, y1, z1RequiredIntegerLocal, variable
x2, y2, z2RequiredIntegerLocal, variable
Object nameOptionalStringLocal, variable
Release startOptionalStringLocal, variable
Release endOptionalStringLocal, variable
Eccentricity yOptionalIntegerLocal, variable
Eccentricity zOptionalIntegerLocal, variable
RotationOptionalNumericalLocal, variable
Initial bow imperfection L/yOptionalNumericalLocal, variable
Initial bow imperfection L/zOptionalNumericalLocal, variable
FE typeOptionalPredefined stringsLocal, variable
FE generation typeOptionalPredefined stringsLocal, variable
Number of FEsOptionalIntegerLocal, variable
FE size webOptionalNumericalLocal, variable
FE size flangeOptionalNumericalLocal, 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 nameFinite element type
6 Degree Of Freedom beam6DOFelem
7 Degree Of Freedom beam7DOFelem
Tension barTensionBar
ShellShell
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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Material nameRequiredStringLocal, variable
Plate thicknessRequiredNumericalLocal, variable
FE sizeOptionalNumericalLocal, variable
Object nameOptionalStringLocal, variable
Group IDOptionalStringLocal, variable
x1, y1, z1RequiredIntegerLocal, variable
x2, y2, z2RequiredIntegerLocal, variable
x3, y3, z3RequiredIntegerLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Member IDRequiredStringLocal, variable
FormatRequiredPredefined stringsLocal, variable
LRequiredNumericalLocal, variable
hsRequiredNumericalLocal, variable
heRequiredNumericalLocal, variable
Section nameRequiredStringLocal, variable
twRequiredNumericalLocal, variable
bRequiredNumericalLocal, variable
tfRequiredNumericalLocal, variable
x1, y1, z1RequiredIntegerLocal, variable
x2, y2, z2RequiredIntegerLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Member IDRequiredStringLocal, variable
Start heightRequiredNumericalLocal, variable
End heightRequiredNumericalLocal, variable
FormatOptionalPredefined stringsLocal, 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

Steel material

This command is analogous with the steel material creation dialogue in Consteel:

Syntax

CREATE [Object ID] Steel [Name] [ρ] [E] [ν] [α] [αfi] [fy1] [fy2] [fu1] [fu2] [ty] [tu]

Command parameters

Command parameterParameter descriptionAssignmentValue formatInput options
Object ID-RequiredStringLocal, variable
Name-RequiredStringLocal, variable
ρDensityRequiredNumericalLocal, variable
EElastic modulusRequiredNumericalLocal, variable
νPoisson factorRequiredNumericalLocal, variable
αThermal expansion coefficientRequiredNumericalLocal, variable
αfiThermal expansion coefficient in fireRequiredNumericalLocal, variable
fy1Yield strength 1RequiredNumericalLocal, variable
fy2Yield strength 2RequiredNumericalLocal, variable
fu1Ultimate strength 1RequiredNumericalLocal, variable
fu2Ultimate strength 2RequiredNumericalLocal, variable
tyThickness YRequiredNumericalLocal, variable
tuThickness URequiredNumericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the material.

Sample code

CREATE Steel_Mat_ID1 Steel "Custom steel name" 7850 210000 0.3 0.000012 0.000014 235 215 360 360 40 40

Coated steel material

This command is analogous with the coated steel material creation dialogue in Consteel:

Syntax

CREATE [Object ID] Coated_Steel [Name] [ρ] [E] [ν] [α] [αfi] [fyb] [fu] [tcoat]

Command parameters

Command parameterParameter descriptionAssignmentValue formatInput options
Object ID-RequiredStringLocal, variable
Name-RequiredStringLocal, variable
ρDensityRequiredNumericalLocal, variable
EElastic modulusRequiredNumericalLocal, variable
νPoisson factorRequiredNumericalLocal, variable
αThermal expansion coefficientRequiredNumericalLocal, variable
αfiThermal expansion coefficient in fireRequiredNumericalLocal, variable
fybBasic yield strengthRequiredNumericalLocal, variable
fuUltimate strengthRequiredNumericalLocal, variable
tcoatCoating thicknessRequiredNumericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the material.

Sample code

CREATE CSteel_Mat_ID1 Coated_Steel "Custom coated steel name" 7850 210000 0.3 0.000012 0.000014 350 420 0.02

Concrete material

This command is analogous with the concrete material creation dialogue in Consteel:

Syntax

CREATE [Object ID] Concrete [Name] [ρ] [Ecm] [fck] [fctk,0,05] [fctm] [φ(∞,t0)] [ν] [α] [εc1] [εcu1] [η] [εc2] [εcu2] [εc3] [εcu3] [n]

Command parameters

Command parameterParameter descriptionAssignmentValue formatInput options
Object ID-RequiredStringLocal, variable
Name-RequiredStringLocal, variable
ρDensityRequiredNumericalLocal, variable
EcmSecant modulus of elasticityRequiredNumericalLocal, variable
fckCompressive strengthRequiredNumericalLocal, variable
fctk,0,05Characteristic tensile strength
fctmMean tensile strength
φ(∞,t0)Final value of creep coefficient
νPoisson factorRequiredNumericalLocal, variable
αThermal expansion coefficientRequiredNumericalLocal, variable
Material model-RequiredNumericalLocal, variable
εc1Yield strain #1RequiredNumericalLocal, variable
εcu1Ultimite strain #1RequiredNumericalLocal, variable
ηCompression strength reduction factorRequiredNumericalLocal, variable
εc2Yield strain #2RequiredNumericalLocal, variable
εcu2Ultimite strain #2RequiredNumericalLocal, variable
εc3Yield strain #3RequiredNumericalLocal, variable
εcu3Ultimite strain #3RequiredNumericalLocal, variable
nExponentRequiredNumericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the material.

Material model:

Available material models:

  • DiagramRectangle
  • DiagramBilinear
  • DiagramParabolaRect

Sample code

CREATE Concrete_Mat_ID1 Concrete "Custom concrete name" 2500 31476 25 1.8 2.6 2.35 0.2 0.00001 DiagramRectangle 0.0007 0.0035 1 0.002 0.0035 0.00175 0.0035 2

Rebar material

This command is analogous with the reinforcement material creation dialogue in Consteel:

Syntax

CREATE [Object ID] Rebar [Name] [ρ] [E] [ν] [α] [fyk] [εuk]

Command parameters

Command parameterParameter descriptionAssignmentValue formatInput options
Object ID-RequiredStringLocal, variable
Name-RequiredStringLocal, variable
ρDensityRequiredNumericalLocal, variable
EElastic modulusRequiredNumericalLocal, variable
νPoisson factorRequiredNumericalLocal, variable
αThermal expansion coefficientRequiredNumericalLocal, variable
fykCharacteristic yield strengthRequiredNumericalLocal, variable
εukCharacteristic strain at maximum loadRequiredNumericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the material.

Sample code

CREATE Rebar_Mat_ID1 Rebar "Custom rebar name" 7850 200000 0.3 0.00001 500 0.05

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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Member IDRequiredMember name or IDLocal, variable
Support typeRequiredStringLocal, variable
x, y, zRequiredNumericalLocal, variable
Eccentricity referenceOptionalPredefined stringsLocal, 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 nameEccentricity 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Member IDRequiredMember name or IDLocal, variable
Support typeRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Coordinate systemOptionalPredefined stringsLocal, variable
Eccentricity referenceOptionalPredefined stringsLocal, 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 nameEccentricity 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

Surface support

This command is analogous with the surface support creation dialogue in Consteel:

Syntax

CREATE [Object ID] Support_Plate [Plate ID] [Support type]
Name [Object name] CoordSys [Coordinate system]

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Plate IDRequiredPlate name or IDLocal, variable
Support typeRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Coordinate systemOptionalPredefined stringsLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Plate ID:

ID of the previously created structural plate to which the support will be attached. The accepted input is either a plate ID or the name of the plate with this syntax: "NAME: [Plate name]"

Support type:

The type of support. Any previously created surface support type name can be used.

Object name:

Name of the surface support.

Coordinate system:

With this parameter it can be specified which coordinate system to use for the load definition.

Available inputs:
  • Global (default)
  • Local

Sample code

Command only: (minimal parameters)

CREATE SurfSup_ID1 Support_Plate Plate_ID1 Fixed

With added prerequisites (plate creation) and all parameters:

CREATE Plate_ID1 Structural_Plate "C25/30 EN 1992-1-1:2010" 200
0 0 0
3000 0 0
3000 3000 0

CREATE SurfSup_ID1 Support_Plate Plate_ID1 Fixed
Name "Surface support 1"
CoordSys Local

Point support type

This command is analogous with the point support type creation dialogue in Consteel:

Syntax

CREATE [Object ID] Support [Name] [x] [y] [z] [xx] [yy] [zz] [w]

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
NameRequiredStringLocal, variable
x, y, z, xx, yy, zz, wRequiredPredefined strings or numericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the object that will be created.

Degree of freedom (DOF) parameters: x, y, z, xx, yy, zz, w

DOF parameterParameter descriptionStiffness dimension
xTranslational degree of freedom in x directionkN/mm
yTranslational degree of freedom in y directionkN/mm
zTranslational degree of freedom in z directionkN/mm
xxRotational degree of freedom around x axiskNm/rad
yyRotational degree of freedom around y axiskNm/rad
zzRotational degree of freedom around z axiskNm/rad
wWarpingkNm2/(rad/m)

All DOF parameters work similarly. Each DOF can be fixed, free, or semi-rigid.

Available inputs:
  • Fix
  • Free
  • Numerical input (eg. 1.234)

If a numerical input is given then the corresponding DOF will be semi-rigid, and the given number will become the stiffness of that DOF. The dimension of the stiffness depends on which DOF it is applied to. The actual stiffness dimensions can be seen in the table above for every different DOF.

Sample code

CREATE PSup_Type_ID1 Support "Custom support type name" Fix Free 1.234 Fix Fix Fix Fix

Release type

This command is analogous with the release type creation dialogue in Consteel:

Syntax

CREATE [Object ID] Release [Name] [x] [y] [z] [xx] [yy] [zz] [w]

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
NameRequiredStringLocal, variable
x, y, z, xx, yy, zz, wRequiredPredefined strings or numericalLocal, variable

Object ID:

A string of characters that is used to identify the object that is being created.

Name:

Name of the object that will be created.

Degree of freedom (DOF) parameters: x, y, z, xx, yy, zz, w

DOF parameterParameter descriptionStiffness dimension
xTranslational degree of freedom in x directionkN/mm
yTranslational degree of freedom in y directionkN/mm
zTranslational degree of freedom in z directionkN/mm
xxRotational degree of freedom around x axiskNm/rad
yyRotational degree of freedom around y axiskNm/rad
zzRotational degree of freedom around z axiskNm/rad
wWarpingkNm2/(rad/m)

All DOF parameters work similarly. Each DOF can be fixed, free, or semi-rigid.

Available inputs:
  • Fix
  • Free
  • Numerical input (eg. 1.234)

If a numerical input is given then the corresponding DOF will be semi-rigid, and the given number will become the stiffness of that DOF. The dimension of the stiffness depends on which DOF it is applied to. The actual stiffness dimensions can be seen in the table above for every different DOF.

Sample code

CREATE Release_Type_ID1 Release "Custom release type name" Fix Free 1.234 Fix Fix Fix Fix

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]
FromObjectID [From object ID] (since CS 17)
ToObjectID [To object ID] (since CS 17)

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
x1, y1, z1RequiredNumericalLocal, variable
x2, y2, z2RequiredNumericalLocal, variable
RotationOptionalNumericalLocal, variable
Interface positionOptionalNumericalLocal, variable
ReleaseOptionalStringLocal, variable
From object IDOptionalObject IDLocal, variable
To object IDOptionalObject IDLocal, variable

A string of characters that is used to identify the object that is being created.

Coordinates of 1. point of the link.

Coordinates of 2. point of the link.

Axial rotation of the local coordinate system of the link in degrees. Default: 0.

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.

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

The ID of an object that the start point of the link is connecting to. This parameter accepts an ID of the following object types: structural member, structural plate.

The ID of an object that the end point of the link is connecting to. This parameter accepts an ID of the following object types: structural member, structural plate.

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
FromObjectID Member_ID1
ToObjectID Member_ID2

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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameRequiredStringLocal, variable
Load group typeRequiredPredefined stringsLocal, variable
Factors 0-3OptionalNumericalLocal, 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 nameLoad group type
EN standard-
EN, PermanentLGType_EN_P
EN, Variable (Transient)LGType_EN_T
EN, MeteorologicalLGType_EN_M
EN, WindLGType_EN_W
EN, SnowLGType_EN_S
EN, CraneLGType_EN_C
EN, AccidentalLGType_EN_A
EN, Accidental snowLGType_EN_AS
EN, Seismic (Earthquake)LGType_EN_E
AISC standard-
AISC, Dead loadLGType_AISC_D
AISC, Fluid loadLGType_AISC_F
AISC, Live loadLGType_AISC_L
AISC, Roof live loadLGType_AISC_Lr
AISC, Rain loadLGType_AISC_R
AISC, Snow loadLGType_AISC_S
AISC, Weight of iceLGType_AISC_DI
AISC, Wind loadLGType_AISC_W
AISC, Wind on iceLGType_AISC_Wi
AISC,Wind load for SLSLGType_AISC_Wa
AISC, Flood loadLGType_AISC_Fa
AISC, Load from extraordinary eventLGType_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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Load group IDOptionalStringLocal, variable
Can be favourableOptionalBooleanLocal, variable
Not main in variable combinationOptionalBooleanLocal, variable
Not main in accidental combinationOptionalBooleanLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Combination typeOptionalPredefined stringsLocal, variable
Load case IDsOptionalLoad case name or IDLocal, variable
Load case combination factorsOptionalNumericalLocal, 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) (until CS 16)
  • SLS (until CS 16)
  • ULS_STR_PersistentOrTransient (since CS 17)
  • ULS_GEO_PersistentOrTransient (since CS 17)
  • ULS_EQU_PersistentOrTransient (since CS 17)
  • ULS_Accidental (since CS 17)
  • ULS_Seismic (since CS 17)
  • ULS_Other (default) (since CS 17)
  • SLS_Cheracteristic_GQ (since CS 17)
  • SLS_Frequent_GQ (since CS 17)
  • SLS_QuasiPermanent_GQ (since CS 17)
  • SLS_Cheracteristic_Q (since CS 17)
  • SLS_Frequent_Q (since CS 17)
  • SLS_QuasiPermanent_Q (since CS 17)
  • SLS_Seismic (since CS 17)
  • SLS_Other (since CS 17)

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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Load case IDRequiredLoad case name or IDLocal, variable
Member IDRequiredMember name or IDLocal, variable
Coordinate systemOptionalPredefined stringLocal, variable
x, y, zRequiredNumericalLocal, variable
Fx, Fy, FzRequiredNumericalLocal, variable
Mx, My, MzRequiredNumericalLocal, variable
Eccentricity referenceOptionalPredefined stringsLocal, 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 nameEccentricity 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Load case IDRequiredLoad case name or IDLocal, variable
Member IDRequiredMember name or IDLocal, variable
Coordinate systemOptionalPredefined stringLocal, variable
Reference point 1RequiredNumericalLocal, variable
Reference point 2RequiredNumericalLocal, variable
Distance 1RequiredNumericalLocal, variable
Distance 2RequiredNumericalLocal, variable
Fx1, Fy1, Fz1RequiredNumericalLocal, variable
Fx2, Fy2, Fz2RequiredNumericalLocal, variable
Eccentricity referenceOptionalPredefined stringsLocal, 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 nameEccentricity 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Load case IDRequiredLoad case name or IDLocal, variable
Surface IDRequiredMember name or IDLocal, variable
Coordinate systemOptionalPredefined stringLocal, variable
Fx, Fy, FzRequiredNumericalLocal, variable
xi, yi, ziOptionalNumericalLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Load case IDRequiredLoad case name or IDLocal, variable
Surface IDRequiredMember name or IDLocal, variable
Coordinate systemOptionalPredefined stringLocal, variable
Load directionRequiredPredefined stringsLocal, variable
Distribution typeRequiredPredefined stringsLocal, variable
qix, qiy, qizRequiredNumericalLocal, variable
q1, q2, q3RequiredNumericalLocal, variable
xi, yi, ziOptionalNumericalLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameRequiredStringLocal, variable
xi, yi, ziRequiredNumericalLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Mass group typeRequiredPredefined stringsLocal, 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 nameMass group type
PermanentMGType_EN_P
VariableMGType_EN_T
SnowMGType_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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Mass group IDRequiredMass group name or IDLocal, variable
Seismic directionOptionalPredefined stringsLocal, variable
Free vibration directionOptionalPredefined stringsLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameOptionalStringLocal, variable
Mass case IDsOptionalMass case name or IDLocal, variable
Mass case combination factorsOptionalNumericalLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Mass case IDRequiredMass case name or IDLocal, variable
Member IDRequiredMember name or IDLocal, variable
x, y, zRequiredNumericalLocal, variable
MassRequiredNumericalLocal, 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 parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object nameRequiredStringLocal, variable
Content arrayRequiredObject 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