Earthquake Engineering Software tools

Dynamic analysis of single-degree-of-freedom systems (DYANAS):

a graphical user interface for OpenSees

by Georgios Baltzopoulos, Roberto Baraschino, Iunio Iervolino and Dimitrios Vamvatsikos

Download DYANAS
(this version requires MATHWORKS MATLAB^® installed on your computer, see below for the standalone UI version)

Requirements

· MATHWORKS MATLAB^® version 2015a or newer installed

Toolboxes required:

- Curve Fitting Toolbox (3.5.1)

- Statistics and Machine Learning Toolbox (10.0)

· OpenSees version 2.5.0 or newer: executable present in the directory [...]\DYANAS\osees\

· TCL/TK installed

Installing and running DYANAS

1. Copy (unzip) the DYANAS folder and subfolders to a non-system location on your drive (make sure there are no spaces in the path name).

2. Go to the directory [...]\DYANAS\osees\ and replace the file "opensees_exe.txt" with the

OpenSees executable file "opensees.exe", downloadable from http://opensees.berkeley.edu/

3. Install tcl/tk according to the instructions found in the OpenSees download page .

4. Start MATLAB and make the [...]\DYANAS\ directory the working folder.

5. Open "main_GUI.m" in MATLAB and run it.

6. The main DYANAS graphical user interface will appear. MATLAB must remain in the initial

working directory of DYANAS for the GUI to be responsive to the user.

▲

▼

Standalone version of DYANAS

This version contains all MATLAB^® code compiled into an executable file, and thus does not require a MATHWORKS MATLAB^®installation to run (it does require installation of the appropriate MATLAB runtime compiler though). Use this alternative if the DYANAS graphical interface exhibits some incompatibility with your version of MATLAB.

Download DYANAS standalone installer
(I am aware that newer versions of Windows will flag the installer as dangerous software because the executable file was built with more-than-a-decade old version of MATLAB compiler, you will just have to insist that you know it to be safe!)

Requirements

· MATLAB^® RUNTIME version 8.5 (R2015a) installed

· OpenSees version 2.5.0 or newer: executable present in the directory [...]\DYANAS\osees\ ^*

· TCL/TK installed (don’t worry about this if you are running newer versions of OpenSees that include TCL/TK in the installation package) ^*

Installing and running DYANAS standalone

1. Run the installer (DYANAS_setup.exe) and follow the installation instructions. For the installation path, make sure to select a non-system location on your drive that contains no spaces in the folder/subfolder names).

2. Go to the directory [...]\DYANAS\osees\ and replace the file "opensees_exe.txt" with the

OpenSees executable file "opensees.exe", downloadable from http://opensees.berkeley.edu/ ^*

3. Install tcl/tk according to the instructions found in the OpenSees download page . ^*

4. Download and install MATLAB runtime 8.5 (R2015a) available at the MATHWORKS website.

5. Run "DYANAS.exe". In WINDOWS environment, right click the DYANAS icon and select run as administrator.

* You will notice that, in the instructions above, the user is advised to make a separate installation of TCL/TK language. This is no longer needed in newer versions of OpenSees (the TCL/TK package is automatically installed along with the OpenSees executable). These instructions will be kept in place, since some of us want to go back and use older compiled versions of OpenSees for a variety of reasons. Here is a slightly modified version of the instructions to be used with the newer versions of OpenSees:

2. Download and install OpenSees from http://opensees.berkeley.edu/ . You will notice that the OpenSees directory contains two subdirectories \bin and \lib.

3. Go to the directory [...]\DYANAS\osees\ and replace the file "opensees_exe.txt" with the OpenSees files found in the [...]\OpenSees3.8.x\bin\ folder, which should include the executable file "opensees.exe"

4. Copy the entire directory [...]\OpenSees3.8.x\lib\ into the [...]\DYANAS\osees\ directory. This means you should now have a [...]\DYANAS\osees\lib\ directory.

5. Download and install MATLAB runtime 8.5 (R2015a) available at the MATHWORKS website.

6. Run "DYANAS.exe". In WINDOWS environment, right click the DYANAS icon and select run as administrator.

DYANAS is a MATHWORKS MATLAB^®-based graphical user interface that uses the OpenSees finite element platform to perform nonlinear dynamic analysis of single-degree-of-freedom (SDOF) oscillators. The scope of this open-source software is to serve as a tool for earthquake engineering research.

The main advantages offered by the interface are ease in the definition of the required analysis parameters and corresponding seismic input, efficient execution of the analyses themselves and availability of a suite of convenient, in-built post-processing tools for the management and organization of the structural responses.

The types of dynamic analysis frameworks supported are incremental, multiple-stripe and cloud.

UPDATE 1/04/2026

Did some housekeeping, focused on updating defunt links with working versions and also updating the installation instructions!

UPDATE 26/12/2020

Fixed some issue with intensity measure conversions from spectral acceleration to S_avg in the case of bi-directional motion (two uncoupled systems case).

UPDATE 12/08/2019

Fixed some issues with DYANAS standalone reading output files in windows 10. Output text files are now compatible with and can be read directly by R2R-EU, that can fit fragility functions, integrate with hazard and quantify estimation uncertainty of failure rates.

UPDATE 24/12/2018

BUGFIX: Fixed an issue with DYANAS standalone that sometimes led B2B IDA to get stuck in postprocessing.

UPDATE 23/11/2018

In this update two extra features were implemented in DYANAS:

· The possibility of exporting the displacement response-history into a text file and matlab figure directly from the GUI after each “single-run dynamic” analysis was added.

· Inserting more than one period value in the IM definition box (separated by spaces or commas, e.g., 0.5 1.0 2.0) allows the selection of average spectral acceleration S_avg as IM, defined as the geometric average of spectral acceleration at the selected periods: .