Skip to main content
Version: 17

SET

Sets or modifies an attribute value of an object.

Syntax

SET [Object ID] [Object attribute] [New value]

Command parameters

Command parameterAssignmentValue formatInput options
Object IDRequiredStringLocal, variable
Object attributeRequiredPredefined stringsLocal, variable
New valueRequiredStringLocal, variable

Object ID:

The ID of the object.

Object IDs from the following object types are accepted:

Object attribute:

The object attribute to be set. The available selection of object attributes depends on the object type, which is autmatically determined based on the object ID. The available object attributes can be found at the detailed description of object types below.

New value:

The new value of the specified attribute.

Sample code

Command only:

SET Object_ID Name "New name"

With object creation:

LOAD_SECTION_LIBRARY section "HEA 200"

CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 3000

SET Mem_ID1 Name "New name"

Detailed description of object types

Structural member

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Section IDsectionidSection ID or name
Eccentricity - yeccentricity_yNumerical
Eccentricity - zeccentricity_zNumerical
RotationRotationNumerical
Initial bow imperfection L/ygeomimpvNumerical
Initial bow imperfection L/ygeomimpwNumerical
Release start pointReleaseID_ARelease ID or name
Release end pointReleaseID_BRelease ID or name
Finite element type (since CS 17)FE_TypePredefined strings
FE generation type (since CS 17)ConvergenceTypePredefined strings
Number of finite elements (since CS 17)ConvergenceNumerical
Avearage shell FE size in web (since CS 17)AverageEdgeLength_WebNumerical
Avearage shell FE size in flange (since CS 17)AverageEdgeLength_FlangeNumerical
Type of the shell constraint element (since CS 17)ShellDOFConstraintPredefined strings

Finite element type:

Valid inputs:
  • 6DOFelem
  • 7DOFelem
  • TensionBar
  • Shell
  • XBrace

FE generation type:

Valid inputs:
  • Automatic
  • Manual

Type of the shell constraint element:

Only applies if FE_Type is set to Shell.

Valid inputs:
  • Trans
  • TransAndRot

Sample code

All available attributes + object creation:

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"
LOAD_SECTION_MACRO Sec_ID2 WLD-IH "WLD-IH (Descript)" "S 355 EN 10025-2" 100 10 200 6 100 10

CREATE Mem_ID1 Structural_Member "HEA 200"
0 0 0
0 0 3000

SET Mem_ID1 Name "New name (Descript)"
SET Mem_ID1 SectionID Sec_ID2 // or: SET Mem_ID1 SectionID "NAME: WLD-IH (Descript)"
SET Mem_ID1 Eccentricity_Y 100
SET Mem_ID1 Eccentricity_Z 100
SET Mem_ID1 Rotation 45
SET Mem_ID1 GeomImpV 200
SET Mem_ID1 GeomImpW 300
SET Mem_ID1 ReleaseID_A yy
SET Mem_ID1 ReleaseID_B zz
SET Mem_ID1 FE_Type Shell //(since CS 17)
SET Mem_ID1 ConvergenceType Manual //(since CS 17)
SET Mem_ID1 Convergence 13 //(since CS 17)
SET Mem_ID1 AverageEdgeLength_Web 23 //(since CS 17)
SET Mem_ID1 AverageEdgeLength_Flange 13 //(since CS 17)
SET Mem_ID1 ShellDOFConstraint TransAndRot //(since CS 17)

Structural Plate

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Material IDMaterialIDMaterial ID or name
ThicknessThicknessNumerical
Finite element sizeAverageEdgeLengthNumerical

Sample code

All available attributes + object creation:

CREATE Plate_ID1 Structural_Plate "C20/25 EN 1992-1-1:2010" 200
0 0 0
3000 0 0
3000 3000 0

CREATE Concrete_Mat_ID1 Concrete "Custom concrete C25" 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

SET Plate_ID1 Name "New plate name"
SET Plate_ID1 MaterialID Concrete_Mat_ID1 // or: SET Plate_ID1 MaterialID "NAME: Custom concrete C25"
SET Plate_ID1 Thickness 234
SET Plate_ID1 AverageEdgeLength 456

