Welcome to the OpenQuake Vulnerability Modeller’s Toolkit’s documentation!

The OpenQuake Vulnerability Modellers Toolkit (oq-vmtk) is an open source library that provides an OpenSeesPy-based environment for modelling idealised building class models such as single (SDOF) and multi-degree-of-freedom (MDOF) systems and to carry out analysis via linear, nonlinear static, and nonlinear dynamic approaches for regional vulnerability and risk assessment applications. The vulnerability toolkit is developed by the Risk Team at the Global Earthquake Model (GEM) Foundation. Contributions from external users are very welcome!

The oq-vmtk code is hosted on GitHub at the following link: https://github.com/GEMScienceTools/oq-vmtk.

Currently, the oq-vmtk includes the following sub-modules:

• Intensity Measure Calculator (im_calculator): Contains code used for processing spectra and intensity measure types from ground-motion records.

• Intensity Measure Selection (im_selection): Contains code for evaluating and comparing intensity measures using information-theoretic sufficiency metrics.

• Model Calibration (calibration): Contains code used for calibrating MDOF models based on SDOF low-level parameters.

• Model Building and Analysis (modeller): Contains code used to compile SDOF and MDOF models in OpenSeesPy and run distinct analyses such as linear (i.e., modal analysis), nonlinear static (e.g., static pushovers), and nonlinear time-history analyses.

• Postprocessing (postprocessor): Contains code for postprocessing cloud and multiple stripe analyses to derive fragility and vulnerability models.

• Storey Loss Function Generator (slf_generator): Contains code for generating storey loss functions for a more refined loss assessment of building components.

• Visualisation (plotter): Contains code for visualizing and graphically interpreting oq-vmtk outputs.

Contents:

• 1. Installation
  • 1.1. Clone the Repository
  • 1.2. Set Up a Virtual Environment
  • 1.3. Install Dependencies
  • 1.4. Install the Package
• 2. Change Log
  • 2.1. v1.1.0 (in development)
  • 2.2. v1.0.0
• 3. Intensity Measure Calculation
  • 3.1. Initialisation
  • 3.2. Response Spectrum
  • 3.3. Spectral Acceleration
  • 3.4. Average Spectral Acceleration
  • 3.5. User-Defined Average Spectral Acceleration
  • 3.6. Velocity and Displacement History
  • 3.7. Amplitude Intensity Measures
  • 3.8. Arias Intensity
  • 3.9. Cumulative Absolute Velocity
  • 3.10. Significant Duration
  • 3.11. Filtered Incremental Velocity
  • 3.12. Orientation-Independent Spectral Acceleration (RotDxx)
  • 3.13. References
• 4. Intensity Measure Selection
  • 4.1. Initialisation
  • 4.2. Efficiency — Modified Cloud Analysis
  • 4.3. Efficiency — Incremental Dynamic Analysis
  • 4.4. Proficiency — Modified Cloud Analysis
  • 4.5. Proficiency — Incremental Dynamic Analysis
  • 4.6. Relative Score Method — Modified Cloud Analysis
  • 4.7. Relative Score Method — Incremental Dynamic Analysis
  • 4.8. Relative Score Method — General
  • 4.9. IM Comparison
  • 4.10. References
• 5. Model Calibration
  • 5.1. Initialisation
  • 5.2. SDOF-to-MDOF Calibration
  • 5.3. References
• 6. Model Building and Analysis
  • 6.1. Initialisation
  • 6.2. Model Compilation
  • 6.3. Model Visualisation
  • 6.4. Gravity Analysis
  • 6.5. Modal Analysis
  • 6.6. Static Pushover Analysis
  • 6.7. Nonlinear Time-History Analysis
  • 6.8. References
• 7. Postprocessing
  • 7.1. Initialisation
  • 7.2. Lognormal Fragility Functions
  • 7.3. Fragility Function Rotation
  • 7.4. GLM Fragility Functions
  • 7.5. Ordinal Fragility Functions
  • 7.6. Modified Cloud Analysis Postprocessing
  • 7.7. Incremental Dynamic Analysis Postprocessing
  • 7.8. Multiple Stripe Analysis Postprocessing
  • 7.9. Vulnerability Functions
  • 7.10. Average Annual Damage Probabilities
  • 7.11. Average Annual Loss
  • 7.12. References
• 8. Storey Loss Function Generation
  • 8.1. Initialisation
  • 8.2. SLF Generation
  • 8.3. References
• 9. Visualisation
  • 9.1. Modal Shapes
  • 9.2. Static Pushover Animation
  • 9.3. Cyclic Pushover Animation
  • 9.4. Nonlinear Time-History Animation
  • 9.5. MCA Results
  • 9.6. IDA Results
  • 9.7. MSA Results
  • 9.8. Fragility Functions from MCA
  • 9.9. Fragility Functions from IDA
  • 9.10. Fragility Functions from MSA
  • 9.11. Storey Loss Functions
  • 9.12. Vulnerability Functions
• 10. Examples
  • 10.1. Intensity Measure Processing
  • 10.2. Intensity Measure Selection
  • 10.3. Model Compilation
  • 10.4. Modal Analysis
  • 10.5. Pushover Analysis
  • 10.6. Nonlinear Time-History Analysis
  • 10.7. Modified Cloud Analysis
  • 10.8. Multiple Stripe Analysis
  • 10.9. Incremental Dynamic Analysis
  • 10.10. Fragility Analysis
  • 10.11. Storey Loss Function Generation
  • 10.12. Storey Loss Function Application

Indices and tables

• Index

• Module Index

• Search Page