Opensees_MDOF_Animator

Opensees_MDOF_Animator is a Python-based visualization tool designed to animate and analyze the structural response of multi-degree-of-freedom (MDOF) systems using simulation output files generated by OpenSees.

Note: This tool does not create or write OpenSees models (.tcl files). It only reads OpenSees-generated output (.out) files and visualizes the structural response through dynamic animations and plots.

Included Example

This repository includes example .out files from a 22-story OpenSees simulation so that you can:

• Directly test the animator without running OpenSees
• Understand the expected file format
• Replicate the input/output structure in your own projects

Features

• Animated deformation of MDOF structures
• Floor-by-floor displacement profiles
• Live roof trace and story tracking
• Base shear force plot
• Soil spring force-displacement hysteresis loop
• Spline-smoothed deformation curves for clear visualization

Requirements

• Python 3.x
• Libraries:
  • numpy
  • matplotlib
  • scipy

Install them with:

pip install numpy matplotlib scipy

How to Use

1. Clone or download the repository
2. Ensure all required .out files are in the same folder as MDOF.py
3. Run the script:

   python MDOF.py

4. The animation window will display:
   • Deformation profile of the structure
   • Roof displacement over time
   • Base shear force
   • Soil spring hysteresis

Required Output Files

The script expects the following output files:

File Name	Description
roof_disp.out	Roof node displacement (time vs displacement)
base_disp.out	Base node displacement
base_force.out	Base shear force
soil_disp.out	Soil node displacement
soil_force.out	Soil force from spring/damper

Use Case

• Seismic response analysis of MDOF systems
• Visualization of structural optimization results
• Soil-structure interaction studies
• Educational demos for students and researchers

Developer Info

• Developer: Engr. Tufail Mabood
• Contact: WhatsApp
• Note: Example files are included for demonstration purposes. You can replace them with your own OpenSees output files to visualize your simulations.

License

This project is licensed under the MIT License. You may freely use, modify, and redistribute it. Please consider crediting the author if it helps your work or research.