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

---

BuildingTcl -- addModel

Return to BuildingTcl Command Language Manual