Haunched Member

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Member IDOnMemberIDMember ID or name
Start heightHstartNumerical
End heightHendNumerical
Section typeSecTypePredefined strings
Section IDSectionIDSection ID or name
Web thicknessTwNumerical
Flange thicknessTfNumerical
Flange widthBNumerical
LengthLNumerical
Haunch positionTypePredefined strings
Start position along member lengthStartXNumerical

Section type:

Valid inputs:
  • HaunchWelded
  • HaunchRolled

Haunch position:

Valid inputs:
  • Bottom
  • Centric
  • Top

Sample code

All available attributes + object creation:

LOAD_SECTION_LIBRARY Sec_ID1 "IPE 300"
LOAD_SECTION_MACRO Sec_ID2 WLD-IH "WLD-IH (Descript)" "S 355 EN 10025-2" 100 10 200 6 100 10

CREATE Mem_ID1 Structural_Member "IPE 300"
0 0 0
5000 0 0

CREATE Mem_ID2 Structural_Member "IPE 300"
0 3000 0
5000 3000 0

CREATE Hau_ID1 Haunched_Member Mem_ID1 lower 2000 600 50 "IPE 300"
0 0 0
1 0 0

SET Hau_ID1 Name "New haunched member name"
SET Hau_ID1 OnMemberID Mem_ID2
SET Hau_ID1 Hstart 567
SET Hau_ID1 Hend 456
SET Hau_ID1 SecType HaunchWelded
SET Hau_ID1 SectionID Sec_ID2
SET Hau_ID1 Tw 5.6
SET Hau_ID1 Tf 9
SET Hau_ID1 B 234
SET Hau_ID1 L 1234
SET Hau_ID1 Type Centric
SET Hau_ID1 StartX 123

Tapered Member

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Member IDOnMemberIDMember ID or name
Start heightHstartNumerical
End heightHendNumerical
Beam eccentricityFormatPredefined strings

Beam eccentricity:

Valid inputs:
  • Bottom
  • Centric
  • Top

Sample code

All available attributes + object creation:

LOAD_SECTION_MACRO Sec_ID1 WLD-IH Descript_Section "S 235 EN 10025-2" 100 10 200 6 100 10
LOAD_SECTION_MACRO Sec_ID2 WLD-MALTESE "WLD-MALTESE (Descript)" "S 235 EN 10025-2" 400 10 200 20 300 8 150 16

CREATE Mem_ID1 Structural_Member Descript_Section
0 0 0
0 0 3000

CREATE Mem_ID2 Structural_Member Descript_Section
0 2000 0
0 2000 3000

CREATE Tapered_ID1 Tapered_Member Mem_ID1 400 200
Format Centric

SET Tapered_ID1 Name "New tapered member name"
SET Tapered_ID1 OnMemberID Mem_ID2
SET Tapered_ID1 Hstart 567
SET Tapered_ID1 Hend 234
SET Tapered_ID1 Format Bottom

Steel material

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
DensityDensityNumerical
Elastic modulusElasticityNumerical
Poisson factorPoissonNumerical
Thermal expansion coefficientThermalNumerical
Thermal expansion coefficient in fireThermalFiNumerical
Yield strength 1Fy1Numerical
Yield strength 2Fy2Numerical
Ultimate strength 1Fu1Numerical
Ultimate strength 2Fu2Numerical
Thickness YThicknessYNumerical
Thickness UThicknessUNumerical

Sample code

All available attributes + object creation:

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

SET Steel_Mat_ID1 Name "New custom steel name"
SET Steel_Mat_ID1 Density 1234
SET Steel_Mat_ID1 Elasticity 212345
SET Steel_Mat_ID1 Poisson 0.3456
SET Steel_Mat_ID1 Thermal 0.012345
SET Steel_Mat_ID1 ThermalFi 0.023456
SET Steel_Mat_ID1 Fy1 236
SET Steel_Mat_ID1 Fy2 216
SET Steel_Mat_ID1 Fu1 367
SET Steel_Mat_ID1 Fu2 368
SET Steel_Mat_ID1 ThicknessY 41
SET Steel_Mat_ID1 ThicknessU 42

