Skip to content

Latest commit

 

History

History
126 lines (77 loc) · 4.33 KB

README.md

File metadata and controls

126 lines (77 loc) · 4.33 KB
Raw

IfcGref Web-Based Application

ifcgref-release

Overview

This Flask-based application serves the purpose of georeferencing IFC (Industry Foundation Classes) files, which are commonly used in the context of Building Information Modeling (BIM) data exchange. To accomplish georeferencing, the application leverages the IFCMapConversion entity in IFC4, which facilitates the updating of data and the conversion from a local Coordinate Reference System (CRS), often referred to as the engineering coordinate system, into the coordinate reference system of the underlying map (Projected CRS). It's accessible at https://ifcgref.bk.tudelft.nl.

Prerequisites

Before running the application, make sure you have the following prerequisites installed on your system:

  • Python 3
  • Flask
  • ifcopenshell
  • pyproj
  • pint
  • numpy
  • scipy
  • pandas
  • shapely

You can install these dependencies using pip:

pip install Flask ifcopenshell pyproj pint numpy scipy pandas shapely

Supported IFC versions

Coordinate operations become accessible starting from IFC 4. For earlier versions like the widely utilized IFC2x3, the utilization of Property sets (Pset) is employed to enable georeferencing. The table below outlines the supported versions:

Version Name
4.3.2.0 IFC 4.3 ADD2
4.0.2.0 IFC4 ADD2 TC1
4.0.2.1 IFC4 ADD2
4.0.2.0 IFC4 ADD1
4.0.0.0 IFC4
2.3.0.1 IFC2x3 TC1
2.3.0.0 IFC2x3

Usage

  1. Clone this repository or download the application files to your local machine.

  2. Navigate to the project directory in your terminal.

  3. Run the Flask application:

python app.py

This will start the Flask development server.

  1. Access the application in your web browser by going to http://localhost:5000/.
  2. Follow the on-screen instructions to upload an IFC file and specify the target EPSG code.
  3. The application will georeference the IFC file and provide details about the process.
  4. You can then visualize the georeferenced IFC file on the map and download it.

File Structure

  • app.py: The main Flask application file.
  • static/: Directory to store static files (e.g., GeoJSON output).
  • templates/: HTML templates for the web interface.
  • uploads/: Directory to temporarily store uploaded IFC files.
  • envelop/: Directory to EnvelopExtractor exe files and temporary store shell produced files.

Workflow

Screenshot 2024-02-26 at 17 28 20 (2)

HTTP request

For streamlined handling of incoming IFC files by developers, whether they are georeferenced or not, a specialized section called "devs" is available at https://ifcgref.bk.tudelft.nl/devs. Developers can engage with this section by submitting an HTTP request containing the IFC file, and in response, the server provides them with a corresponding response.

Sample of HTTP request from the devs section using a python script:

import requests

url = 'https://ifcgref.bk.tudelft.nl/devs'
file_path = './00.ifc'


data = {
    'file': ('00.ifc', open(file_path, 'rb'))
}


# Make a POST request to the /devs route with the data
response = requests.post(url, files=data)

# Print the response content
print(response.text)

Credits

  • This application uses the Flask web framework for the user interface.
  • It leverages the ifcopenshell library for working with IFC files.
  • Georeferencing is performed using pyproj for coordinate transformations.
  • The optimization is performed using SciPy and in particular scipy.optimize.least_squares function.
  • For the vizualization feature IfcEnvelopeExtractor is used for generating the roof-print of the 3D BIM model.

Acknowledgments

This project has received funding from the European Union’s Horizon Europe programme under Grant Agreement No.101058559 (CHEK: Change toolkit for digital building permit).

References

BuildingSMART. IFC Specifications database. https://technical.buildingsmart.org/standards/ifc/ifc-schema-specifications/

BuildingSMART Australasia (2020). User Guide for Geo-referencing in IFC, version 2.0. https://www.buildingsmart.org/wp-content/uploads/2020/02/User-Guide-for-Geo-referencing-in-IFC-v2.0.pdf

https://github.com/stijngoedertier/georeference-ifc#readme