BuildingTcl: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(30 intermediate revisions by one other user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
<big>
'''BuildingTcl''' is a library of Tcl procedures (commands) used to build a database for numerical simulation of building frames. Structural model, loading and analysis data are included in this database. Additional procedures are available to perform the numerical simulation using OpenSees.


'''BuildingTclViewer''' is a Tcl/Tk widget (program) that provides a graphical user interface to view the BuildingTcl database, run the numerical simulations using OpenSees interactively, and view the results interactively.* Generate numerical-simulation input in a manner consistent with architectural/structural drawings
<!--        INTRODUCTION        -->
</big>
{| style="width:100%; vertical-align:top; border:1px solid #black; background:#white;"
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
<big><big>Introduction</big></big></h1>
|-
| style="color:#000;" | <div style="padding:2px 5px">
'''BuildingTcl''' is a library of Tcl procedures (commands) used to build a database for numerical simulation of building frames. Structural materials, sections, elements, models, analyses, loads and load combinations created in this database. Structural models can be Elevations, Plans, or 3DModels, which combine elevations and plans. Procedures are included to perform the numerical simulation using OpenSees. The OpenSees recorder data is post-processed into more accessible format.
 
'''BuildingTclViewer''' is a Tcl/Tk widget (program) that provides a graphical user interface to create the BuildingTcl database interactively, run the numerical simulations using OpenSees interactively, and view the results interactively.
 
The user can
* build a simulation-model library via scripting modules or interactively
 
* run simulations via scripting modules or interactively
 
* visualize real-time structural response during numerical simulation
 
* visualize results interactively.
 
 
 
While BuildingTcl and BuildingTclViewer were developed on a Windows platform, they can be made to work on other platforms, even Mac.
 
 
 
</div>
|}
<!--        OBJECTIVES        -->
<!--        OBJECTIVES        -->
{| style="width:100%; vertical-align:top; border:1px solid #black; background:#white;"
{| style="width:100%; vertical-align:top; border:1px solid #black; background:#white;"
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
<big>Objectives</big></h1>
<big><big>Objectives</big></big></h1>
|-
|-
| style="color:#000;" | <div style="padding:2px 5px">
| style="color:#000;" | <div style="padding:2px 5px">
* Generate numerical-simulation input in a manner consistent with architectural/structural drawings
* Create a database of all structure and simulation data
* Create a database of all structure and simulation data
* The implementation of OpenSees to do the analysis is natural here, but not restrictive
* The implementation of OpenSees to do the analysis is natural here, but not restrictive
Line 18: Line 42:
<!--        BUILDINGTCL AND BUILDINGTCLVIEWER        -->
<!--        BUILDINGTCL AND BUILDINGTCLVIEWER        -->
{| style="margin:0; background:none;"
{| style="margin:0; background:none;"
| style="width:55%; border:1px solid #black; background:#white; vertical-align:top; color:#000;" |
| style="width:50%; border:1px solid #black; background:#white; vertical-align:top; color:#000;" |
{| style="width:100%; vertical-align:top; background:#white;"
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
[[Image:BuildingTclLogo.gif]]
[[Image:BuildingTclLogo.gif|link=BuildingTcl Documentation]]</h1>
</h1>
|-
|-
| style="color:#000;" | <div style="padding:2px 5px">
| style="color:#000;" | <div style="padding:2px 5px">
Line 43: Line 66:
*Post-Process OpenSees recorder output into formatted data
*Post-Process OpenSees recorder output into formatted data
*Generate OpenSees input files
*Generate OpenSees input files
[[BuildingTcl Documentation | more ...]]
</div>
</div>
|-
|-
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
</h1>
</h1>
|-
|-
Line 52: Line 76:
| style="border:1px solid transparent;" |
| style="border:1px solid transparent;" |
<!--        BUILGINTCLVIEWER        -->
<!--        BUILGINTCLVIEWER        -->
| style="width:45%; border:1px solid #black; background:#white; vertical-align:top;"|
| style="width:50%; border:1px solid #black; background:#white; vertical-align:top;"|
{|  style="width:100%; vertical-align:top; background:#white;"
{|  style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3b0bf; text-align:left; color:#000; padding:0.2em 0.4em;">[[Image:BuildingTclViewerLogo.gif]]</h1>
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
[[Image:BuildingTclViewerLogo.gif|link=BuildingTclViewer Documentation]]</h1>
|-
|-
| style="color:#000;padding:2px 5px" | <div >
| style="color:#000;padding:2px 5px" | <div >
Line 65: Line 90:
*Visualize simulation results interactively
*Visualize simulation results interactively
*Export simulation results
*Export simulation results
[[BuildingTclViewer Documentation | more ...]]
</div>
</div>
|-
|-
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3b0bf; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
</h1>
</h1>
|-
|-
Line 76: Line 102:
<!--        DOCUMENTATION & TCL/TK      -->
<!--        DOCUMENTATION & TCL/TK      -->
{| style="margin:0; background:none;"
{| style="margin:0; background:none;"
| style="width:55%; border:1px solid #black; background:#white; vertical-align:top; color:#000;" |
| style="width:50%; border:1px solid #black; background:#white; vertical-align:top; color:#000;" |
{| style="width:100%; vertical-align:top; background:#white;"
{| style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
<big>Documentation</big>
<big><big>Documentation</big></big></h1>
</h1>
|-
|-
| style="color:#000;" | <div style="padding:2px 5px">
| style="color:#000;" | <div style="padding:2px 5px">
* [[BuildingTcl Installation Instructions]]
* [[BuildingTcl & BuildingTclViewer Installation Instructions]]
* [[Getting Started with BuildingTcl]]
* [[BuildingTcl & BuildingTclViewer -- How to Run]]
* [[BuildingTcl Command Language Manual]]
* [[BuildingTcl Documentation]]
** [[Getting Started with BuildingTcl]]
** [[BuildingTcl Command Language Manual]]
* [[BuildingTclViewer Documentation]]
</div>
</div>
|-
|-
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
</h1>
</h1>
|-
|-
Line 95: Line 123:
| style="border:1px solid transparent;" |
| style="border:1px solid transparent;" |
<!--        TCL/TK        -->
<!--        TCL/TK        -->
| style="width:45%; border:1px solid #black; background:#white; vertical-align:top;"|
| style="width:50%; border:1px solid #black; background:#white; vertical-align:top;"|
{|  style="width:100%; vertical-align:top; background:#white;"
{|  style="width:100%; vertical-align:top; background:#white;"
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3b0bf; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
<big>Tcl/Tk</big></h1>
<big><big>Tcl/Tk</big></big></h1>
|-
|-
| style="color:#000;padding:2px 5px" | <div >
| style="color:#000;padding:2px 5px" | <div >
Line 106: Line 134:
</div>
</div>
|-
|-
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3b0bf; text-align:left; color:#000; padding:0.2em 0.4em;">
! style="padding:2px" | <h1  style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">


</h1>
</h1>
Line 117: Line 145:
<!--        DOWNLOAD        -->
<!--        DOWNLOAD        -->
{| style="width:100%; vertical-align:top; border:1px solid #black; background:#white;"
{| style="width:100%; vertical-align:top; border:1px solid #black; background:#white;"
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #a3bfb1; text-align:left; color:#000; padding:0.2em 0.4em;"><big>
! style="padding:2px" | <h1 style="margin:3px; background:white; font-size:120%; font-weight:bold; border:1px solid #black; text-align:left; color:#000; padding:0.2em 0.4em;">
[http://neesforge.nees.org/projects/buildingtcl/ Download] from NEESforge
<big><big>Download</big></big></h1>
</big></h1>
|-
|-
| style="color:#000;" | <div style="padding:2px 5px">
| style="color:#000;" | <div style="padding:2px 5px">
</div>
</div>
|}
|}
The BuildingTcl software is now stored using Apache Subversion (SVN) software. SVN provides the means to store not only the current version of a piece of source code,
but a record of all changes (and who
made those changes) that have occurred to that source code. Use of SVN
is particularly common on projects with multiple developers, since SVN
ensures changes made by one developer are not accidentally removed when
another developer posts their changes to the source tree.
SVN Access
This project can be checked out through anonymous access with the following command (use the dos prompt if
on a windows machine).
<PRE>
svn co svn://opensees.berkeley.edu/usr/local/svn/BuildingTcl/trunk BuildingTcl                           
</PRE>
Users of Windows machines are encouraged to look at [http://tortoisesvn.tigris.org/ TortoiseSVN]

Latest revision as of 20:00, 9 November 2010


Introduction

BuildingTcl is a library of Tcl procedures (commands) used to build a database for numerical simulation of building frames. Structural materials, sections, elements, models, analyses, loads and load combinations created in this database. Structural models can be Elevations, Plans, or 3DModels, which combine elevations and plans. Procedures are included to perform the numerical simulation using OpenSees. The OpenSees recorder data is post-processed into more accessible format.

BuildingTclViewer is a Tcl/Tk widget (program) that provides a graphical user interface to create the BuildingTcl database interactively, run the numerical simulations using OpenSees interactively, and view the results interactively.

The user can

  • build a simulation-model library via scripting modules or interactively
  • run simulations via scripting modules or interactively
  • visualize real-time structural response during numerical simulation
  • visualize results interactively.


While BuildingTcl and BuildingTclViewer were developed on a Windows platform, they can be made to work on other platforms, even Mac.


Objectives

  • Generate numerical-simulation input in a manner consistent with architectural/structural drawings
  • Create a database of all structure and simulation data
  • The implementation of OpenSees to do the analysis is natural here, but not restrictive
  • Be able to run on a number of platforms, just as OpenSees can

  • High-level scripting tool
  • Generate building-model data
Materials
Sections
Element Types
Analysis Models
Loads (Gravity & Lateral)
Load Combinations
Models
Elevations
Plan
3D Frames
  • Generate analysis-model data
  • Generate loading and load-combination data
  • Create OpenSees model of building
  • Perform OpenSees numerical simulations
  • Post-Process OpenSees recorder output into formatted data
  • Generate OpenSees input files

more ...

  • Graphical User Interface (GUI) for BuildingTcl
  • Generate and/or visualize ALL BuildingTcl input graphically
  • Save ALL input into BuildingTcl script
  • Perform numerical simulations using OpenSees interactively
  • Visualize OpenSees simulation real-time
  • Pause and/or stop OpenSees analysis real-time
  • Visualize simulation results interactively
  • Export simulation results

more ...

Documentation

Tcl/Tk

  • Tcl is the scripting language used by OpenSees.exe. It runs on Windows, Unix and Macintosh platforms.
  • Tk is the graphical user interface toolkit associated with Tcl.
  • Tcl/Tk Commands

Download

The BuildingTcl software is now stored using Apache Subversion (SVN) software. SVN provides the means to store not only the current version of a piece of source code, but a record of all changes (and who made those changes) that have occurred to that source code. Use of SVN is particularly common on projects with multiple developers, since SVN ensures changes made by one developer are not accidentally removed when another developer posts their changes to the source tree.

SVN Access

This project can be checked out through anonymous access with the following command (use the dos prompt if on a windows machine).


svn co svn://opensees.berkeley.edu/usr/local/svn/BuildingTcl/trunk BuildingTcl                            

Users of Windows machines are encouraged to look at TortoiseSVN