Coated steel material

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
DensityDensityNumerical
Elastic modulusElasticityNumerical
Poisson factorPoissonNumerical
Thermal expansion coefficientThermalNumerical
Thermal expansion coefficient in fireThermalFiNumerical
Basic yield strengthFybNumerical
Ultimate strengthFuNumerical
Coating thicknessCoatingThicknessNumerical

Sample code

All available attributes + object creation:

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

SET CSteel_Mat_ID1 Name "New custom coated steel name"
SET CSteel_Mat_ID1 Density 1234
SET CSteel_Mat_ID1 Elasticity 212345
SET CSteel_Mat_ID1 Poisson 0.3456
SET CSteel_Mat_ID1 Thermal 0.012345
SET CSteel_Mat_ID1 ThermalFi 0.023456
SET CSteel_Mat_ID1 Fyb 356
SET CSteel_Mat_ID1 Fu 421
SET CSteel_Mat_ID1 CoatingThickness 0.0234

Concrete material

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
DensityDensityNumerical
Secant modulus of elasticityElasticityNumerical
Compressive strengthFckNumerical
Characteristic tensile strengthFctkNumerical
Mean tensile strengthFctmNumerical
Final value of creep coefficientCreepNumerical
Poisson factorPoissonNumerical
Thermal expansion coefficientThermalNumerical
Material modelModelTypePredefined strings
Yield strain #1EpsC0Numerical
Ultimite strain #1EpsCu0Numerical
Compression strength reduction factorEtaNumerical
Yield strain #2EpsC1Numerical
Ultimite strain #2EpsCu1Numerical
Yield strain #3EpsC2Numerical
Ultimite strain #3EpsCu2Numerical
ExponentExpNumerical

Material model:

Valid inputs:
  • DiagramRectangle
  • DiagramBilinear
  • DiagramParabolaRect

Sample code

All available attributes + object creation:

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

SET Concrete_Mat_ID1 Name "New custom concrete name"
SET Concrete_Mat_ID1 Density 2567
SET Concrete_Mat_ID1 Elasticity 34567
SET Concrete_Mat_ID1 Fck 26
SET Concrete_Mat_ID1 Fctk 1.9
SET Concrete_Mat_ID1 Fctm 2.7
SET Concrete_Mat_ID1 Creep 2.36
SET Concrete_Mat_ID1 Poisson 0.3456
SET Concrete_Mat_ID1 Thermal 0.012345
SET Concrete_Mat_ID1 ModelType DiagramBilinear
SET Concrete_Mat_ID1 EpsC0 0.0008
SET Concrete_Mat_ID1 EpsCu0 0.0036
SET Concrete_Mat_ID1 Eta 2
SET Concrete_Mat_ID1 EpsC1 0.003
SET Concrete_Mat_ID1 EpsCu1 0.0037
SET Concrete_Mat_ID1 EpsC2 0.00176
SET Concrete_Mat_ID1 EpsCu2 0.0038
SET Concrete_Mat_ID1 Exp 3

Rebar material

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
DensityDensityNumerical
Elastic modulusElasticityNumerical
Poisson factorPoissonNumerical
Thermal expansion coefficientThermalNumerical
Characteristic yield strengthFykNumerical
Characteristic strain at maximum loadEpsSuNumerical

Sample code

All available attributes + object creation:

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

SET Rebar_Mat_ID1 Name "New custom rebar name"
SET Rebar_Mat_ID1 Density 7856
SET Rebar_Mat_ID1 Elasticity 234567
SET Rebar_Mat_ID1 Poisson 0.345
SET Rebar_Mat_ID1 Thermal 0.012345
SET Rebar_Mat_ID1 Fyk 567
SET Rebar_Mat_ID1 EpsSu 0.00567

Point support

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Support typeSupportIDSupport type ID or name
Eccentricity referenceEccTypePredefined strings
Eccentricity - yEccYNumerical
Eccentricity - zEccZNumerical

Eccentricity reference:

