View source for OpenSees Example 4. Portal Frame

==Introduction==
This is a great example!
To all the demonstrations that Example 3 has done, Example 4 adds the use of previously-defined Tcl procedures (a procedure is a Tcl command that is created by the proc command) or scripts.
This example also introduces new kinds of static and dynamic analyses.



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

{| 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>Elastic Element</h4>
----
|-
| style="color:#000;" | <div>
[[File:ExampleFigure_ElasticSection.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.build.ElasticElement.tcl|Ex4.Portal2D.build.ElasticElement.tcl]]
*[[Media:LibUnits.tcl|LibUnits.tcl]]
----
<strong>Notes</strong>
*Effective axial and flexural stiffnesses are defined at the element level
*elasticBeamColumn elements
</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>Distributed Plasticity Element, Uniaxial Section</h4>
----
|-
| style="color:#000;" | <div>
[[File:ExampleFigure_uniaxialSection.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.build.InelasticSection.tcl|Ex4.Portal2D.build.InelasticSection.tcl]]
*[[Media:LibUnits.tcl|LibUnits.tcl]]
----
<strong>Notes</strong>
*Axial and flexural stiffnesses/strength are defined independently at the section level
*uniaxial inelastic section (moment-curvature)
*nonlinear beam-column elements
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:3px solid #ccc; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top;background:#white;"
<h4>Distributed Plasticity Element, Fiber Section</h4>
----
|-
| style="color:#000;" | <div>
[[File:ExampleFigure_FiberSection.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.build.InelasticFiberSection.tcl|Ex4.Portal2D.build.InelasticFiberSection.tcl]]
*[[Media:LibUnits.tcl|LibUnits.tcl]]
----
<strong>Notes</strong>
*The section is broken down into fibers where uniaxial materials are defined independently. 
*The program calculates flexural and axial stiffnesses/strength by integrating strains across the section. 
*fiber section
*nonlinear beam-column elements
</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:Example4_Push.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Static.Push.tcl|Ex4.Portal2D.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:Example4_Cyclic.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Static.Cycle.tcl|Ex4.Portal2D.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:Example4_UniformSine.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Dynamic.sine.Uniform.tcl|Ex4.Portal2D.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:Example4_UniformEQ.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Dynamic.EQ.Uniform.tcl|Ex4.Portal2D.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:Example4_MultiSupportSine.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Dynamic.sine.multipleSupport.tcl|Ex4.Portal2D.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:Example4_MultiSupportEQ.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Dynamic.EQ.multipleSupport.tcl|Ex4.Portal2D.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:Example4_BidirectEQ.GIF|link=OpenSees Example 4. Portal Frame]]
----
<strong>Files</strong>
*[[Media:Ex4.Portal2D.analyze.Dynamic.EQ.bidirect.tcl|Ex4.Portal2D.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 Elastic Mode, Static Pushover Analysis:
<blockquote><source lang="Tcl">
puts " -------------Elastic Model -------------"
puts " -------------Static Pushover Analysis -------------"
source Ex4.Portal2D.build.ElasticElement.tcl
source Ex4.Portal2D.analyze.Static.Push.tcl 
</source></blockquote>

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

* To run Uniaxial Inelastic Material, Fiber Section, Nonlinear Model, Dynamic Bidirectional Earthquake Ground Motion 
<blockquote><source lang="Tcl">
puts " -------------Uniaxial Inelastic Material, Fiber Section, Nonlinear Model -------------"
puts " -------------Dynamic Bidirectional Earthquake Ground Motion  -------------"
source Ex4.Portal2D.build.InelasticFiberSection.tcl
source Ex4.Portal2D.analyze.Dynamic.EQ.bidirect.tcl
</source></blockquote>


==Notes==


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

Return to [[OpenSees User]]