bimquake

A Python package for earthquake resilience assessment of masonry buildings, integrating IFC (Industry Foundation Classes) building information models with seismic hazard analysis and structural evaluation.

• Website: https://buildchain.ilab.sztaki.hu/
• Source code: https://github.com/TRACE-Structures/bimquake
• Bug reports: https://github.com/TRACE-Structures/bimquake/issues

Overview

BIMQuake combines Building Information Modeling (BIM) with earthquake engineering to provide comprehensive seismic analysis capabilities. The package enables users to:

• Extract structural data from IFC building models
• Retrieve seismic hazard parameters based on geographic location
• Perform linear and non-linear static analysis for earthquake loading
• Evaluate wall safety factors and global vulnerability indexes
• Visualize building layouts and structural wall resistance
• Generate interactive maps and 2D floor plans

Installation

pip install bimquake

Features

IFC Processing

• Building Model Extraction: Parse and process IFC files to extract structural elements (walls, slabs, columns)
• Geometric Analysis: Extract geometric properties, dimensions, and spatial relationships between model elements
• Material Properties: Retrieve material characteristics from IFC models
• 3D Visualization: Generate meshes for 3D visualization of building components
• Load analysis: Combine vertical loads and calculate stresses on the walls

Earthquake Hazard Analysis

• Seismic Parameter Retrieval: Get earthquake hazard parameters based on latitude/longitude coordinates
• Italian Seismic Code: Built-in support for Italian National Building Code (NTC2018) seismic hazard grid data
• Return Period Analysis: Calculate parameters for various return periods
• Interactive Mapping: Generate folium-based maps showing building location

Structural Analysis

• Linear Static Analysis: Perform seismic analysis according to Italian building code (NTC2018)
• Wall Resistance Calculation: Evaluate structural wall capacity for different failure criteria (shear, bending in plane and out of plane)
• Floor-by-Floor Analysis: Analyze building response at each floor level
• Failure Mechanism Visualization: Visualize potential failure modes
• Non-linear static analysis: Perform analysis and evaluate global vulnerability on the Acceleration Displacement Response Spectra (ADRS) plane

Core Components

eq_resilience_library

Main module containing earthquake resilience analysis functions:

• get_Parameters(): Retrieve seismic hazard parameters
• get_map(): Generate interactive location map
• run_linear_static_analysis(): Perform linear static analysis
• run_pushover_analysis(): Perform pushover analysis
• get_2D_layout(): Generate 2D floor plan visualization
• plot_wall_resistence(): Visualize wall resistance and failure mechanisms

ifc_processing

Subpackage for processing IFC building models:

• building.py: Main building model handler with IfcObjectSet class
• wall.py: Wall element extraction and analysis
• slab.py: Slab element extraction and analysis
• IFC_objects.py: Base IFC object definitions
• simple_objects.py: Simplified geometric representations

Data Formats

Input Excel File Format

The analysis requires building data in Excel format with the following sheets:

• Data: Building overview (floor heights and total floor weights)
• Floor1, Floor2, ...: Individual floor data including geometrical (height, length, orientation) and material (tensile strength, Poisson ratio, shear and elastic moduli) wall properties

IFC Requirements

• Compatible with IFC 2x3 and IFC 4 formats
• Requires structural elements to have properly defined geometry
• Material properties should be assigned to structural elements
• Loads should be assigned to slabs and other structural elements

Current Limitations

• Seismic hazard data currently available only for Italy
• Analysis follows Italian building codes (NTC 2018)

Authors and acknowledgment

The code is developed by Filippo Landi, Giada Bartolini, Bence Popovics, Noémi Friedman and Áron Friedman in the TRACE-Structures group.

This work has been funded by the European Commission Horizon Europe Innovation Action project 101092052 BUILDCHAIN

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0-only). See the LICENSE file for details.

Related Projects

• uncertain_variables: Probabilistic variable management
• gPCE_model: Generalized Polynomial Chaos Expansion
• digital_twinning: Digital Twinning

Support

For issues, questions, or contributions, please refer to the project repository or contact the authors.