OpenGeode Inspector

6.8.20 verified Mon Apr 27 auth: no python

Open source framework for inspecting the validity of geometric models (meshes, surfaces, volumes). Current version 6.8.20, monthly releases on PyPI.

pip install opengeode-inspector

Common errors

error ModuleNotFoundError: No module named 'opengeode' ↓

cause opengeode-core not installed or version mismatch.

fix

pip install opengeode-core==6.8.20 (same version as inspector)

error ImportError: cannot import name 'InspectModel' from 'opengeode.inspector' ↓

cause Old import path used; inspector module not loaded correctly.

fix

Use 'from opengeode.inspector import InspectModel' (note: lowercase 'i' in inspector)

Warnings

breaking opengeode-inspector 6.x reorganised imports: classes moved from opengeode_inspector to opengeode.inspector. ↓

fix Use 'from opengeode.inspector import ...' instead of 'from opengeode_inspector import ...'.

gotcha opengeode-inspector is a C extension; the package must exactly match the Python version (requires_python <3.13,>=3.9). Mixed wheel installs silently fail. ↓

fix Ensure you install from PyPI into a clean venv with matching Python version.

Imports

InspectModel
wrong
```
from opengeode_inspector import InspectModel
```
correct
```
from opengeode.inspector import InspectModel
```
Old package had hyphen replaced with underscore; now subpackage of opengeode.
MeshInspector
wrong
```
import inspect
```
correct
```
from opengeode.inspector import MeshInspector
```
Python built-in inspect module is unrelated.

Quickstart

Create a model and inspect its validity.

from opengeode import geode as geode_lib
from opengeode.inspector import InspectModel

# Create a simple tetrahedral mesh
mesh = geode_lib.TetrahedralSolid3D.create()
# Inspector requires a valid model with at least one component
# For demo, we use an empty model; in practice load from file

inspector = InspectModel(mesh)
issues = inspector.inspect()
if issues:
    print("Issues found:", issues)
else:
    print("Model is valid")