Function info

src/ifcquery/ifcquery/info.py:190–262

Return deep inspection data for an element.

(model: ifcopenshell.file, element: ifcopenshell.entity_instance)

def info(model: ifcopenshell.file, element: ifcopenshell.entity_instance) -> dict[str, Any]:
    """Return deep inspection data for an element."""
    result: dict[str, Any] = {
        "id": element.id(),
        "type": element.is_a(),
    }

    # Direct attributes via get_info() which returns a dict of all attributes
    element_info = element.get_info()
    attrs = {}
    for key, value in element_info.items():
        if key in ("id", "type"):
            continue
        attrs[key] = _serialize_attribute(value)
    result["attributes"] = attrs

    # Property sets and quantity sets
    try:
        psets = ifcopenshell.util.element.get_psets(element)
        if psets:
            result["property_sets"] = psets
    except Exception:
        pass

    # Element type
    try:
        element_type = ifcopenshell.util.element.get_type(element)
        if element_type:
            type_info: dict[str, Any] = {
                "id": element_type.id(),
                "type": element_type.is_a(),
            }
            if hasattr(element_type, "Name"):
                type_info["name"] = element_type.Name
            result["element_type"] = type_info
    except Exception:
        pass

    # Material
    try:
        material = ifcopenshell.util.element.get_material(element)
        mat_dict = _material_to_dict(material)
        if mat_dict:
            result["material"] = mat_dict
    except Exception:
        pass

    # Spatial container
    try:
        container = ifcopenshell.util.element.get_container(element)
        if container:
            result["container"] = {
                "id": container.id(),
                "type": container.is_a(),
                "name": container.Name if hasattr(container, "Name") else None,
            }
    except Exception:
        pass