Valid inputs:
Eccentricity reference nameEccentricity reference (type this into Descript)
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

All available attributes + object creation:

LOAD_SECTION_MACRO Sec_ID1 WLD-IH "Descript Section" "S 235 EN 10025-2" 100 10 200 6 100 10

CREATE MemberID1 Structural_member "Descript Section"
0 0 0
0 0 3000

CREATE PSupID1 Support_Point MemberID1 Fixed
0 0 0

SET PSupID1 Name "New name"
SET PSupID1 SupportID "NAME: x,y"
SET PSupID1 EccType EccType_BR
SET PSupID1 EccY 21
SET PSupID1 EccZ 33

Line support

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Support typeSupportIDSupport type ID or name
Eccentricity referenceEccTypePredefined strings
Eccentricity - yEccYNumerical
Eccentricity - zEccZNumerical

Eccentricity reference:

Valid inputs:
Eccentricity reference nameEccentricity reference (type this into Descript)
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

All available attributes + object creation:

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)"
EccType EccType_TM

SET LSup_ID1 Name "New name"
SET LSup_ID1 SupportID "NAME: Pinned"
SET LSup_ID1 EccType EccType_BR
SET LSup_ID1 EccY 21
SET LSup_ID1 EccZ 33

Surface support

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Support typeSupportIDSupport type ID or name
Plate IDPlateIDPlate ID or name
Coordinate systemDirTypePredefined strings

Coordinate system:

Valid inputs:
  • Local
  • Global

Sample code

All available attributes + object creation: 2 new surface support types with the name of "Fixed" and "z" have to be created manually before runnnig this code.

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

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

SELECT all
DESELECT all

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

SET SurfSup_ID1 Name "New surface support name"
SET SurfSup_ID1 SupportID z
SET SurfSup_ID1 PlateID Plate_ID2
SET SurfSup_ID1 DirType Global

Support type

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Translational degree of freedom in x directionxNumerical
Translational degree of freedom in y directionyNumerical
Translational degree of freedom in z directionzNumerical
Rotational degree of freedom around x axisxxNumerical
Rotational degree of freedom around y axisyyNumerical
Rotational degree of freedom around z axiszzNumerical
WarpingwNumerical

Sample code

All available attributes + object creation:

CREATE PSup_Type_ID1 Support "Custom support type name" Fix 1234 Fix Fix Fix Fix Fix

SET PSup_Type_ID1 Name "New support type name"
SET PSup_Type_ID1 x Free
SET PSup_Type_ID1 y 2345
SET PSup_Type_ID1 z 5678
SET PSup_Type_ID1 xx Fix
SET PSup_Type_ID1 yy Fix
SET PSup_Type_ID1 zz Fix
SET PSup_Type_ID1 w Fix

Release type

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Translational degree of freedom in x directionxNumerical
Translational degree of freedom in y directionyNumerical
Translational degree of freedom in z directionzNumerical
Rotational degree of freedom around x axisxxNumerical
Rotational degree of freedom around y axisyyNumerical
Rotational degree of freedom around z axiszzNumerical
WarpingwNumerical

Sample code

All available attributes + object creation:

CREATE Release_Type_ID1 Release "Custom release type name" Fix 1234 Fix Fix Fix Fix Fix

SET Release_Type_ID1 Name "New release type name"
SET Release_Type_ID1 x Free
SET Release_Type_ID1 y 2345
SET Release_Type_ID1 z 5678
SET Release_Type_ID1 xx Fix
SET Release_Type_ID1 yy Fix
SET Release_Type_ID1 zz Fix
SET Release_Type_ID1 w Fix

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Release IDReleaseIDRelease ID or name
Position of connectionInterfacePosNumerical
RotationRotationNumerical

Sample code

All available attributes + object creation:

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

SET Link_ID1 Name "New link name"
SET Link_ID1 ReleaseID Continuous
SET Link_ID1 InterfacePos 0.567
SET Link_ID1 Rotation 13.45

Load group

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Load group typeLoadGroupTypePredefined strings
Safety factorFactor_0Numerical
Combination factorFactor_1Numerical
Factor of frequent load levelFactor_2Numerical
Factor of quasi-permanent load levelFactor_3Numerical

