Examples Manual: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!--        INTRODUCTION        -->
<h1>Introduction</h1>
The examples in this manual are listed in order of simplicity.


<html>
NOTE: gravity analysis is always included as part of the model building


<h1 class="heading1">OpenSees Examples Manual</h1>
<!--        MODELS        -->
<table width="558" cellpadding="2" cellspacing="0" border="0" style="border-collapse:collapse">
<h1>Models</h1>
<tr align="left" valign="top">
 
<td width="558"><p class="htmlopeningpagetitle">Open System for </p>
The following types of models are represented in these examples:
<p class="htmlopeningpagetitle">Earthquake Engineering Simulation</p>
:;<h2>Elastic Elements</h2>
<p class="htmlopeningpagetitle">Examples Manual</p>
: OpenSees [[Elastic Beam Column Element]]
</td>
: The elastic, uncoupled, axial and flexural stiffnesses are defined at the element level
</tr>
: user specifies: E,I,A
<tr align="left" valign="top">
:;<h2>Inelastic Elements</h2>
<td width="558"><p class="htmlopeningpagetext">Silvia Mazzoni, Frank McKenna, Gregory L. Fenves</p>
: OpenSees [[Force-Based Beam-Column Element]]
</td>
: Two types of sections
</tr>
::<h3>Uniaxial Section</h3>
<tr align="left" valign="top">
::: The inelastic, uncoupled, axial and flexural stiffnesses are defined at the section level
<td width="558"><p class="htmlopeningpagetext">Pacific Earthquake Engineering Research Center</p>
::: The OpenSees [[Uniaxial Section]] Command is used
<p class="htmlopeningpagetext">University of California, Berkeley</p>
::: User specifies:
</td>
:::: Axial stiffness A
</tr>
:::: Section Moment-Curvature characteristics via the OpenSees [[UniaxialMaterial Command]]
<tr align="left" valign="top">
::<h3>Fiber Section</h3>
<td width="558"><p class="htmlopeningpagetext">OpenSees version 1.7.3</p>
::: The section is broken down into fibers where uniaxial materials are defined independently.
</td>
::: The program calculates the coupled flexural and axial stiffnesses/strength by integrating strains across the section
</tr>
::: The OpenSees [[Fiber Section]] Command is used
<tr align="left" valign="top">
::: User specifies
<td width="558"><p class="htmlopeningpagetext">December 2006</p>
:::: Stress-Strain characteristics via the OpenSees [[UniaxialMaterial Command]] for all number of materials
</td>
:::: Section geometry via series of Patches and Layers in the fiber section
</tr>
::: Two Section Geometries are presented
:::: *RC Rectangular Section
:::: *Standard AISC W section
 
<!--        LATERAL LOADS        -->
<h1>Lateral Loads</h1>
The following types of lateral loads are represented in these examples:
[[File:StaticPushoverLoads_Figure1.GIF|link=OpenSees Examples Manual -- Structural Models & Analyses|right]]
:;<h2> Static Pushover</h2>
: Control node is located at the highest floor
: Lateral-load distribution is proportional the the mass distribution along the height of the building
: Static analysis
: Two types
::<h3>Monotonic Pushover</h3>
::: One-directional displacement-controlled static lateral loading
::<h3>Reversed Cyclic Pushover</h3>
::: One-directional displacement-controlled static lateral loading
::: Displacement cycles are imposed in positive and negative direction
[[File:TimeDependent_Figure1.GIF|link=OpenSees Examples Manual -- Structural Models & Analyses|right]]
:;<h2> Time-Dependent Dynamic Loads</h2>
: Transient analysis
: Four types
::<h3>Uniform Sine-Wave</h3>
::: Sine-wave acceleration input
::: Same acceleration input at all nodes restrained in specified direction
::<h3>Multiple-Support Sine-Wave</h3>
::: Sine-wave displacement input
::: Different displacements are specified at particular nodes in specified directions
::<h3>Uniform Earthquake</h3>
::: Earthquake (from file) acceleration input
::: Same acceleration input at all nodes restrained in specified direction
::<h3>Multiple-Support Earthquake</h3>
::: Earthquake (from file) displacement input
::: Different displacements are specified at particular nodes in specified direction
::<h3>Bidirectional Earthquake</h3>
::: Different inputs are specified for two directions
::: Same acceleration input at all nodes restrained in specified direction
 
