nudtzk/mdof-building-response-dataset

---
configs:
- config_name: default
data_files:
- split: train
path: metadata.parquet
---

# MDOF Building Response Dataset

## Dataset Summary

This dataset contains publicly sourced building geometry records enriched with response features produced by the simplified bending-shear coupled MDOF earthquake analysis code in this repository.

The workflow is:

1. Collect building geometry from public map and metadata sources.
2. Convert each building into the model inputs required by `BuildingConfig`.
3. Estimate equivalent elastic MDOF parameters from exterior geometry.
4. Run linear time-history analysis under the El Centro NS ground motion.
5. Export scalar response features and two profile images per building.

The current enriched table contains only samples that were successfully analyzed.

## Repository Structure

- `mdof_geometry_dataset.csv`
Cleaned geometry dataset before response enrichment.
- `mdof_geometry_dataset_enriched.csv`
Final analysis-ready CSV export with response features.
- `metadata.parquet`
Hugging Face viewer-oriented Parquet table with image columns named as `*_file_name`.
- `images/peak_displacement/`
Building displacement profile images at the time of peak lateral displacement.
- `images/peak_drift/`
Building displacement profile images at the time of maximum interstory drift ratio.

## Core Geometry Fields

- `record_id`
- `building_name`
- `city`
- `latitude`
- `longitude`
- `height_m`
- `floors_above_ground`
- `plan_width_m`
- `plan_depth_m`
- `story_height_m_est`
- `source_primary_url`
- `notes`

## Added Response Features

- `peak_lateral_displacement_m`
Maximum lateral displacement over all floors and all time steps.
- `peak_lateral_displacement_floor`
Floor index where the maximum lateral displacement occurs.
- `max_interstory_drift_ratio_pct`
Maximum interstory drift ratio in percent.
- `peak_drift_floor`
Floor index where the maximum interstory drift ratio occurs.
- `damage_state`
Drift-based damage label from the simplified screening rule:
- `slight`: drift < 0.5%
- `moderate`: 0.5% to < 1.0%
- `severe`: 1.0% to < 2.0%
- `near_collapse`: >= 2.0%
- `peak_displacement_profile_file_name`
Relative path to the peak displacement profile image.
- `peak_drift_profile_file_name`
Relative path to the peak drift profile image.

## Modeling Notes

- Structural model: elastic bending-shear coupled MDOF model.
- Degrees of freedom per floor: lateral translation and rotation.
- Mass model: uniform floor mass estimated from footprint area, story height, and equivalent bulk density.
- Input motion: El Centro NS accelerogram included in this repository.
- Damping: Rayleigh damping in the codebase default configuration.
- P-Delta: simplified linearized geometric stiffness reduction is included in the current implementation.

## Data Source Notes

- Building geometry fields were collected from public map metadata and footprint geometry.
- `plan_width_m` and `plan_depth_m` are derived from building footprint geometry rather than official design drawings.
- This is a simplified research dataset intended for screening and comparative analysis, not for code-level structural design.