OpenSeesMatlab

OpenSeesMatlab is a MATLAB-based platform for structural analysis and simulation. It aims to provide powerful modeling, analysis, post-processing, and visualization tools for research and engineering applications in structural, earthquake, and geotechnical engineering.

Documentation

https://openseesmatlab.readthedocs.io/en/latest/

OpenSees Integration

OpenSeesMatlab leverages MATLAB's C++ mex interface to encapsulate the OpenSees engine, enabling seamless and interactive use of OpenSees directly within MATLAB. This allows users to:

• Run OpenSees commands and analyses natively in MATLAB scripts and functions
• Benefit from MATLAB's interactive environment for pre/post-processing and visualization
• Integrate OpenSees with MATLAB toolboxes and workflows

Installation

1. Go to the release directory and choose the version you want, for example release/3.8.0.0/. Download it.
2. Open this release directory in MATLAB, then install the toolbox package by running:

   installOpenSeesMatlab

After installation, explore and run example models in the examples/ directory (You need to use it as your working directory):

• Open any .mlx file in examples/ with MATLAB Live Editor, e.g.:
  • examples/earthquake_frame3D_transient.mlx
  • examples/structural_nonlinear_truss.mlx
  • examples/geotechnical_PM4Sand.mlx
  • examples/post_2d_Portal_Frame.mlx
• Click "Run" in MATLAB to execute and interact with the example.

Quick Start

Using OpenSeesMatlab is straightforward:

• The opensees module provides wrappers for almost all OpenSees commands, keeping the same parameter parsing style as OpenSees/OpenSeesPy.
• Modules such as vis, post, and pre extend functionality with visualization, post-processing, and preprocessing tools, which can be used as needed.

opsMat = OpenSeesMatlab();   % Get instance
ops = opsMat.opensees;       % Access OpenSees command interface

ops.wipe();
ops.model('basic', '-ndm', 2, '-ndf', 3);

ops.node(1, 0.0, 0.0);
ops.node(2, 5.0, 0.0);
ops.fix(1, 1, 1, 1);

A = 2.e-3;
Iz = 1.6e-5;
E = 200.e9;
ops.element('elasticBeamColumn', 1, 1, 2, A, E, Iz, 1)

...

opsMat.post.getModelData();  % Collect model data
opsMat.vis.plotModel();      % Visualize the model

🌟 Features

• 🧱 .opensees — MATLAB interface to OpenSees commands (fully compatible syntax), implemented via MATLAB MEX wrapping of the OpenSees C++ library
• 📊 .post — post-processing module for extracting, organizing, and exporting analysis results
• 🏗️ .pre — preprocessing tools for model definition, units, and data preparation
• 🎨 .vis — visualization engine for models, responses, and mode shapes
• 📈 .anlys — high-level analysis workflows and utilities
• 🛠️ .utils — auxiliary helper functions and common utilities

Requirements

MATLAB R2023a or later

Windows operating system (currently only supported on Windows)

For more detailed installation and usage instructions, see the documentation.

License

This project is licensed for academic research and personal use only. Commercial and closed-source use is prohibited. See the LICENSE file for details.