Getting Started with BuildingTcl: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
 
(49 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
[[Image:BuildingTclLogo.gif|link=BuildingTcl|right]]
== BuildingTcl Commands ==
== BuildingTcl Commands ==


Most BuildingTcl Library commands consists of a series of parameter-defining add-Data commands, concluded by an add-Object command, which takes the previously defined parameters and assembles them into an individual library object.
Most BuildingTcl Library commands consists of a series of parameter-defining add-Data commands, concluded by an add-Object command, which takes the previously defined parameters and assembles them into an individual library object.
* SET UP
<blockquote>
<source lang="Tcl">source myBuildingTcl.tcl
<setDataDir $DataDir>
<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time $BasicTimeUnit></source>
</blockquote>
* DEFINE INPUT DATA
<blockquote>
<source lang="Tcl"># define Materials Library
addMaterialData
addMaterial 
# define Section Library
addSectionData
addSection
# define ElementModel Library
addElementModelData
addElementModel''
# define AnalysisModel Library
addAnalysisModelData
addAnalysisModel
# define Model (Elevation, Plan, 3DModel) Library
addModelData
addModel
# define Loads Library
addLoadData
addLoad
# define LoadCombination Library
addLoadCombinationData
addLoadCombination
</source>
</blockquote>
''The following commands are BuildingTcl-specific. They are used to run the OpenSees simulation.''
* BUILD AND ANALYZE
<blockquote>
<source lang="Tcl">SelectModel …
SelectLoadCombination …..
BuildAndAnalyze
</source>
</blockquote>
== Run BuildingTcl ==
* myBuildingTcl.tcl – no graphics
:Incorporates BuildingTcl commands into the Tcl Interpreter
:The BuildingTcl commands are used within OpenSees.exe or OpenSeesTk.exe.


* SET UP
;1. Run from OpenSees Prompt:
source myBuildingTcl.tcl
:a. Run OpenSees.exe or OpenSeesTk.exe
:b. Source myBuildingTcl.tcl at OpenSees prompt
:c. Source input and analysis files at OpenSees prompt


<setDataDir Data>


<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time BasicTimeUnit>


* DEFINE INPUT DATA
== Run BuildingTclViewer ==
addMaterialData …..


addMaterial ''; # define Materials Library''
*myBuildingTclviewer.tcl – BuildingTcl with graphical interface
:Incorporates BuildingTcl & BuildingTclviewer commands into the Tcl/Tk Interpreter
:This file needs to be sourced from the OpenSeesTk.exe prompt, or by double-clicking on the BuildingTclViewer.bat file
;1. Run from OpenSeesTk Prompt:
:a. Run OpenSeesTk.exe – a Tk window opens up (do not close it).
:b. Source myBuildingTclviewer.tcl at the OpenSees prompt
::the Tk window becomes the BuildingTclviewer


Or
;2. Double-click on myBuildingTclviewer.bat


addSectionData …..
== Getting-Started Input File ==


addSection''; # define Section Library''
This file contains all the input data for the building model and simulation. It can be used by both BuildingTcl and the BuildingTclViewer.


:[[GettingStartedInputFile.tcl -– Setup & Materials]]


addElementModelData …..
:[[GettingStartedInputFile.tcl -– Element Section]]


addElementModel''; # define ElementModel Library''
:[[GettingStartedInputFile.tcl -– Gravity Loads]]


:[[GettingStartedInputFile.tcl -– Model: Elevations]]


addAnalysisModelData …..
:[[GettingStartedInputFile.tcl -– Model: Plans]]


addAnalysisModel''; # define AnalysisModel Library''
:[[GettingStartedInputFile.tcl -– Model: 3DFrames]]


:[[GettingStartedInputFile.tcl -– Lateral Loads]]


addModelData …..
:[[GettingStartedInputFile.tcl -– Load Combinations]]


addModel''; # define Model (Elevation, Plan, 3DModel) Library''
:[[GettingStartedInputFile.tcl -– Additional Models]]


addLoadData …..
:[[GettingStartedInputFile.tcl -– BuildAndAnalyze]]
addLoad''; # define Loads Library''


:[[GettingStartedInputFile.tcl -– Run]]


addLoadCombinationData …..


addLoadCombination''; # define LoadCombination Library''


''The following commands are Building-Tcl specific. They are used to run the OpenSees simulation.''
* BUILD AND ANALYZE
SelectModel …..


SelectLoadCombination …..


BuildAndAnalyze
----

Latest revision as of 18:19, 28 December 2009

BuildingTcl Commands

Most BuildingTcl Library commands consists of a series of parameter-defining add-Data commands, concluded by an add-Object command, which takes the previously defined parameters and assembles them into an individual library object.

  • SET UP
source myBuildingTcl.tcl
<setDataDir $DataDir>
<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time $BasicTimeUnit>
  • DEFINE INPUT DATA
# define Materials Library
addMaterialData 
…
addMaterial  

# define Section Library
addSectionData 
…
addSection

# define ElementModel Library
addElementModelData 
…
addElementModel''

# define AnalysisModel Library
addAnalysisModelData 
…
addAnalysisModel

# define Model (Elevation, Plan, 3DModel) Library
addModelData 
…
addModel

# define Loads Library
addLoadData 
…
addLoad

# define LoadCombination Library
addLoadCombinationData 
…
addLoadCombination

The following commands are BuildingTcl-specific. They are used to run the OpenSees simulation.

  • BUILD AND ANALYZE
SelectModel …
SelectLoadCombination …..
BuildAndAnalyze

Run BuildingTcl

  • myBuildingTcl.tcl – no graphics
Incorporates BuildingTcl commands into the Tcl Interpreter
The BuildingTcl commands are used within OpenSees.exe or OpenSeesTk.exe.
1. Run from OpenSees Prompt
a. Run OpenSees.exe or OpenSeesTk.exe
b. Source myBuildingTcl.tcl at OpenSees prompt
c. Source input and analysis files at OpenSees prompt


Run BuildingTclViewer

  • myBuildingTclviewer.tcl – BuildingTcl with graphical interface
Incorporates BuildingTcl & BuildingTclviewer commands into the Tcl/Tk Interpreter
This file needs to be sourced from the OpenSeesTk.exe prompt, or by double-clicking on the BuildingTclViewer.bat file
1. Run from OpenSeesTk Prompt
a. Run OpenSeesTk.exe – a Tk window opens up (do not close it).
b. Source myBuildingTclviewer.tcl at the OpenSees prompt
the Tk window becomes the BuildingTclviewer

Or

2. Double-click on myBuildingTclviewer.bat

Getting-Started Input File

This file contains all the input data for the building model and simulation. It can be used by both BuildingTcl and the BuildingTclViewer.

GettingStartedInputFile.tcl -– Setup & Materials
GettingStartedInputFile.tcl -– Element Section
GettingStartedInputFile.tcl -– Gravity Loads
GettingStartedInputFile.tcl -– Model: Elevations
GettingStartedInputFile.tcl -– Model: Plans
GettingStartedInputFile.tcl -– Model: 3DFrames
GettingStartedInputFile.tcl -– Lateral Loads
GettingStartedInputFile.tcl -– Load Combinations
GettingStartedInputFile.tcl -– Additional Models
GettingStartedInputFile.tcl -– BuildAndAnalyze
GettingStartedInputFile.tcl -– Run