<!--        SIMULATION        -->
<h1>Simulation Process</h1>
Each example script does the following:<br>
:<h2>Build the model</h2>
:#model dimensions and degrees-of-freedom
:#nodal coordinates
:#nodal constraints -- boundary conditions
:#nodal masses
:#elements and element connectivity
:#recorders for output
 
:<h2>Define & apply gravity load</h2>
:#nodal or element load
:#static-analysis parameters (tolerances & load increments)
:#analyze
:#hold gravity loads constant
:#reset time to zero
 
:<h2> Define and apply lateral load </h2>
:#load pattern (nodal loads for static analysis, support ground motion for earthquake)
:#lateral-analysis parameters (tolerances & displacement/time increments)
:#*Static Lateral-Load Analysis
:#**define the displacement increments and displacement path
:#*Dynamic Lateral-Load Analysis
:#**define the input motion and all associated parameters, such as scaling and input type
:#**define analysis duration and time increment
:#**define damping
:#analyze
   
   
</table>
 
<p class="htmlopeningpagetext"></p>
 
<p class="htmlopeningpagetext"></p>
 
<table width="747" cellpadding="2" cellspacing="0" border="0" style="border-collapse:collapse">
<h1>Introductory Examples</h1>
<tr align="left" valign="top">
The objective of Example 1a and Example 1b is to give an overview of input-file format in OpenSees using simple scripts. <br>
<td style = "border:1px solid #010101;" width="747"><p class="heading3">Portable Files:</p>
These scripts do not take advantage of the Tcl scripting capabilities shown in the later examples. However, they do provide starting a place where the input file is similar to that of more familiar Finite-Element Analysis software. Subsequent examples should be used as the basis for user input files.
<p class="heading3">&nbsp;</p>
<!--        SECTION        -->
<p class="heading3">Example Files can be downloaded from <a class="popuptemplate" title="" href="https://central.nees.org/?projid=401&action=DisplayProjectPublicData" target="_blank">NEEScentral</a>.</p>
:<h2>[[OpenSees Example 1a. 2D Elastic Cantilever Column ]]</h2>
<p class="heading3">&nbsp;</p>
<!--        subSECTION 1        -->
<p class="htmlopeningpagetext">The following is a Zipped .chm file and its components</p>
<!--        4 COLUMNS        -->
<ul class="listbullet"><li class="listbullet">Note 1. Windows Operating system only</li><li class="listbullet">Note 2. The links to the examples files do not work, but are included in a subdirectory</li></ul><table width="739" cellpadding="2" cellspacing="0" border="0" style="border-collapse:collapse">
{| style="margin:0; background:none;"  
<tr align="left" valign="top">
<!--        Column 1  image    -->
<td width="83"><p class="htmlopeningpagetext">&nbsp;</p>
|-
</td>
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;"|
<td width="656"><p class="heading3"><a class="" title="" href="../OpenSeesExamplesManual.chm.zip" target="_self">OpenSeesExamplesManual.chm.zip</a></p>
{| style="width:100%; vertical-align:top; background:#white;"
</td>
! style="padding:2px" |
</tr>
|-
| style="color:#000;" | <div>
</table>
[[File:Example1a_Figure1.gif|link=OpenSees Example 1a. 2D Elastic Cantilever Column]]
<p class="htmlopeningpagetext">&nbsp;</p>
</div>
<p class="htmlopeningpagetext">All Examples Files in one Zip file, without any manuals:</p>
|}
<table width="739" cellpadding="2" cellspacing="0" border="0" style="border-collapse:collapse">
<!--        Column 2        -->
<tr align="left" valign="top">
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
<td width="83"><p class="tablebodytext">&nbsp;</p>
{| style="width:100%; vertical-align:top;background:#white;"
</td>
! style="padding:2px" | <strong>Objectives</strong>
<td width="656"><p class="heading3"><a class="" title="" href="../ExamplesFiles.zip" target="_self">ExamplesFiles.zip</a></p>
|-
</td>
| style="color:#000;" | <div>
</tr>
*overview of basic OpenSees input structure
*coordinates, boundary conditions, element connectivity, nodal masses, nodal loads, etc.
</table>
*two-node, one element
<p class="htmlopeningpagetext">&nbsp;</p>
</div>
</td>
|}
</tr>
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
</table>
{| style="width:100%; vertical-align:top; background:#white;"
<p class="htmlopeningpagetext"></p>
! style="padding:2px" | <strong>Models</strong>
<p class="htmlopeningpagetext"> please send questions and comments about the manual to opensees-support @ berkeley.edu</p>
|-
<p class="bodytext"></p>
| style="color:#000;" | <div>
*elastic elements
</body>
</div>
</html>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 1b. Elastic Portal Frame]]</h2>
<!--        subSECTION 2       -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example1b_Figure1.gif|link=OpenSees Example 1b. Elastic Portal Frame]]</div>
|}
 
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*two element types
*distributed element loads
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*elastic elements
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
 
 
 
 
<h1>Simple Examples of Nonlinear-Models</h1> 
<!--        SECTION        -->
:<h2>[[OpenSees Example 2a. Elastic Cantilever Column with variables]]</h2>
<!--        subSECTION 1        -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example2a_figure1.GIF|link=OpenSees Example 2a. Elastic Cantilever Column with variables]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*introduce variable: define & use
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*elastic element
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 2b. Nonlinear Cantilever Column: Uniaxial Inelastic Section]]</h2>
<!--        subSECTION 2      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example2b_figure1.GIF|link=OpenSees Example 2b. Nonlinear Cantilever Column: Uniaxial Inelastic Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*first example of nonlinear model, set nonlinearity at section level
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*nonlinearBeamColumn element
*uniaxial section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 2c. Nonlinear Cantilever Column: Inelastic Uniaxial Materials in Fiber Section ]]</h2>
<!--        subSECTION  3      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example2c_figure1.GIF|link=OpenSees Example 2c. Nonlinear Cantilever Column: Inelastic Uniaxial Materials in Fiber Section ]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*set nonlinearity at material level
*material stress-strain response is assembled into fiber section
*reinforced-concrete fiber section
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*nonlinearBeamColumn element
*uniaxial material
*fiber section (Reinforced-concrete fiber section)
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
 
 
 
