BuildingTcl -- ModelTypeLabel Elevation
Commands
- addModelData ModelLabel $ModelLabel
- addModelData ModelTypeLabel Elevation
- <addModelData ModelDescription "$ModelDescription">
- <addModelData SupportBC $SupportBC>
- <addModelData OutOfPlaneSupportBC $OutOfPlaneSupportBC >
- <addModelData TributaryWidth $TributaryWidth>
- <addModelData RigidFloor $RigidFloorSwitch>
- <addModelData JointOffsetsSwitch $JointOffsetsSwitch>
- (addModelData -Geometry Height $HeightValue1 Story $StoryValue1)
- (addModelData -Geometry Height $HeightValue2 Story "$StoryValue2 $StoryValue3 ...")
- (addModelData -Geometry Height $HeightValue3 StoryRange "$StoryRangeStartValue1 $StoryRangeEndValue1")
- …
- (addModelData -Geometry Width $WidthValue1 Bay $BayValue1)
- (addModelData -Geometry Width $WidthValue2 Bay "$BayValue2 $BayValue3 ...")
- (addModelData -Geometry Width $WidthValue3 BayRange "$BayRangeStartValue1 $BayRangeEndValue1")
- …
- (addModelData -Columns <ElementModelLabel $ColumnElementModelLabel1> SectionLabel $ColumnSectionLabel1 ColumnLine $ColumnColumnLine1 Story $ColumnStory1 <Orient $ColumnOrient1>)
- (addModelData -Columns <ElementModelLabel $ColumnElementModelLabel2> SectionLabel $ColumnSectionLabel2 ColumnLine "$ColumnColumnLine2 $ColumnColumnLine3" Story "$ColumnStory2 $ColumnStory3" <Orient $ColumnOrient2>)
- (addModelData -Columns <ElementModelLabel $ColumnElementModelLabel3> SectionLabel $ColumnSectionLabel2 ColumnLineRange "$ColumnColumnLineRangeStartValue1 $ColumnColumnLineRangeEndValue1" StoryRange "$ColumnStoryRangeStartValue1 $ColumnStoryRangeEndValue1" <Orient $ColumnOrient3>)
- …
- (addModelData -Beams <ElementModelLabel $BeamElementModelLabel1> SectionLabel $BeamSectionLabel1 Bay $BeamBay1 Floor $BeamFloor1 <Orient $BeamOrient1>)
- (addModelData -Beams <ElementModelLabel $BeamElementModelLabel2> SectionLabel $BeamSectionLabel2 Bay "$BeamBay2 $BeamBay3" Floor "$BeamFloor2 $BeamFloor3" <Orient $BeamOrient2>)
- (addModelData -Beams <ElementModelLabel $BeamElementModelLabel3> SectionLabel $BeamSectionLabel2 BayRange "$BeamBayRangeStartValue1 $BeamBayRangeEndValue1" FloorRange "$BeamFloorRangeStartValue1 $BeamFloorRangeEndValue1" <Orient $BeamOrient3>)
- …
- (addModelData -ChevronBraces <ElementModelLabel $ChevronBraceElementModelLabel1> SectionLabel $ChevronBraceSectionLabel1 Bay $ChevronBraceBay1 Story $ChevronBraceStory1 <Orient $ChevronBraceOrient1>)
- (addModelData -ChevronBraces <ElementModelLabel $ChevronBraceElementModelLabel2> SectionLabel $ChevronBraceSectionLabel2 Bay "$ChevronBraceBay2 $ChevronBraceBay3" Story "$ChevronBraceStory2 $ChevronBraceStory3" <Orient $ChevronBraceOrient2>)
- (addModelData -ChevronBraces <ElementModelLabel $ChevronBraceElementModelLabel3> SectionLabel $ChevronBraceSectionLabel3 BayRange "$ChevronBraceBayRangeStartValue1 $ChevronBraceBayRangeEndValue1" StoryRange "$ChevronBraceStoryRangeStartValue1 $ChevronBraceStoryRangeEndValue1" <Orient $ChevronBraceOrient3>)
- …
- (addModelData -GravityLoad LoadLabel $GravityLoadLabel1 <Bay $GravityBay1> Floor $GravityFloor1 DistributedLoad $DistributedLoad1)
- (addModelData -GravityLoad LoadLabel $GravityLoadLabel2 <Bay "$GravityBay2 $GravityBay3 ..."> Floor "$GravityFloor2 $GravityFloor3 ..." DistributedLoad $DistributedLoad2)
- (addModelData -GravityLoad LoadLabel $GravityLoadLabel3 <BayRange "$GravityStartBay1 $GravityEndBay1"> FloorRange "$GravityStartFloor1 $GravityEndFloor1" DistributedLoad $DistributedLoad3)
- …
- addModel
Required Arguments
- $ModelLabel
- Unique Model Label for reference
- $ModelTypeLabel
- Elevation
The following data may need an indeterminate number of input lines, indicated by the parentheses ()
Geometry Data
Story heights and bay widths are specified used to create the nodes and nodal coordinates. The total number of stories and bays is determined from this data. There are three ways to specify the geometry data
- Individual Value
- The height of $StoryValue1 is $HeightValue1
- The width of $BayValue1 is $WidthValue1
- List of stories/bays with the same height/width
- Stories $StoryValue2, $StoryValue3, etc. all have a height of $HeightValue2
- Bays $BayValue2, $BayValue3, etc. all have a width of $WidthValue2
- Range of stories/bays with the same height/width
- Stories $StoryRangeStartValue1 through $StoryRangeEndValue1 all have a height of $HeightValue3
- Stories $BayRangeStartValue1 through $BayRangeEndValue1 all have a width of $WidthValue3
Structural-Element Data
Columns
- $ColumnElementModelLabel
- Previously-defined ElementModelLabel
- Optional, Default=DefaultColumn
- $ColumnSectionLabel
- Previously-defined SectionLabel
- $ColumnLine
- Column Line quantity where to assign the ColumnSectionLabel
- ColumnLine=1 is the first column on the left
- $Story
- Story quantity where to assign the ColumnSectionLabel
- Story=1 is the first story at the bottom
- $Orient
- Orientation of ColumnSectionLabel
- Optional, Default=HorizontalAxisBending
Beams
- $BeamElementModelLabel
- Previously-defined ElementModelLabel
- Optional, Default=DefaultBeam
- $BeamSectionLabel
- Previously-defined SectionLabel
- $Bay
- Beam Line quantity where to assign the BeamSectionLabel
- Bay=1 is the first Bay on the left
- $Floor
- Floor quantity where to assign the BeamSectionLabel
- Floor=1 is the first ground floor -- no beams are assigned to this floor
- $Orient
- Orientation of BeamSectionLabel
- Optional, Default=HorizontalAxisBending
ChevronBraces
- $ChevronBraceElementModelLabel
- Previously-defined ElementModelLabel
- Optional, Default=DefaultChevronBrace
- $ChevronBraceSectionLabel
- Previously-defined SectionLabel
- $Bay
- ChevronBrace Line quantity where to assign the ChevronBraceSectionLabel
- Bay=1 is the first Bay on the left
- $Story
- Story quantity where to assign the ChevronBraceSectionLabel
- Story=1 is the first ground Story -- no ChevronBraces are assigned to this Story
- $Orient
- Orientation of ChevronBraceSectionLabel
- Optional, Default=HorizontalAxisBending
Gravity Loads
Optional Input Arguments
- $ModelDescription
- Text. Optional, default = blank {}
- $SupportBC
- Support Boundary Conditions
- Options
- fix (default)
- pin
- $OutOfPlaneSupportBC
- Out-of-Plane Support Boundary Conditions (when located in 3DFrame)
- Options
- fix
- fix (default)
- pin
- $TributaryWidth
- Out-of-Plane frame width. Used in mass and weight calculations.
- $RigidFloorSwitch
- Switch on whether to model each floor as a rigid floor
- Options
- off (default)
- on
- $JointOffsetsSwitch
- Switch on whether to model rigid offsets at the joints
- Options
- off (default)
- on
Notes
There are three ways to specify the above data
- Individual Value
- The value is specified individually
- List of quantities
- The quantities are specified individually in a Tcl list "$Quantity1 $Quantity2 ..."
- Range of quantities with the same value
- Quantities are specified by a start value and an end value placed in a Tcl list "$StartQuantity $EndQuantity"
Options
Return to BuildingTcl Command Language Manual