View source for OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section

==Introduction==
*Just like Example 6 for the 2D frame, this example utilizes Tcl variable-substitution and array-management tools to optimize the building of the numerical model of a generic 3D frame. 
*The user is prompted for the number of stories and the number of bays (the can also be fixed in the input file). 
*The same items for 3D modelling as the frame shown in Example 7 are considered here.
*For this example, there is one model-building file with many options for the model. In addition to specific dynamic-analysis files, there is also a dynamic-analysis file where the user is given the option of which dynamic analysis to perform.

==Input==
<h3>Model Building</h3>
*The following tasks are performed when building the model
<blockquote>
*define units
*define model
*define recorders for output
*define & apply gravity
</blockquote>
*The only difference between the two input files is in modelling the element section properties and calculating beam and column weight/mass.

{| style="margin:0; background:none;" 
<!--        Column 1       -->
| style="margin:0; width:25%; border:3px solid #ccc; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top;background:#white;"
<h4>Steel W Section</h4>
----
|-
| style="color:#000;" | <div>
[[File:ExampleFigure_FiberSection_W.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.build.Wsec.tcl|Ex8.genericFrame3D.build.Wsec.tcl]]
*[[Media:LibUnits.tcl|LibUnits.tcl]]
*[[Media:Wsection.tcl|Wsection.tcl]]
*[[Media:DisplayPlane.tcl|DisplayPlane.tcl]]
*[[Media:DisplayModel3D.tcl|DisplayModel3D.tcl]]
----
<strong>Notes</strong>
*3D building frame: Steel W sections for both columns and beams. (variable elastic or fiber section)
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:3px solid #ccc; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top;background:#white;"
<h4>RC Section</h4>
----
|-
| style="color:#000;" | <div>
[[File:ExampleFigure_FiberSection_RC.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.build.RCsec.tcl|Ex8.genericFrame3D.build.RCsec.tcl]]
*[[Media:LibUnits.tcl|LibUnits.tcl]]
*[[Media:LibMaterialsRC.tcl|LibMaterialsRC.tcl]]
*[[Media:BuildRCrectSection.tcl|BuildRCrectSection.tcl]]
*[[Media:DisplayPlane.tcl|DisplayPlane.tcl]]
*[[Media:DisplayModel3D.tcl|DisplayModel3D.tcl]]
----
<strong>Notes</strong>
*3D building frame: Reinforced-concrete rectangular sections for both columns and beams. (variable elastic or fiber section)
*As of OpenSees version 3.2.2, you need to define torsion for the 3D fiber sections (https://wp.me/pbejzW-9X)
</div>
|}


|}


<h3>Lateral-Load Analysis</h3>
The following tasks are performed in the analysis
<blockquote>
*define lateral-load parameters
*analyze
</blockquote>
{| style="margin:0; background:none;" 
<!--        Column 1       -->
| style="margin:0; width:25%; border:3px solid #ccc; background:#white; vertical-align:top; " |
<h4>Static</h4>
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Static Pushover</h5>
[[File:ExampleFigure_Push.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Static.Push.tcl|Ex8.genericFrame3D.analyze.Static.Push.tcl]]
*[[Media:LibAnalysisStaticParameters.tcl|LibAnalysisStaticParameters.tcl]]
----
<strong>Notes</strong>
*One-directional monotonic displacement-controlled static loading
</div>
|}
----
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Static Reversed Cyclic</h5>
[[File:ExampleFigure_Cyclic.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Static.Cycle.tcl|Ex8.genericFrame3D.analyze.Static.Cycle.tcl]]
*[[Media:LibAnalysisStaticParameters.tcl|LibAnalysisStaticParameters.tcl]]
*[[Media:LibGeneratePeaks.tcl|LibGeneratePeaks.tcl]]
----
<strong>Notes</strong>
*One-directional displacement-controlled static loading
*Displacement cycles are imposed in positive and negative direction
</div>
|}

