tudelft3d / ifcgref

MIT License
17 stars 1 forks source link

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:

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

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

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