Function select

src/ifcquery/ifcquery/select.py:28–50

Filter elements using ifcopenshell selector syntax and return matching element summaries. Examples: - ``IfcWall`` — all walls - ``IfcWall, IfcColumn`` — walls and columns - ``! IfcWall`` — everything except walls - ``IfcWall, Name = "My Wall"`` — walls with a specific name attri

(model: ifcopenshell.file, query: str)

def select(model: ifcopenshell.file, query: str) -> list[dict[str, Any]]:
    """Filter elements using ifcopenshell selector syntax and return matching element summaries.

    Examples:
    - ``IfcWall`` — all walls
    - ``IfcWall, IfcColumn`` — walls and columns
    - ``! IfcWall`` — everything except walls
    - ``IfcWall, Name = "My Wall"`` — walls with a specific name attribute
    - ``type = "Concrete Wall"`` — elements assigned that type product
    - ``material = "Concrete"`` — elements with that material
    """
    elements = ifcopenshell.util.selector.filter_elements(model, query)
    results = []
    for element in sorted(elements, key=lambda e: e.id()):
        entry: dict[str, Any] = {
            "id": element.id(),
            "type": element.is_a(),
            "repr": str(element),
        }
        if hasattr(element, "Name"):
            entry["name"] = element.Name
        results.append(entry)
    return results