BuildingTcl -- addLoadCombination: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (23 intermediate revisions by the same user not shown) | |||
| Line 6: | Line 6: | ||
:addLoadCombinationData LoadCombinationDescription "$LoadCombinationDescription" | :addLoadCombinationData LoadCombinationDescription "$LoadCombinationDescription" | ||
:addLoadCombinationData LoadCombinationModelLabel $LoadCombinationModelLabel | :addLoadCombinationData LoadCombinationModelLabel $LoadCombinationModelLabel | ||
:addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel1 < | :addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel1 <LoadFactor $LoadFactorGravity1> <InertialMassFactor $InertialMassFactorGravity1> | ||
:addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel2 < | :<addLoadCombinationData -GravityLoad LoadLabel $GravityLoadLabel2 <LoadFactor $LoadFactorGravity2> <InertialMassFactor $InertialMassFactorGravity2> > | ||
... | ... | ||
:<addLoadCombinationData -LateralLoad LoadLabel $LateralLoadLabel1 <AnalysisModelLabel $LateralAnalysisModelLabel1> <$LateralLoadArgumentLabel1a $LateralLoadArgumentValue1a> <$LateralLoadArgumentLabel1b $LateralLoadArgumentValue1b> ... > | :<addLoadCombinationData -GravityLoad AnalysisModelLabel $GravityAnalysisModelLabel1 <Nstep $NstepGravity> <Tolerance $ToleranceGravity>> | ||
:<addLoadCombinationData -LateralLoad LoadLabel $LateralLoadLabel2 <AnalysisModelLabel $LateralAnalysisModelLabel2> <$LateralLoadArgumentLabel2a $LateralLoadArgumentValue2a> <$LateralLoadArgumentLabel2b $LateralLoadArgumentValue2b> ... > | |||
:<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 > | :<addLoadCombinationData InertialMassFactor $InertialMassFactor > | ||
| Line 17: | Line 19: | ||
==Arguments == | ==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 == | ==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 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 | |||
| Line 35: | Line 78: | ||
==Options == | ==Options == | ||
== 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]] | Return to [[BuildingTcl Command Language Manual]] | ||
Latest revision as of 00:27, 5 November 2009
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
- LoadType=LateralPushover
- <$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
- AnalysisTypeLabel=LoadControl
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
Options
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
Return to BuildingTcl Command Language Manual