Simulation Wiki Tutorial - Running OpenSees on the NEEShub using the OpenSees Laboratory Tool

Tutorial – Running OpenSees on the NEEShub using the OpenSees Laboratory Tool


We can run our OpenSees simulations on the NEESHub in the same way we run them our personal computer. We can use the command line to input the simulation source code line by line or we can upload a source file. This short tutorial is for users that know how to use OpenSees and would like to know how to run OpenSees simulations on the NEEShub using the OpenSees Laboratory tool.

Get a NEEShub account

To run simulations on the NEEShub, you will need a NEEShub account. If you do not already have one, you can register for one here.

Locating and Launching OpenSees Laboratory

The first step in running simulations on the NEEShub to locate and launch the OpenSees Laboratory tool. You can access the OpenSees Laboratory tool page through the Tools & Resources > Tools menu here


or through the Simulation > Programs menu here.


On the OpenSees Laboratory tool page, click on the Launch Tool button to start the OpenSees Laboratory tool.


Submitting an OpenSees job

You can submit OpenSees simulations in two ways: 1) you can input your source code at the command line of the OpenSees application or 2) you can upload a source file.

Uploading a source file is generally the preferable option. To upload a source file, select the File Transfer option in the Pop-menu of the OpenSees Laboratory tool. Note that you must have popups enabled.


On the file transfer screen, select the Upload option, and then use the Choose File button to browse to the location of your source (.tcl) file.


Once your source file is uploaded, use the Pop-menu to go to the OpenSees Interpreter.


Through the OpenSees Interpreter, you can use OpenSees as you would on your local PC. For example, you can type the dir command and there you will be able to locate the source file you just uploaded. You can run your source file by typing source filename, where filename refers to your source file.


Any action that you could normally perform in OpenSees on your PC can be performed through the OpenSees Interpreter. For example, you can use the command eigen to get eigenvalues of the model, and use the proper operations (valid TCL operations) to convert the eigenvalues into natural frequencies.


Returning to OpenSees after First Use

You can keep your OpenSees Laboratory tool sessions and return to them at a later time. To keep your session click the Keep for later button in the top right corner of the tool window.


Any sessions that you keep will be listed on your My NEEShub dashboard and can be resumed at a later time. Note that your dashboard may be organized differently than the dashboard depicted below.


Additional Functions

The OpenSees Laboratory tool contains additional functionality that is not discussed in this tutorial. For example, it can be used to batchsubmit commands for parallel job submission or to perform certain basic types of analyses such as site response analyses or SDOF earthquake analyses. If you have questions about the use of these additional functions, please submit a support ticket.

Created on , Last modified on