Getting Started with BuildingTcl
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 lang="Tcl"> source myBuildingTcl.tcl
<setDataDir Data>
<setUnits -Length $BasicLengthUnit -Force $BasicForceUnit -Time BasicTimeUnit> <source>
- DEFINE INPUT DATA
addMaterialData …..
addMaterial ; # define Materials Library
addSectionData …..
addSection; # define Section Library
addElementModelData …..
addElementModel; # define ElementModel Library
addAnalysisModelData …..
addAnalysisModel; # define AnalysisModel Library
addModelData …..
addModel; # define Model (Elevation, Plan, 3DModel) Library
addLoadData ….. addLoad; # define Loads Library
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
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 OpenSees 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 Combiantions
GettingStartedInputFile.tcl -– Run