Load group type:

Valid inputs:
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

Sample code

All available attributes + object creation:

CREATE LG_ID1 LoadGroup
Name "Variable (Descript)"
LoadGroupType LGType_EN_P
Factor_0 1.35
Factor_1 1
Factor_2 0.9
Factor_3 0

SET LG_ID1 Name "New load group name"
SET LG_ID1 LoadGroupType LGType_EN_C
SET LG_ID1 Factor_0 1.4
SET LG_ID1 Factor_1 1.1
SET LG_ID1 Factor_2 0.98
SET LG_ID1 Factor_3 0.1

Load case

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Load group IDLoadGroupIDLoad group ID or name
Can be favourable in the combinationCanBeFavourableNumerical
Can't be the main in persistent or transient combinationNotMainInTransientCmbNumerical
Can't be the main in accidental combinationNotMainInAccidentalCmbNumerical

Sample code

All available attributes + object creation:

CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P

CREATE LG_ID2 LoadGroup
Name "Variable (Descript)"
LoadGroupType LGType_EN_T

CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1
CanBeFavourable 0
NotMainInTransientCmb 0
NotMainInAccidentalCmb 0

SET LCase_ID1 Name "New load case name"
SET LCase_ID1 LoadGroupID LG_ID2
SET LCase_ID1 CanBeFavourable 1
SET LCase_ID1 NotMainInTransientCmb 1
SET LCase_ID1 NotMainInAccidentalCmb 1

Load combination

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Combination typeTypePredefined strings

Combination type:

Valid inputs:
  • 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)

Sample code

All available attributes + object creation:

CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P

CREATE LG_ID2 LoadGroup
Name "Variable (Descript)"
LoadGroupType LGType_EN_T

CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1

CREATE LComb_ID1 LoadCombination
Name "Load combination (Descript)"
Type ULS_STR_PersistentOrTransient
LCase_ID1 1

SET LComb_ID1 Name "New load combination name"
SET LComb_ID1 Type ULS_Accidental

Point load

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Force in x directionXNumerical
Force in y directionYNumerical
Force in z directionZNumerical
Moment around x axisMXNumerical
Moment around y axisMYNumerical
Moment around z axisMZNumerical
Multiplication factorMulFacNumerical
Eccentricity referenceEccTypePredefined strings
Eccentricity - yEccYNumerical
Eccentricity - zEccZNumerical

Eccentricity reference:

Valid inputs:
Eccentricity reference nameEccentricity reference (type this into Descript)
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

All available attributes + object creation:

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

SET PLoad_ID1 Name "New name"
SET PLoad_ID1 X 10
SET PLoad_ID1 Y 20
SET PLoad_ID1 Z 30
SET PLoad_ID1 MX 40
SET PLoad_ID1 MY 50
SET PLoad_ID1 MZ 60
SET PLoad_ID1 MulFac 2
SET PLoad_ID1 EccType EccType_BL
SET PLoad_ID1 EccY 7
SET PLoad_ID1 EccZ 8

Line load

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
X force component at reference point 1X1Numerical
Y force component at reference point 1Y1Numerical
Z force component at reference point 1Z1Numerical
X force component at reference point 2X2Numerical
Y force component at reference point 2Y2Numerical
Z force component at reference point 2Z2Numerical
Multiplication factorMulFacNumerical
Reference point 1End1Predefined strings
Reference point 2End2Predefined strings
Distance 1Pos1Numerical
Distance 2Pos2Numerical
Eccentricity referenceEccTypePredefined strings
Eccentricity - yEccYNumerical
Eccentricity - zEccZNumerical

Reference point 1:

Valid inputs:
  • EndA (or 0) → from end A
  • EndB (or 1) → from end B

Reference point 2:

Valid inputs:
  • EndA (or 0) → from end A
  • EndB (or 1) → from end B
  • Relative (or 2) → Relative

Eccentricity reference:

Valid inputs:
Eccentricity reference nameEccentricity reference (type this into Descript)
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

All available attributes + object creation:

LOAD_SECTION_LIBRARY Sec_ID1 "HEA 200"

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

SET LLoad_ID1 Name "New name"
SET LLoad_ID1 X1 1
SET LLoad_ID1 Y1 2
SET LLoad_ID1 Z1 3
SET LLoad_ID1 X2 4
SET LLoad_ID1 Y2 5
SET LLoad_ID1 Z2 6
SET LLoad_ID1 MulFac 2
SET LLoad_ID1 End1 EndA
SET LLoad_ID1 End2 Relative
SET LLoad_ID1 Pos1 500
SET LLoad_ID1 Pos2 2000
SET LLoad_ID1 EccType EccType_BR
SET LLoad_ID1 EccY 20
SET LLoad_ID1 EccZ 40

Surface load

A surface load can be of 2 different types: uniform or linearly distributed. Some attributes only apply for one of the load distribution types.

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Load case IDLoadCaseIDLoad case ID
X force component (uniform distr.)XNumerical
Y force component (uniform distr.)YNumerical
Z force component (uniform distr.)ZNumerical
Multiplication factorMulFacNumerical
Load direction (linear distr.)LoadDirPredefined strings
Coordinate system (linear distr.)DirTypePredefined strings
Load intensity at point 1 (linear distr.)LoadValue_1Numerical
Load intensity at point 2 (linear distr.)LoadValue_2Numerical
Load intensity at point 3 (linear distr.)LoadValue_3Numerical

Load direction:

Valid inputs:
  • X
  • Y
  • Z

Coordinate system:

Valid inputs:
  • Local
  • Global

Sample code

All available attributes + object creation:

CREATE LG_ID1 LoadGroup
Name "Permanent (Descript)"
LoadGroupType LGType_EN_P

CREATE LCase_ID1 LoadCase
Name "Load case 1 (Descript)"
LoadGroupID LG_ID1

CREATE LCase_ID2 LoadCase
Name "Load case 2 (Descript)"
LoadGroupID LG_ID1

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

CREATE Plate_ID2 Structural_Plate "C25/30 EN 1992-1-1:2010" 200
0-5000 0 0+1000
3000-5000 0 0
3000-5000 3000 0
0-5000 3000 0+1000

CREATE SLoadUni_ID PlateForce_Uniform LCase_ID1 Plate_ID1 Global
0 0 -10
0 0 0+1000
2000 0 0+(1000/3)
2000 3000 0+(1000/3)
0 3000 0+1000

CREATE SLoadLin_ID PlateForce_Linear LCase_ID1 Plate_ID2 Global
LoadDirection z
DistributionType x
0-5000 0 0+1000 -20
3000-5000 0 0 -10
0-5000 0 0+1000
3000-5000 0 0
2000-5000 3000 0+(1000/3)
0-5000 3000 0+1000

// Uniform
SET SLoadUni_ID Name "New uniform surface load name"
SET SLoadUni_ID LoadCaseID LCase_ID2
SET SLoadUni_ID MulFac 2.3
SET SLoadUni_ID DirType Local
SET SLoadUni_ID X 1
SET SLoadUni_ID Y 2
SET SLoadUni_ID Z -13

// Linear
SET SLoadLin_ID Name "New linear surface load name"
SET SLoadLin_ID MulFac 3.4
SET SLoadLin_ID DirType Local
SET SLoadLin_ID LoadDir X
SET SLoadLin_ID LoadValue_1 11
SET SLoadLin_ID LoadValue_2 22
SET SLoadLin_ID LoadValue_3 33

Load transfer surface

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Member selection typeBeamDefTypePredefined strings
Beam IDsBeamIDsBeam IDs in array
Distribution methodDistribMethodPredefined strings
Load eccentricity zLoadEccZNumerical

Member selection type:

Valid inputs:
  • Selected
  • Planar

Distribution method:

Valid inputs:
  • DisMethodUniform
  • DisMethodStructPoint

Sample code

All available attributes + object creation:

CREATE LTS_ID1 LoadTransferSurface "LTS 1"
0 0 0
3000 0 0
3000 3000 0
0 3000 0