<!--        Column 2        -->
| style="margin:0; width:25%; border:3px solid #ccc; background:#white; vertical-align:top; " |
<h4>Dynamic EQ Ground Motion</h4>
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Dynamic Uniform Sine-Wave Ground Motion</h5>
[[File:ExampleFigure_UniformSine.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Dynamic.sine.Uniform.tcl|Ex8.genericFrame3D.analyze.Dynamic.sine.Uniform.tcl]]
*[[Media:LibAnalysisDynamicParameters.tcl|LibAnalysisDynamicParameters.tcl]]
----
<strong>Notes</strong>
*Sine-wave acceleration input
*Same acceleration input at all nodes restrained in specified direction
</div>
|}
----
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Dynamic Uniform Earthquake Ground Motion (typical)</h5>
[[File:ExampleFigure_UniformEQ.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Dynamic.EQ.Uniform.tcl|Ex8.genericFrame3D.analyze.Dynamic.EQ.Uniform.tcl]]
*[[Media:LibAnalysisDynamicParameters.tcl|LibAnalysisDynamicParameters.tcl]]
*[[Media:ReadSMDFile.tcl|ReadSMDFile.tcl]]
*[[Media:H-E12140.zip|H-E12140.AT2]]
----
<strong>Notes</strong>
*Earthquake (from file) acceleration input
*Same acceleration input at all nodes restrained in specified direction
</div>
|}
----
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Dynamic Multiple-Support Sine-Wave Ground Motion</h5>
[[File:ExampleFigure_MultiSupportSine.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Dynamic.sine.multipleSupport.tcl|Ex8.genericFrame3D.analyze.Dynamic.sine.multipleSupport.tcl]] (this file may need to be corrected for displacement input)
*[[Media:LibAnalysisDynamicParameters.tcl|LibAnalysisDynamicParameters.tcl]]
----
<strong>Notes</strong>
*Sine-wave displacement input
*Different displacements are specified at particular nodes in specified directions
</div>
|}
----
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Dynamic Multiple-Support Earthquake Ground Motion</h5>
[[File:ExampleFigure_MultiSupportEQ.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Dynamic.EQ.multipleSupport.tcl|Ex8.genericFrame3D.analyze.Dynamic.EQ.multipleSupport.tcl]] (this file needs to be corrected for displacement input)
*[[Media:LibAnalysisDynamicParameters.tcl|LibAnalysisDynamicParameters.tcl]]
*[[Media:ReadSMDFile.tcl|ReadSMDFile.tcl]]
*[[Media:H-E12140D.zip|H-E12140.DT2]] (Displacement recording)
----
<strong>Notes</strong>
*Earthquake (from file) displacement input
*Different displacements are specified at particular nodes in specified directions 
</div>
|}
----
{| style="width:100%; border:1px solid #ddcef2; vertical-align:top;background:#white;"
|-
| style="color:#000;" | <div>
<h5>Dynamic Bidirectional Earthquake Ground Motion (typical)</h5>
[[File:ExampleFigure_BidirectEQ.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
----
<strong>Files</strong>
*[[Media:Ex8.genericFrame3D.analyze.Dynamic.EQ.bidirect.tcl|Ex8.genericFrame3D.analyze.Dynamic.EQ.bidirect.tcl]]
*[[Media:LibAnalysisDynamicParameters.tcl|LibAnalysisDynamicParameters.tcl]]
*[[Media:ReadSMDFile.tcl|ReadSMDFile.tcl]] (need to modify ReadSMDFile.tcl for displacement data)
*[[Media:H-E12140.zip|H-E12140.AT2]]
*[[Media:H-E01140.zip|H-E01140.AT2]] (acceleration recording in perpendicular direction)
----
<strong>Notes</strong>
*Earthquake (from file) acceleration input
*Different ground motion in two directions
*Same acceleration input at all nodes restrained in specified direction
</div>
|}

|}

==Run==
The model and analysis combinations for this example are numerous. The following are an small subset, for demonstration purposes:

* To run W-Section Model, Static Pushover Analysis:
<blockquote><source lang="Tcl">
puts " -------------Elastic Model -------------"
puts " -------------Static Pushover Analysis -------------"
source Ex8.genericFrame3D.build.Wsec.tcl
source Ex8.genericFrame3D.analyze.Static.Push.tcl 
</source></blockquote>

* To run RC Model, Uniform Earthquake Excitation
<blockquote><source lang="Tcl">
puts " -------------Uniaxial Inelastic Section, Nonlinear Model -------------"
puts " -------------Uniform Earthquake Excitation -------------"
source Ex8.genericFrame3D.build.RCsec.tcl
source Ex8.genericFrame3D.analyze.Dynamic.EQ.Uniform.tcl 
</source></blockquote>

==Notes==
In this example, the following items are variables:
<blockquote>
*Number of stories in Y direction
*Number of bays in X direction
*Number of bays in Z direction
*Elastic/Fiber Section
*Display: none/node numbering/deformed shape/mode shape (can choose which mode) (variable display scaling factor for both the deformed shape and the mode shape, this scaling factor is dependent on the user choice) 
</blockquote>


----
Return to [[OpenSees Examples Manual -- Structural Models & Analyses]]

Return to [[OpenSees User]]