<h1>2D Structural Modeling & Analysis Examples</h1> 
These examples take advantage of the Tcl scripting language starting from simple variable substitutions in the initial examples, to the more advanced techniques of array management and logical expressions (if-then statements). <br>
<!--        SECTION        -->
:<h2>[[OpenSees Example 3. Cantilever Column with units]]</h2>
<!--        subSECTION 1        -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example3_figure1.GIF|link=OpenSees Example 3. Cantilever Column with unit]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*units, defined and used (they will be used in all subsequent examples)
*separate model-building and analysis files
*introduce PDelta effects (or not)
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*elastic elements
*inelastic uniaxial section
*fiber section (Reinforced-concrete fiber section)
*Linear, PDelta or Corotational Transformation
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static pushover
*dynamic earthquake-input
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 4. Portal Frame]]</h2>
<!--        subSECTION 2      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example4_figure1.GIF|link=OpenSees Example 4. Portal Frame]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*use previously-defined procedures to simplify input
*introduce more analysis types
*introduce procedure to read database input motion files (data with text in first lines)
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*elastic elements
*inelastic uniaxial section
*inelastic fiber section (Reinforced-concrete fiber section)
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION  3      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example5_figure1.GIF|link=OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*2D frame of fixed geometry: 3-story, 3-bay
*nodes and elements are defined manually, one by one
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*elastic uniaxial section
*inelastic uniaxial section
*inelastic fiber section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION  4      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example6_figure1.GIF|link=OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*2D frame geometry of variable geometry ( # stories and # bays are variables)
*node and element definition is automated
*use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 2D
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*elastic uniaxial section
*inelastic uniaxial section
*inelastic fiber section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
 
<!--        SECTION        -->
:<h2>[[OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION  3      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example5_figure1.GIF|link=OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*2D frame of fixed geometry: 3-story, 3-bay
*nodes and elements are defined manually, one by one
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*elastic uniaxial section
*inelastic uniaxial section
*inelastic fiber section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION  4      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example6_figure1.GIF|link=OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*2D frame geometry of variable geometry ( # stories and # bays are variables)
*node and element definition is automated
*use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 2D
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*elastic uniaxial section
*inelastic uniaxial section
*inelastic fiber section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
 
 
 
<h1>3D Structural Modeling & Analysis Examples</h1> 
<blockquote>
A few items are new in 3D:
*Additional coordinates need to be considered in defining nodes
*Additional degrees of freedom need to be considered in defining the following:
**nodal constraints (boundary conditions)
**nodal masses
**nodal loads
*The transformation from local element/section coordinates to global system coordinates needs to be specified
*Element loads are specified in local coordinates
*Additional arguments are required for many elements (bending about local-y axis) properties
*Element/Section torsional stiffness needs to be considered
*Rigid floor diaphragms need be included for building models
</blockquote>
 
 
<!--        SECTION        -->
:<h2>[[OpenSees Example 7. 3D Frame, 3-story 3-bayX 3-bayZ, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION 1        -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example7_figure1.GIF|link=OpenSees Example 7. 3D Frame, 3-story 3-bayX 3-bayZ, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*3D frame of fixed geometry
*nodes and elements are manually manually, one by one
*introduce rigid floor diaphragm
*use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 3D
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*Elastic or Fiber Section option is a variable within one input file
*rigid diaphragm
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
<!--        SECTION        -->
:<h2>[[OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]</h2>
<!--        subSECTION 2      -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example8_figure1.GIF|link=OpenSees Example 8. generic 3D Frame, NStory NBayX NBayZ, Reinforced-Concrete Section & Steel W-Section]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*3D frame geometry of variable geometry ( # stories and # bays in X and Z are variables)
*node and element definition is automated
*introduce user-input interface, the user is given the option as to what to view in model
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Reinforced-Concrete Section
*Steel W-Section
*Elastic or Fiber Section option is a variable within one input file
*optional rigid diaphragm
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*static reversed cyclic analysis
*dynamic sine-wave input analysis (uniform excitation)
*dynamic earthquake-input analysis (uniform excitation)
*dynamic sine-wave input analysis (multiple-support excitation)
*dynamic earthquake-input analysis (multiple-support excitation)
*dynamic bidirectional earthquake-input analysis (uniform excitation)
</div>
|}
|}
 
 
 
 
 
<h1>Section Modeling And Analysis Examples</h1> 
<!--        SECTION        -->
:<h2>[[OpenSees Example 9. Build & Analyze a Section Example]]</h2>
<!--        subSECTION 1        -->
<!--        4 COLUMNS        -->
{| style="margin:0; background:none;"
<!--        Column 1  image    -->
|  style="margin:0; style="width:25%; border:1px solid #red; background:#white; vertical-align:top;" |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" |
|-
| style="color:#000;" | <div>
[[File:Example9_figure1.GIF|link=OpenSees Example 9. Section Build & Analysis Example]]
</div>
|}
<!--        Column 2        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Objectives</strong>
|-
| style="color:#000;" | <div>
*defined section using uniaxial behavior (define moment-curvature curve) or
*define section using uniaxial materials (define stress-strain curve) in fiber section
</div>
|}
<!--        Column 3        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Models</strong>
|-
| style="color:#000;" | <div>
*Uniaxial Nonlinear section
*Fiber Steel W-section
*Fiber RC symmetric rectangular unconfined-concrete section
*Fiber RC symmetric rectangular unconfined & confined-concrete section
*Fiber RC generalized rectangular section
*Fiber RC generalized circular section
</div>
|}
<!--        Column 4        -->
| style="margin:0; width:25%; border:1px solid #red; background:#white; vertical-align:top; " |
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <strong>Analyses</strong>
|-
| style="color:#000;" | <div>
*2D static unidirectional moment-curvature analysis
*3D static unidirectional moment-curvature analysis
</div>
|}
|}
 
 
 
 
----
Return to [[OpenSees User]]

Latest revision as of 17:49, 11 January 2011

Introduction

The examples in this manual are listed in order of simplicity.

NOTE: gravity analysis is always included as part of the model building

Models

The following types of models are represented in these examples:

Elastic Elements

OpenSees Elastic Beam Column Element
The elastic, uncoupled, axial and flexural stiffnesses are defined at the element level
user specifies: E,I,A

Inelastic Elements

OpenSees Force-Based Beam-Column Element
Two types of sections

Uniaxial Section

The inelastic, uncoupled, axial and flexural stiffnesses are defined at the section level
The OpenSees Uniaxial Section Command is used
User specifies:
Axial stiffness A
Section Moment-Curvature characteristics via the OpenSees UniaxialMaterial Command

Fiber Section

The section is broken down into fibers where uniaxial materials are defined independently.
The program calculates the coupled flexural and axial stiffnesses/strength by integrating strains across the section
The OpenSees Fiber Section Command is used
User specifies
Stress-Strain characteristics via the OpenSees UniaxialMaterial Command for all number of materials
Section geometry via series of Patches and Layers in the fiber section
Two Section Geometries are presented
*RC Rectangular Section
*Standard AISC W section

Lateral Loads

The following types of lateral loads are represented in these examples:

Static Pushover

Control node is located at the highest floor
Lateral-load distribution is proportional the the mass distribution along the height of the building
Static analysis
Two types

Monotonic Pushover

One-directional displacement-controlled static lateral loading

Reversed Cyclic Pushover

One-directional displacement-controlled static lateral loading
Displacement cycles are imposed in positive and negative direction

Time-Dependent Dynamic Loads

Transient analysis
Four types

Uniform Sine-Wave

Sine-wave acceleration input
Same acceleration input at all nodes restrained in specified direction

Multiple-Support Sine-Wave

Sine-wave displacement input
Different displacements are specified at particular nodes in specified directions

Uniform Earthquake

Earthquake (from file) acceleration input
Same acceleration input at all nodes restrained in specified direction

Multiple-Support Earthquake

Earthquake (from file) displacement input
Different displacements are specified at particular nodes in specified direction

Bidirectional Earthquake

Different inputs are specified for two directions
Same acceleration input at all nodes restrained in specified direction

Simulation Process

Each example script does the following:

Build the model

  1. model dimensions and degrees-of-freedom
  2. nodal coordinates
  3. nodal constraints -- boundary conditions
  4. nodal masses
  5. elements and element connectivity
  6. recorders for output

Define & apply gravity load

  1. nodal or element load
  2. static-analysis parameters (tolerances & load increments)
  3. analyze
  4. hold gravity loads constant
  5. reset time to zero

Define and apply lateral load

  1. load pattern (nodal loads for static analysis, support ground motion for earthquake)
  2. lateral-analysis parameters (tolerances & displacement/time increments)
    • Static Lateral-Load Analysis
      • define the displacement increments and displacement path
    • Dynamic Lateral-Load Analysis
      • define the input motion and all associated parameters, such as scaling and input type
      • define analysis duration and time increment
      • define damping
  3. analyze



Introductory Examples

The objective of Example 1a and Example 1b is to give an overview of input-file format in OpenSees using simple scripts.
These scripts do not take advantage of the Tcl scripting capabilities shown in the later examples. However, they do provide starting a place where the input file is similar to that of more familiar Finite-Element Analysis software. Subsequent examples should be used as the basis for user input files.

OpenSees Example 1a. 2D Elastic Cantilever Column

Objectives
  • overview of basic OpenSees input structure
  • coordinates, boundary conditions, element connectivity, nodal masses, nodal loads, etc.
  • two-node, one element
Models
  • elastic elements
Analyses
  • static pushover
  • dynamic earthquake-input

OpenSees Example 1b. Elastic Portal Frame

Objectives
  • two element types
  • distributed element loads
Models
  • elastic elements
Analyses
  • static pushover
  • dynamic earthquake-input



Simple Examples of Nonlinear-Models

OpenSees Example 2a. Elastic Cantilever Column with variables

Objectives
  • introduce variable: define & use
Models
  • elastic element
Analyses
  • static pushover
  • dynamic earthquake-input

OpenSees Example 2b. Nonlinear Cantilever Column: Uniaxial Inelastic Section

Objectives
  • first example of nonlinear model, set nonlinearity at section level
Models
  • nonlinearBeamColumn element
  • uniaxial section
Analyses
  • static pushover
  • dynamic earthquake-input

OpenSees Example 2c. Nonlinear Cantilever Column: Inelastic Uniaxial Materials in Fiber Section

Objectives
  • set nonlinearity at material level
  • material stress-strain response is assembled into fiber section
  • reinforced-concrete fiber section
Models
  • nonlinearBeamColumn element
  • uniaxial material
  • fiber section (Reinforced-concrete fiber section)
Analyses
  • static pushover
  • dynamic earthquake-input


2D Structural Modeling & Analysis Examples

These examples take advantage of the Tcl scripting language starting from simple variable substitutions in the initial examples, to the more advanced techniques of array management and logical expressions (if-then statements).

OpenSees Example 3. Cantilever Column with units

Objectives
  • units, defined and used (they will be used in all subsequent examples)
  • separate model-building and analysis files
  • introduce PDelta effects (or not)
Models
  • elastic elements
  • inelastic uniaxial section
  • fiber section (Reinforced-concrete fiber section)
  • Linear, PDelta or Corotational Transformation
Analyses
  • static pushover
  • dynamic earthquake-input

OpenSees Example 4. Portal Frame

Objectives
  • use previously-defined procedures to simplify input
  • introduce more analysis types
  • introduce procedure to read database input motion files (data with text in first lines)
Models
  • elastic elements
  • inelastic uniaxial section
  • inelastic fiber section (Reinforced-concrete fiber section)
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)

OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section

Objectives
  • 2D frame of fixed geometry: 3-story, 3-bay
  • nodes and elements are defined manually, one by one
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • elastic uniaxial section
  • inelastic uniaxial section
  • inelastic fiber section
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)

OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section

Objectives
  • 2D frame geometry of variable geometry ( # stories and # bays are variables)
  • node and element definition is automated
  • use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 2D
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • elastic uniaxial section
  • inelastic uniaxial section
  • inelastic fiber section
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)

OpenSees Example 5. 2D Frame, 3-story 3-bay, Reinforced-Concrete Section & Steel W-Section

Objectives
  • 2D frame of fixed geometry: 3-story, 3-bay
  • nodes and elements are defined manually, one by one
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • elastic uniaxial section
  • inelastic uniaxial section
  • inelastic fiber section
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)

OpenSees Example 6. generic 2D Frame, N-story N-bay, Reinforced-Concrete Section & Steel W-Section

Objectives
  • 2D frame geometry of variable geometry ( # stories and # bays are variables)
  • node and element definition is automated
  • use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 2D
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • elastic uniaxial section
  • inelastic uniaxial section
  • inelastic fiber section
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)


3D Structural Modeling & Analysis Examples

A few items are new in 3D:

  • Additional coordinates need to be considered in defining nodes
  • Additional degrees of freedom need to be considered in defining the following:
    • nodal constraints (boundary conditions)
    • nodal masses
    • nodal loads
  • The transformation from local element/section coordinates to global system coordinates needs to be specified
  • Element loads are specified in local coordinates
  • Additional arguments are required for many elements (bending about local-y axis) properties
  • Element/Section torsional stiffness needs to be considered
  • Rigid floor diaphragms need be included for building models


