OpenGeode IO

7.5.2 verified Fri May 01 auth: no python

Implementation of input and output formats (e.g., OBJ, DXF, XYZ, Vs, etc.) for OpenGeode. Current version: 7.5.2. Release cadence: monthly.

pip install opengeode-io

Common errors

error ModuleNotFoundError: No module named 'opengeode_io' ↓

cause Incorrect import path; many attempt to import with underscores.

fix

Use 'from opengeode.io import ...' (dotted package).

error ImportError: cannot import name 'OpenGeodeIO' from 'opengeode.io' ↓

cause Missing or outdated opengeode-core installation.

fix

Install opengeode-core (pip install opengeode-core) and ensure version compatibility.

error OSError: [Errno 2] No such file or directory: '...' ↓

cause File path does not exist or incorrect format reader used.

fix

Verify file path and use explicit format reader (e.g., OBJReader).

Warnings

gotcha Import with underscores (import opengeode_io) does not work; must use dotted package path: from opengeode.io import ... ↓

fix Use 'from opengeode.io import X' instead of 'import opengeode_io'.

breaking Version 7.x dropped support for Python 3.8 and earlier. Requires Python >=3.9,<3.13. ↓

fix Upgrade to Python 3.9-3.12.

gotcha File formats are not auto-detected by extension; you must use the correct reader/writer class (e.g., OBJReader, OBJWriter). ↓

fix Explicitly import the reader for your format, e.g., from opengeode.io.obj import OBJReader.

Imports

OpenGeodeIO
wrong
```
import opengeode_io
```
correct
```
from opengeode.io import OpenGeodeIO
```
The library uses underscores in package name but the correct subpackage is 'opengeode.io'

OGRExporter

wrong

from opengeode_io import OGRExporter

correct

from opengeode.io.ogr import OGRExporter

OGR module is nested under opengeode.io

Quickstart

Basic usage: create an OpenGeodeIO instance, read a file into a mesh object, and write it back.

from opengeode.io import OpenGeodeIO

io = OpenGeodeIO()
# Read a mesh file (e.g., OBJ)
mesh = io.read("model.obj")
print(mesh)

# Write a mesh to a file
io.write(mesh, "output.obj")