georeference_ifc_model

Assign geographic coordinates to IFC building models by creating or updating coordinate reference systems and map conversions for accurate location positioning.

Instructions

Georeferences the IFC currently opened in Bonsai/BlenderBIM by creating or updating IfcProjectedCRS and IfcMapConversion. Optionally updates IfcSite and writes the file to disk.

Input Schema

TableJSON Schema

Name	Required	Default
`crs_mode`	Yes
`epsg`	No
`crs_name`	No
`geodetic_datum`	No
`map_projection`	No
`map_zone`	No
`eastings`	No
`northings`	No
`orthogonal_height`	No
`scale`	No
`x_axis_abscissa`	No
`x_axis_ordinate`	No
`true_north_azimuth_deg`	No
`context_filter`	No	Model
`context_index`	No
`site_ref_latitude`	No
`site_ref_longitude`	No
`site_ref_elevation`	No
`site_ref_latitude_dd`	No
`site_ref_longitude_dd`	No
`overwrite`	No
`dry_run`	No
`write_path`	No

Implementation Reference

tools.py:903-974 (handler)

The handler function for the 'georeference_ifc_model' tool. It collects georeferencing parameters, filters out None values, and forwards them as a command to the Blender addon via the socket connection for actual IFC model georeferencing.

def georeference_ifc_model(
    crs_mode: str,
    epsg: int = None,
    crs_name: str = None,
    geodetic_datum: str = None,
    map_projection: str = None,
    map_zone: str = None,
    eastings: float = None,
    northings: float = None,
    orthogonal_height: float = 0.0,
    scale: float = 1.0,
    x_axis_abscissa: float = None,
    x_axis_ordinate: float = None,
    true_north_azimuth_deg: float = None,
    context_filter: str = "Model",
    context_index: int = None,
    site_ref_latitude: list = None,      # [deg, min, sec, millionth]
    site_ref_longitude: list = None,     # [deg, min, sec, millionth]
    site_ref_elevation: float = None,
    site_ref_latitude_dd: float = None,  # Decimal degrees (optional)
    site_ref_longitude_dd: float = None, # Decimal degrees (optional)
    overwrite: bool = False,
    dry_run: bool = False,
    write_path: str = None,
) -> str:
    """
    Georeferences the IFC currently opened in Bonsai/BlenderBIM by creating or 
    updating IfcProjectedCRS and IfcMapConversion. Optionally updates IfcSite 
    and writes the file to disk.
    """
    import json
    blender = get_blender_connection()

    # Build params excluding None values to keep the payload clean
    params = {
        "crs_mode": crs_mode,
        "epsg": epsg,
        "crs_name": crs_name,
        "geodetic_datum": geodetic_datum,
        "map_projection": map_projection,
        "map_zone": map_zone,
        "eastings": eastings,
        "northings": northings,
        "orthogonal_height": orthogonal_height,
        "scale": scale,
        "x_axis_abscissa": x_axis_abscissa,
        "x_axis_ordinate": x_axis_ordinate,
        "true_north_azimuth_deg": true_north_azimuth_deg,
        "context_filter": context_filter,
        "context_index": context_index,
        "site_ref_latitude": site_ref_latitude,
        "site_ref_longitude": site_ref_longitude,
        "site_ref_elevation": site_ref_elevation,
        "site_ref_latitude_dd": site_ref_latitude_dd,
        "site_ref_longitude_dd": site_ref_longitude_dd,
        "overwrite": overwrite,
        "dry_run": dry_run,
        "write_path": write_path,
    }
    params = {k: v for k, v in params.items() if v is not None}

    try:
        result = blender.send_command("georeference_ifc_model", params)
        return json.dumps(result, ensure_ascii=False, indent=2)
    except Exception as e:
        logger.exception("georeference_ifc_model error")
        return json.dumps(
            {"success": False, "error": "Could not georeference the model.", "details": str(e)},
            ensure_ascii=False,
            indent=2,
        )

Bonsai-mcp