OpenSees Example 7. 3D Frame, 3-story 3-bayX 3-bayZ, Reinforced-Concrete Section & Steel W-Section

Objectives
  • 3D frame of fixed geometry
  • nodes and elements are manually manually, one by one
  • introduce rigid floor diaphragm
  • use previously-defined procedures to view model node numbers and elements, deformed shape, and displacement history, in 3D
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • Elastic or Fiber Section option is a variable within one input file
  • rigid diaphragm
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)

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

Objectives
  • 3D frame geometry of variable geometry ( # stories and # bays in X and Z are variables)
  • node and element definition is automated
  • introduce user-input interface, the user is given the option as to what to view in model
Models
  • Reinforced-Concrete Section
  • Steel W-Section
  • Elastic or Fiber Section option is a variable within one input file
  • optional rigid diaphragm
Analyses
  • static reversed cyclic analysis
  • dynamic sine-wave input analysis (uniform excitation)
  • dynamic earthquake-input analysis (uniform excitation)
  • dynamic sine-wave input analysis (multiple-support excitation)
  • dynamic earthquake-input analysis (multiple-support excitation)
  • dynamic bidirectional earthquake-input analysis (uniform excitation)



Section Modeling And Analysis Examples

OpenSees Example 9. Build & Analyze a Section Example

Objectives
  • defined section using uniaxial behavior (define moment-curvature curve) or
  • define section using uniaxial materials (define stress-strain curve) in fiber section
Models
  • Uniaxial Nonlinear section
  • Fiber Steel W-section
  • Fiber RC symmetric rectangular unconfined-concrete section
  • Fiber RC symmetric rectangular unconfined & confined-concrete section
  • Fiber RC generalized rectangular section
  • Fiber RC generalized circular section
Analyses
  • 2D static unidirectional moment-curvature analysis
  • 3D static unidirectional moment-curvature analysis




Return to OpenSees User