- 
+ 
Vulnerability Modeller's ToolKit (OQ-VMTK)
@@ -38,7 +39,7 @@
# ✨ Key Features
-The OQ-VMTK is a powerful toolkit developed by scientists at the Global Earthquake Model (GEM) Foundation. Designed for earthquake engineers and catastrophe modellers, it provides a comprehensive platform powered by OpenSees for running representative (idealised) models, developing fragility and vulnerability assessments, and offering extensive flexibility in defining seismic demand, structural capacity, damage criteria, and damage-to-loss conversion.
+The OQ-VMTK is a powerful toolkit developed by scientists at the Global Earthquake Model (GEM) Foundation. Designed for earthquake engineers and vulnerability modellers, it provides a comprehensive platform powered by OpenSees for running representative (idealised) models, developing fragility and vulnerability assessments, and offering extensive flexibility in defining seismic demand, structural capacity, damage criteria, and damage-to-loss conversion.
## 🏗️ Single- and Multi-Degree-of-Freedom Systems Calibration and Modeling
- Define structures with key attributes like storey count, first-mode transformation factors, and force-deformation relationships.
@@ -49,15 +50,15 @@ The OQ-VMTK is a powerful toolkit developed by scientists at the Global Earthqua
### 📊 Linear & Nonlinear Analysis
- **Modal Analysis:** Extract vibration periods and mode shapes with precision.
- **Gravity Analysis:** Perform gravity analysis and ensure system stability before running advanced simulations.
-- **Nonlinear Static Analyses:** Perform static and cyclic pushover tests to assess the system's lateral load resisting capacity, dissipated energy and other metrics.
-- **Nonlinear Time-History Analyses:** Simulate dynamic response of structures using ground-motion records and extract peak response quantities such as peak storey drifts, peak displacements and peak floor accelerations.
+- **Nonlinear Static Analyses:** Perform static and cyclic pushover tests to assess the system's lateral load-resisting capacity, energy dissipation and other metrics.
+- **Nonlinear Time-History Analyses:** Simulate dynamic response of structures using ground motion records and extract peak response quantities such as peak storey drifts, peak floor displacements and accelerations.
### 🌍 Seismic Fragility & Vulnerability Assessment
-- **Fragility Analysis:** Conduct probabilistic seismic demand modeling to establish relationships between engineering demand parameters (EDPs) and intensity measures (IMs) using nonlinear time-history analyses (e.g., cloud analysis, multiple stripe analyses). Estimate damage exceedance probabilities while accounting for record-to-record variability and modeling uncertainty. Multiple approaches are supported, including conventional methods (e.g., lognormal cumulative distribution functions) and advanced techniques (e.g., generalized linear models and ordinal models).
+- **Fragility Analysis:** Conduct probabilistic seismic demand modeling to establish relationships between engineering demand parameters (EDPs) and intensity measures (IMs) using nonlinear time-history analyses (e.g., cloud analysis, multiple stripe analyses). Estimate damage exceedance probabilities while accounting for record-to-record variability and modeling uncertainty. Multiple state-of-practice approaches are supported, including lognormal CDFs, generalised linear models and ordinal models.
- **Storey Loss Function Generation:** Develop storey-level loss functions based on a user-defined inventory of structural components, nonstructural components, and building contents.
- **Vulnerability Analysis:** Derive vulnerability functions to evaluate both economic and human-centered decision variables. These functions integrate damage-to-loss ratios and/or storey loss functions, with explicit treatment of uncertainties associated with loss conditional on ground-shaking intensity.
-### 📈 Powerful Visualization & Plotting Tools
+### 📈 Visualization & Plotting Tools
- Generate insightful plots for:
- **Model Overview:** Nodes and elements in your OpenSees model.
- **Cloud Analysis Results:** Visualize probabilistic seismic demand models (i.e., IM-EDP data and fitted relationships).
@@ -168,7 +169,7 @@ For detailed documentation and user guidance on using the toolkit for vulnerabil
# 📑 References
-[WIP]
+[TBD]
# 🤝 Contributions
diff --git a/imgs/gem-vulnerability-toolkit.png b/imgs/gem-vulnerability-toolkit.png
deleted file mode 100644
index 3da03ea..0000000
Binary files a/imgs/gem-vulnerability-toolkit.png and /dev/null differ
diff --git a/imgs/oq_vmtk_logo.png b/imgs/oq_vmtk_logo.png
new file mode 100644
index 0000000..b936f56
Binary files /dev/null and b/imgs/oq_vmtk_logo.png differ