BuildingTcl -- ModelTypeLabel Elevation
Jump to navigation
Jump to search
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> <Eccentricity $ChevronBraceEccentricity1>)
- (addModelData -ChevronBraces <ElementModelLabel $ChevronBraceElementModelLabel2> SectionLabel $ChevronBraceSectionLabel2 Bay "$ChevronBraceBay2 $ChevronBraceBay3 ..." Story "$ChevronBraceStory2 $ChevronBraceStory3 ..." <Orient $ChevronBraceOrient2> <Eccentricity $ChevronBraceEccentricity2>)
- (addModelData -ChevronBraces <ElementModelLabel $ChevronBraceElementModelLabel3> SectionLabel $ChevronBraceSectionLabel3 BayRange "$ChevronBraceBayRangeStartValue1 $ChevronBraceBayRangeEndValue1" StoryRange "$ChevronBraceStoryRangeStartValue1 $ChevronBraceStoryRangeEndValue1" <Eccentricity $ChevronBraceEccentricity3> <Orient $ChevronBraceOrient3> <Eccentricity $ChevronBraceEccentricity3>)
- …
- (addModelData -ColumnHinges <ElementModelLabel $ColumnHingeElementModelLabel1> SectionLabel $ColumnHingeSectionLabel1 ColumnLine $ColumnHingeColumnLine1 Story $ColumnHingeStory1 <HingeLocation $ColumnHingeLocation1>)
- (addModelData -ColumnHinges <ElementModelLabel $ColumnHingeElementModelLabel2> SectionLabel $ColumnHingeSectionLabel2 ColumnLine "$ColumnHingeColumnLine2 $ColumnHingeColumnLine3 ..." Story "$ColumnHingeStory2 $ColumnHingeStory3 ..." <HingeLocation $ColumnHingeLocation2>)
- (addModelData -ColumnHinges <ElementModelLabel $ColumnHingeElementModelLabel3> SectionLabel $ColumnHingeSectionLabel2 ColumnLineRange "$ColumnHingeColumnLineRangeStartValue1 $ColumnHingeColumnLineRangeEndValue1" StoryRange "$ColumnHingeStoryRangeStartValue1 $ColumnHingeStoryRangeEndValue1" <HingeLocation $ColumnHingeLocation3>)
- …
- (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 used to create the nodes and nodal coordinates. The total number of stories and bays is determined from this data.
- $HeightValue
- Height of story $StoryValue
- $WidthValue
- Width of bay $BayValue
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
- $Eccentricity
- Eccentricity between braces at the top-beam connection
- Optional, Default = 0
ColumnHinges
- $ColumnElementModelLabel
- Previously-defined ElementModelLabel
- Optional, Default=DefaultColumnHinge
- $ColumnHingeSectionLabel
- Previously-defined SectionLabel
- $ColumnLine
- Column Line quantity where to assign the ColumnHingeSectionLabel
- ColumnLine=1 is the first column on the left
- $Story
- Story quantity where to assign the ColumnHingeSectionLabel
- Story=1 is the first story at the bottom
- $Orient
- Orientation of ColumnHingeSectionLabel
- Optional, Default=HorizontalAxisBending
- $HingeLocation
- Location of ColumnHinge
- Optional, Default=BothEnds
Gravity Loads
- $GravityLoadLabel
- Previously-defined LoadLabel of the LoadType GravityLoad
- $Bay
- Bay on which to apply the distributed load
- Optional, Default = all (all, however, is not an option)
- $Floor
- Floor on which to apply the gravity load
- $DistributedLoad
- Distributed-load value in terms of Weight per Area.
- Total weight on beam is calculated from TotalWeight = $DistributedLoad * (Beam length calculated by program) * $TributaryWidth
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