Getting Started with BuildingTcl: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
 
(29 intermediate revisions by the same user not shown)
Line 4: Line 4:


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
* SET UP
<source lang="Tcl">
<blockquote>
source myBuildingTcl.tcl
<source lang="Tcl">source myBuildingTcl.tcl
<setDataDir Data>
<setDataDir $DataDir>
<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time BasicTimeUnit>
<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time $BasicTimeUnit></source>
</source>
</blockquote>


* DEFINE INPUT DATA
* DEFINE INPUT DATA
<source lang="Tcl">
<blockquote>
addMaterialData …..
<source lang="Tcl"># define Materials Library
addMaterial ''; # define Materials Library''
addMaterialData  
addSectionData …..
addSection''; # define Section Library''
addMaterial
addElementModelData …..
 
addElementModel''; # define ElementModel Library''
# define Section Library
addAnalysisModelData …..
addSectionData  
addAnalysisModel''; # define AnalysisModel Library''
addModelData …..
addSection
addModel''; # define Model (Elevation, Plan, 3DModel) Library''
 
addLoadData ..
# define ElementModel Library
addLoad''; # define Loads Library''
addElementModelData  
addLoadCombinationData ..
addLoadCombination''; # define LoadCombination Library''
addElementModel''
</source >
 
# 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 Building-Tcl specific. They are used to run the OpenSees simulation.''
''The following commands are BuildingTcl-specific. They are used to run the OpenSees simulation.''
* BUILD AND ANALYZE
* BUILD AND ANALYZE
<source lang="Tcl">
<blockquote>
SelectModel …..
<source lang="Tcl">SelectModel …
SelectLoadCombination …..
SelectLoadCombination …..
BuildAndAnalyze
BuildAndAnalyze
</source>
</source>
 
</blockquote>


== Run BuildingTcl ==
== Run BuildingTcl ==
Line 45: Line 65:
:The BuildingTcl commands are used within OpenSees.exe or OpenSeesTk.exe.
:The BuildingTcl commands are used within OpenSees.exe or OpenSeesTk.exe.


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




Line 57: Line 77:
:Incorporates BuildingTcl & BuildingTclviewer commands into the Tcl/Tk Interpreter  
: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
:This file needs to be sourced from the OpenSeesTk.exe prompt, or by double-clicking on the BuildingTclViewer.bat file
1. Run from OpenSees Prompt:
;1. Run from OpenSeesTk Prompt:
a. Run OpenSeesTk.exe – a Tk window opens up (do not close it).
:a. Run OpenSeesTk.exe – a Tk window opens up (do not close it).
b. Source myBuildingTclviewer.tcl at the OpenSees prompt  
:b. Source myBuildingTclviewer.tcl at the OpenSees prompt  
:the Tk window becomes the BuildingTclviewer
::the Tk window becomes the BuildingTclviewer


Or
Or
2. Double-click on myBuildingTclviewer.bat
;2. Double-click on myBuildingTclviewer.bat
 
 


== Getting-Started Input File ==
== Getting-Started Input File ==
Line 85: Line 103:
:[[GettingStartedInputFile.tcl -– Lateral Loads]]
:[[GettingStartedInputFile.tcl -– Lateral Loads]]


:[[GettingStartedInputFile.tcl -– Load Combiantions]]
:[[GettingStartedInputFile.tcl -– Load Combinations]]
 
:[[GettingStartedInputFile.tcl -– Additional Models]]
 
:[[GettingStartedInputFile.tcl -– BuildAndAnalyze]]


:[[GettingStartedInputFile.tcl -– Run]]
:[[GettingStartedInputFile.tcl -– Run]]


== BuildingTclViewer Overview ==





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