pyvista_cad.read_iges

read_iges(path, /, *, backend='pyiges', bsplines=True, surfaces=True, lines=False, points=False, delta=0.025, linear_deflection=0.1, angular_deflection=0.5, **_)

Read an IGES file and return a pyvista dataset.

Parameters:

pathstr or os.PathLike

Path to an IGES (.iges / .igs) file.

backend{‘pyiges’, ‘ocp’}, default: ‘pyiges’

Which reader to use. 'pyiges' wraps pyiges.read(path).to_vtk(...) and recovers the per-entity IGES level. 'ocp' wraps OCCT’s IGESControl_Reader: much faster on large files and it respects trimmed-surface boundaries, but it recovers no level metadata.

bsplinesbool, default: True

Tessellate BSpline surfaces. 'pyiges' backend only.

surfacesbool, default: True

Include analytic surfaces. 'pyiges' backend only.

linesbool, default: False

Include line/curve entities. 'pyiges' backend only.

pointsbool, default: False

Include isolated point entities. 'pyiges' backend only.

deltafloat, default: 0.025

Tessellation step for geomdl. 'pyiges' backend only.

linear_deflectionfloat, default: 0.1

OCCT chordal tessellation tolerance (model units). 'ocp' backend only.

angular_deflectionfloat, default: 0.5

OCCT angular tessellation tolerance (radians). 'ocp' backend only.

**_Any

Forward-compat keyword arguments are accepted and ignored.

Returns:

pyvista.DataSet

Tessellated dataset. 'pyiges' returns PolyData or MultiBlock depending on the IGES content; 'ocp' always returns PolyData.

Raises:

FileNotFoundError

If path does not exist.

pyvista_cad.CadReadError

If parsing fails.

pyvista_cad.OptionalDependencyError

If the selected backend is not installed, or backend names an unknown reader.

Parameters:

• path (str | PathLike[str])

• backend (Literal['pyiges', 'ocp'])

• bsplines (bool)

• surfaces (bool)

• lines (bool)

• points (bool)

• delta (float)

• linear_deflection (float)

• angular_deflection (float)

• _ (Any)

Return type:

pv.DataSet