BuildingTcl -- addLoadCombination: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
* [[BuildingTcl -- ]]
__NOTOC__
[[Image:BuildingTclLogo.gif|link=BuildingTcl|right]]
==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
==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]]
[[BuildingTcl -- addModel]]
 
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


<$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


Options

Examples



BuildingTcl -- addModel

Return to BuildingTcl Command Language Manual