`ifcopenshell.geom.main`¶

Module Contents¶

class ifcopenshell.geom.main.iterator(settings: iterator.__init__.settings, file_or_filename: ifcopenshell.file | str, num_threads: int = 1, include: list[ifcopenshell.entity_instance] | list[str] | None = None, exclude: list[ifcopenshell.entity_instance] | list[str] | None = None, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger=None)¶

Bases: ifcopenshell.ifcopenshell_wrapper.iterator

get()¶: Get last processed element.

get_task_products()¶

settings¶

class ifcopenshell.geom.main.kernel(settings: kernel.__init__.settings, file: kernel.__init__.file, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger: ifcopenshell.logger | None = None)¶

A reusable geometry kernel bound to a (geometry library, file, settings) triple.

ifcopenshell.geom.create_shape constructs a new geometry kernel on every call, which repeats the backend resolution (including plugin discovery for hybrid kernels) and discards the mapping and conversion caches afterwards. This class performs that construction once so that converting many products one by one reuses the same kernel, mapping and caches, similar to what ifcopenshell.geom.iterator does internally.

The kernel is bound at construction: the settings are copied and the file reference is kept, so later changes to the settings object do not affect an existing kernel and instances passed to create_shape() must belong to the bound file.

Example:

settings = ifcopenshell.geom.settings()
k = ifcopenshell.geom.kernel(settings, ifc_file, geometry_library="hybrid-cgal-simple-opencascade")
for product in ifc_file.by_type("IfcProduct"):
    if product.Representation:
        shape = k.create_shape(product)

create_shape(inst: ifcopenshell.entity_instance, repr: ifcopenshell.entity_instance | None = None) → ShapeType | ShapeElementType | ifcopenshell.ifcopenshell_wrapper.transformation | ifcopenshell.geom.occ_utils.shape_tuple | OCC.Core.TopoDS.TopoDS_Shape¶

Identical to create_shape() but reuses this kernel across calls.

See create_shape() for the possible return types; the settings and geometry library bound at construction are used for every call.

file¶

settings¶

wrapped¶

class ifcopenshell.geom.main.missing_setting¶

class ifcopenshell.geom.main.serializers¶

classmethod guess_from_extension(filepath: str)¶

buffer¶

class ifcopenshell.geom.main.settings(**kwargs)¶

Bases: settings_mixin, ifcopenshell.ifcopenshell_wrapper.settings

Pythonic interface mixin to the settings modules and to provide an additional setting to enable pythonOCC when available

use_python_opencascade = False¶

class ifcopenshell.geom.main.settings_mixin(**kwargs)¶

Pythonic interface mixin to the settings modules and to provide an additional setting to enable pythonOCC when available

apply_namespace(namespace) → None¶: Accepts an argparse.Namespace object, enumerates over the values in this namespace and writes them to the settings when available

build_parser(parser) → None¶: Accepts an argparse.ArgumentParser object, enumerates the settings in this container and adds argument parser rules for each.

get(k: str) → Any¶

Return value of the setting named k.

Raises:: RuntimeError – If there is no setting with name k.

static name(k: str) → SETTING¶

static rname(k: SETTING) → str¶

set(k: SETTING, v: Any) → None¶

Set value of the setting named k to v.

Raises:: RuntimeError – If there is no setting with name k.

setting_names() → tuple[str, ...]¶

class ifcopenshell.geom.main.tree(file: tree.__init__.file | None = None, settings: tree.__init__.settings | None = None, backend: str | None = 'opencascade.brep')¶

Bases: ifcopenshell.ifcopenshell_wrapper.tree

add_file(file: tree.add_file.file, settings: tree.add_file.settings) → None¶

add_iterator(iterator: tree.add_iterator.iterator) → None¶

clash_clearance_many(set_a: collections.abc.Iterable[ifcopenshell.entity_instance], set_b: collections.abc.Iterable[ifcopenshell.entity_instance], clearance: float = 0.05, check_all: bool = False) → tuple[ifcopenshell.ifcopenshell_wrapper.clash, ...]¶

clash_collision_many(set_a: collections.abc.Iterable[ifcopenshell.entity_instance], set_b: collections.abc.Iterable[ifcopenshell.entity_instance], allow_touching=False) → tuple[ifcopenshell.ifcopenshell_wrapper.clash, ...]¶

clash_intersection_many(set_a: collections.abc.Iterable[ifcopenshell.entity_instance], set_b: collections.abc.Iterable[ifcopenshell.entity_instance], tolerance: float = 0.002, check_all: bool = True) → tuple[ifcopenshell.ifcopenshell_wrapper.clash, ...]¶

static get_clash_type(clash_type_i: int) → ClashType¶

Convert clash type index to a readable string format.

Parameters:: clash_type_i – Type index that comes from clash.clash_type.

select(value: ifcopenshell.entity_instance | ifcopenshell.ifcopenshell_wrapper.native_element | tuple[float, float, float], **kwargs) → list[ifcopenshell.entity_instance]¶

select_box(value, **kwargs) → list[ifcopenshell.entity_instance]¶

select_ray(origin: collections.abc.Sequence[float], direction: collections.abc.Sequence[float], length: float = 1000.0) → ifcopenshell.ifcopenshell_wrapper.ray_intersection_results¶