LOAD_SECTION_MACRO Sec_ID2 WLD-IH "WLD-IH (Descript)" "S 355 EN 10025-2" 100 10 200 6 100 10

CREATE Mem_ID1 Structural_Member "WLD-IH (Descript)"
0 0 0
0 3000 0

ARRAY_CREATE arrBeamIDs
ARRAY_ADD arrBeamIDs Mem_ID1

SET LTS_ID1 Name "New load transfer surface name"
SET LTS_ID1 BeamDefType Selected
SET LTS_ID1 BeamIDs arrBeamIDs
SET LTS_ID1 DistribMethod DisMethodStructPoint
SET LTS_ID1 LoadEccZ 123

Mass group

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Mass group typeMassGroupTypePredefined strings

Mass group type:

Valid inputs:
  • MGType_EN_P (Permanent)
  • MGType_EN_T (Transient or Variable)
  • MGType_EN_S (Snow)

Sample code

All available attributes + object creation:

CREATE MG_ID1 MassGroup
Name "Mass group 1 (Descript)"
MassGroupType MGType_EN_P

SET MG_ID1 Name "New mass group name"
SET MG_ID1 MassGroupType MGType_EN_T

Mass case

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Mass group IDMassGroupIDMass group ID
Considered direction in seismic analysisSeismicDirectionPredefined strings
Considered direction in free vibration analysisFreeVibrationDirectionPredefined strings

Considered direction in seismic analysis:

Valid inputs:
  • Z
  • 0

Considered direction in free vibration analysis:

Valid inputs:
  • X
  • Y
  • Z
  • X,Y
  • X,Z
  • Y,Z
  • X,Y,Z

Sample code

All available attributes + object creation:

CREATE MG_ID1 MassGroup
Name "Mass group 1 (Descript)"
MassGroupType MGType_EN_P

CREATE MG_ID2 MassGroup
Name "Mass group 2 (Descript)"
MassGroupType MGType_EN_S

CREATE MC_ID1 MassCase
Name "Mass case (Descript)"
MassGroupID MG_ID1
SeismicDirection 0
FreeVibrationDirection x,y,z

SET MC_ID1 Name "New mass case name"
SET MC_ID1 MassGroupID MG_ID2
SET MC_ID1 SeismicDirection z
SET MC_ID1 FreeVibrationDirection x

Mass combination

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString

Sample code

All available attributes + object creation:

CREATE MG_ID1 MassGroup
Name "Mass group 1 (Descript)"
MassGroupType MGType_EN_P

CREATE MC_ID1 MassCase
Name "Mass case (Descript)"
MassGroupID MG_ID1

CREATE MComb_ID1 MassCombination
Name "Mass combination (Descript)"
MC_ID1 1

SET MComb_ID1 Name "New mass combination name"

Point mass

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
Mass case IDMassCaseIDMass case ID or name
Mass valueValueXNumerical
Multiplication factorMulFacNumerical

Sample code

All available attributes + object creation:

CREATE MG_ID1 MassGroup
Name "Mass group 1 (Descript)"
MassGroupType MGType_EN_T

CREATE MC_ID1 MassCase
Name "Mass case 1 (Descript)"
MassGroupID MG_ID1

CREATE MC_ID2 MassCase
Name "Mass case 2 (Descript)"
MassGroupID MG_ID1

LOAD_SECTION_LIBRARY Section "HEA 200"

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

SET PMass_ID1 Name "New point mass name"
SET PMass_ID1 MassCaseID MC_ID2
SET PMass_ID1 ValueX 1234
SET PMass_ID1 MulFac 10

Portion

Available object attributes:

Object attribute nameObject attribute (type this into Descript)Value format
NameNameString
ItemsItemsObject IDs in array

Sample code

All available attributes + object 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_ADD ObjIDs_to_portion Mem_ID1

CREATE Portion_ID1 portion "Portion 1 (Descript)" ObjIDs_to_portion

ARRAY_ADD ObjIDs_to_portion Mem_ID2

SET Portion_ID1 Name "New portion name"
SET Portion_ID1 Items ObjIDs_to_portion