OQ-VMTK Release v1.1.0

[mouayed-nafeh]

Summary

This pull request addresses the major revisions requested during the anonymous review process for the Earthquake Spectra submission. The changes focus on improving code quality, extending analysis capabilities, enhancing documentation, and strengthening verification and testing workflows across the OQ-VMTK framework.

Main Changes

Codebase Refactoring

• Refactored the OQ-VMTK source code and demo scripts to comply with PEP8 standards using autopep8 and black formatting tools integrated through VS Code extensions.
• Restructured Jupyter notebook demonstrations for improved readability, consistency, and usability.

Intensity Measure Selection

• Implemented a new imselection method for identifying the optimal intensity measure (IM) from multiple candidates based on:

  • efficiency,
  • relative sufficiency, and
  • practicality criteria.

Documentation Improvements

• Refactored and expanded the online documentation to reflect the updated code structure.
• Added self-contained minimal working examples for each implemented method and workflow.

Visualization and Animation Features

• Added animation support for graphical interpretation of:

  • static pushover analysis,
  • cyclic pushover analysis, and
  • nonlinear time-history analysis.

Modal Analysis Reporting

• Implemented a graphical modal analysis report to illustrate the modal properties of idealized building classes for verification and validation purposes.

Analysis Framework Extensions

• Expanded the modeller analysis wrappers to support:

  • incremental dynamic analysis (IDA),
  • registration of additional global and local response quantities, including hysteretic energy metrics.

Postprocessing Enhancements

• Extended the postprocessor module to support multiple dynamic assessment procedures, including:

  • Modified Cloud Analysis,
  • Multiple Stripe Analysis (MSA), and
  • Incremental Dynamic Analysis (IDA),
    together with their associated fragility fitting strategies.

Testing and Quality Assurance

• Added unit tests to improve reliability, regression checking, and overall quality assurance coverage.

Purpose

These updates collectively improve the maintainability, reproducibility, extensibility, and verification capabilities of the OQ-VMTK framework while directly addressing reviewer feedback for the Earthquake Spectra manuscript.