ifcopenshell.geom.main.consume_iterator(it: iterator, with_progress: Literal[False] = False) → collections.abc.Generator[IteratorOutput]¶
ifcopenshell.geom.main.consume_iterator(it: iterator, with_progress: Literal[True]) → collections.abc.Generator[tuple[int, IteratorOutput]]
ifcopenshell.geom.main.consume_iterator(it: iterator, with_progress: bool) → collections.abc.Generator[IteratorOutput | tuple[int, IteratorOutput]]

ifcopenshell.geom.main.create_shape(settings: create_shape.settings, inst: ifcopenshell.entity_instance, repr: ifcopenshell.entity_instance | None = None, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger: ifcopenshell.logger | None = None) → ShapeType | ShapeElementType | ifcopenshell.ifcopenshell_wrapper.transformation | ifcopenshell.geom.occ_utils.shape_tuple | OCC.Core.TopoDS.TopoDS_Shape¶

Returns a geometric interpretation of the IFC entity instance

The returned element’s geometry keeps a reference to its owning element, so accessing children (e.g. create_shape(...).geometry.verts) no longer requires holding onto the element. See #1124.

Raises:

RuntimeError – If failed to process shape. You can turn detailed logging to get more details.

Returns:

inst is IfcProduct and repr provided / None -> ShapeElementType
inst is IfcRepresentation and repr is None -> ShapeType
inst is IfcRepresentationItem and repr is None -> ShapeType
inst is IfcProfileDef and repr is None -> ShapeType
inst is IfcPlacement / IfcObjectPlacement -> transformation
inst is IfcTypeProduct and repr is None -> None
inst is IfcTypeProduct and repr is provided -> RuntimeError

(for IfcTypeProducts provide just IfcRepresentation as inst).

If ‘use-python-opencascade’ is enabled in settings then

instead of ShapeElementType it returns shape_tuple,
instead of ShapeType it returns TopoDS.TopoDS_Shape.

Example:

settings = ifcopenshell.geom.settings()
settings.set("use-python-opencascade", True)

ifc_file = ifcopenshell.open(file_path)
products = ifc_file.by_type("IfcProduct")

for i, product in enumerate(products):
    if product.Representation is not None:
        try:
            created_shape = geom.create_shape(settings, inst=product)
            shape = created_shape.geometry # see #1124
            shape_gpXYZ = shape.Location().Transformation().TranslationPart() # These are methods of the TopoDS_Shape class from pythonOCC
            print(shape_gpXYZ.X(), shape_gpXYZ.Y(), shape_gpXYZ.Z()) # These are methods of the gpXYZ class from pythonOCC
        except:
            print("Shape creation failed")

ifcopenshell.geom.main.has_geometry_library(geometry_library: str) → bool¶: Return whether a geometry kernel library can be loaded.

ifcopenshell.geom.main.iterate(settings: iterate.settings, file_or_filename: ifcopenshell.file | str, num_threads: int = 1, include: list[ifcopenshell.entity_instance] | list[str] | None = None, exclude: list[ifcopenshell.entity_instance] | list[str] | None = None, *, with_progress: Literal[False] = False, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger=None) → collections.abc.Generator[IteratorOutput]¶
ifcopenshell.geom.main.iterate(settings: iterate.settings, file_or_filename: ifcopenshell.file | str, num_threads: int = 1, include: list[ifcopenshell.entity_instance] | list[str] | None = None, exclude: list[ifcopenshell.entity_instance] | list[str] | None = None, *, with_progress: Literal[True] = True, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger=None) → collections.abc.Generator[tuple[int, IteratorOutput]]
ifcopenshell.geom.main.iterate(settings: iterate.settings, file_or_filename: ifcopenshell.file | str, num_threads: int = 1, include: list[ifcopenshell.entity_instance] | list[str] | None = None, exclude: list[ifcopenshell.entity_instance] | list[str] | None = None, *, with_progress: bool = False, geometry_library: GEOMETRY_LIBRARY = 'opencascade', logger=None) → collections.abc.Generator[IteratorOutput | tuple[int, IteratorOutput]]: Get a geometry iterator for the provided file.

ifcopenshell.geom.main.make_shape_function(fn)¶

ifcopenshell.geom.main.map_shape(settings: map_shape.settings, inst: ifcopenshell.entity_instance) → ifcopenshell.ifcopenshell_wrapper.item¶

Returns an interpretation of the geometry encoded as per IfcOpenShell’s taxonomy layer. In many cases this is somewhat equivalent to the raw IFC data (but schema-agnostic in C++), but in other cases such as IfcParameterizedProfileDef the returned item is the equivalent of an explicit composite curve.

>>> point = ifc_file.by_type('IfcCartesianPoint')[0]
>>> ifcopenshell.geom.map_shape(ifcopenshell.geom.settings(), point).components
(0.0, 0.0, 0.0)

ifcopenshell.geom.main.wrap_shape_creation(settings, shape)¶

ifcopenshell.geom.main.wrap_shape_creation(settings: wrap_shape_creation.settings, shape: ifcopenshell.ifcopenshell_wrapper.element)¶

ifcopenshell.geom.main.CLASH_TYPE_ITEMS = ('protrusion', 'pierce', 'collision', 'clearance')¶

ifcopenshell.geom.main.ClashType¶

ifcopenshell.geom.main.GEOMETRY_LIBRARY¶

ifcopenshell.geom.main.IteratorOutput¶

ifcopenshell.geom.main.SETTING¶

ifcopenshell.geom.main.ShapeElementType¶

ifcopenshell.geom.main.ShapeType¶

ifcopenshell.geom.main.T¶

ifcopenshell.geom.main¶

Module Contents¶

`ifcopenshell.geom.main`¶