BuildingTcl -- addLoadCombination

Commands

addLoadCombinationData LoadCombinationLabel $LoadCombinationLabel

addLoadCombinationData LoadCombinationDescription "$LoadCombinationDescription"

addLoadCombinationData LoadCombinationModelLabel $LoadCombinationModelLabel

addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel1 <LoadFactor $LoadFactorGravity1> <InertialMassFactor $InertialMassFactorGravity1>

<addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel2 <LoadFactor $LoadFactorGravity2> <InertialMassFactor $InertialMassFactorGravity2> >

...

<addLoadCombinationData -GravityLoad AnalysisModelLabel $GravityAnalysisModelLabel1 <Nstep $NstepGravity> <Tolerance $ToleranceGravity>>

<addLoadCombinationData -LateralLoad LoadLabel $LateralLoadLabel1 <AnalysisModelLabel $LateralAnalysisModelLabel1> <LoadFactor $LoadFactorLateral1> <$LateralLoadArgumentLabel1a $LateralLoadArgumentValue1a> <$LateralLoadArgumentLabel1b $LateralLoadArgumentValue1b> <$LateralAnalysisArgumentLabel1a $LateralAnalysisArgumentValue1a > <$LateralAnalysisArgumentLabel1b $LateralAnalysisArgumentValue1b> ... >

<addLoadCombinationData -LateralLoad LoadLabel $LateralLoadLabel2 <AnalysisModelLabel $LateralAnalysisModelLabel2> <LoadFactor $LoadFactorLateral2> <$LateralLoadArgumentLabel2a $LateralLoadArgumentValue2a> <$LateralLoadArgumentLabel2b $LateralLoadArgumentValue2b> <$LateralAnalysisArgumentLabel2a $LateralAnalysisArgumentValue2a > <$LateralAnalysisArgumentLabel2b $LateralAnalysisArgumentValue2b> ... >

...

<addLoadCombinationData InertialMassFactor $InertialMassFactor >

addLoadCombination

Arguments

$LoadCombinationLabel

Unique LoadCombination Label for reference

$LoadCombinationDescription

Bracketed text. Optional, default: blank {}

$LoadCombinationModelLabel

Specifies which LoadCombinationModel is being used. Optional, default: DefaultLoadCombinationModel

The only LoadCombinationModelLabel available in the currently release is DefaultLoadCombinationModel

$GravityLoadLabel1 ...

Previously-defined Gravity Load Label, specified within the model.

At leaset one GravityLoadLabel must be specified in each LoadCombination.

$LoadFactorGravity1 ...

Scaling factor for GravityLoadLabel1. Optional, default=1.0

$InertialMassFactorGravity1 ...

Inertial-Mass factor for GravityLoadLabel1. Optional, default=1.0

$GravityAnalysisModelLabel

Previously-defined AnalysisModelLabel, used in performing load-controlled gravity analysis : Optional, default= DefaultLoadControl

$NstepGravity

Number of step to be taken in gravity-load analysis. This value supersedes what has been specified in the analysis model $GravityAnalysisModelLabel

$ToleranceGravity

Convergence-test tolerance used in gravity-load analysis. This value supersedes what has been specified in the analysis model $GravityAnalysisModelLabel

$LateralLoadLabel1 ...

Previously-defined Lateral Load Label, specified within the model.

$LateralAnalysisModelLabel1

Previously-defined AnalysisModelLabel; Only AnalysisModelLabels of the type consistent with the LoadType of $LateralLoadLabel1 can be used.

$LoadFactorLateral1...

Scaling factor for LateralLoadLabel1. Optional, default=1.0

<$LateralLoadArgumentLabel2a $LateralLoadArgumentValue2a> <$LateralLoadArgumentLabel2b $LateralLoadArgumentValue2b> ...

Modifiable arguments corresponding to the LoadType of LateralLoadLabel1

Options:

LoadType=LateralPushover

DMax LateralDirection CycleType NCycles

LoadType=UniformEQ

GMdirection GMscale GMfilename

LoadType=UniformEQ2D

GMscaleX GMscaleZ GMfilenameX GMfilenameZ

LoadType=UniformEQ3D

GMscaleX GMscaleY GMscaleZ GMfilenameX GMfilenameY GMfilenameZ

<$LateralAnalysisArgumentLabel1a $LateralAnalysisArgumentValue1a > <$LateralAnalysisArgumentLabel1b $LateralAnalysisArgumentValue1b> ...

Modifiable arguments corresponding to the AnalysisTypeLabel of LateralAnalysisModelLabel1

Options:

AnalysisTypeLabel=LoadControl

Nstep Tolerance

AnalysisTypeLabel=DisplacementHistory

DisplacementIncrement Tolerance

AnalysisTypeLabel=TimeHistory

DtAnalysis TmaxAnalysis Tolerance DampingRatio

Notes

• The addLoadCombination command must be placed at the end of each LoadCombination-data definition, as it takes all data defined since the last addLoadCombination command and define the LoadCombination.
• The Load and AnalysisModel Arguments specified at the LoadCombination level supersed previously-defined values.
• When LoadType=LateralPushover, $LateralLoadLabel1 $LateralLoadLabel2 ... must all be in the same direction
• Currently, the only LoadCombinationModelLabel DefaultLoadCombinationModel

Examples

• BuildingTcl -- addSection Examples -- Gravity-Only Load Combinations
• BuildingTcl -- addSection Examples -- Static Pushover Load Combinations
• BuildingTcl -- addSection Examples -- Cyclic Static Pushover Load Combinations
• BuildingTcl -- addSection Examples -- EQ Load Combinations

---

BuildingTcl -- addModel

Return to BuildingTcl Command Language Manual