{"id":24159,"library":"opengeode-geosciencesio","title":"OpenGeode-GeosciencesIO","description":"Input/Output formats for geosciences within the OpenGeode framework, including reading/writing geosciences data formats. Current version 5.8.13. Released regularly alongside OpenGeode core.","status":"active","version":"5.8.13","language":"python","source_language":"en","source_url":"https://github.com/OpenGeode/OpenGeode-GeosciencesIO","tags":["geosciences","io","opengeode","3d","modeling"],"install":[{"cmd":"pip install opengeode-geosciencesio","lang":"bash","label":"Stable version (PyPI)"}],"dependencies":[{"reason":"Required for core OpenGeode functionality","package":"opengeode-core","optional":false}],"imports":[{"note":"The library is a namespace package; the correct import is from the 'opengeode' umbrella module after installing opengeode-geosciencesio.","wrong":"from opengeode_geosciencesio import GeosciencesIO","symbol":"GeosciencesIO","correct":"from opengeode import GeosciencesIO"},{"note":"The detailed submodule path was introduced in later versions.","wrong":"from opengeode_geosciencesio import GeosciencesIOLibrary","symbol":"GeosciencesIOLibrary","correct":"from opengeode.io.geosciences import GeosciencesIOLibrary"}],"quickstart":{"code":"from opengeode import GeosciencesIO\n\n# Load a geology model (e.g., in VTK format)\nmodel = GeosciencesIO.load('model.vtu')\nprint(model)\n","lang":"python","description":"Load a geosciences file using the high-level IO interface."},"warnings":[{"fix":"Use `from opengeode import GeosciencesIO` after installing opengeode-geosciencesio.","message":"The library is a namespace package; import from 'opengeode', not 'opengeode_geosciencesio'. The underlying package name does not correspond to the import path.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `from opengeode import GeosciencesIO` for the main IO class, or `from opengeode.io.geosciences import GeosciencesIOLibrary` for the format-specific library.","message":"In version 5.x, the submodule structure was reorganized. The old import pattern `from opengeode.io.geosciencesio import ...` may break.","severity":"breaking","affected_versions":">=5.0.0,<6.0.0"},{"fix":"Install opengeode-geosciencesio as a dependency; import via 'opengeode'.","message":"The package name 'opengeode-geosciencesio' is deprecated in favor of using the umbrella 'opengeode' package that aggregates all IO modules. However, the PyPI package still exists.","severity":"deprecated","affected_versions":"all"},{"fix":"Run `pip install opengeode-core` before or alongside opengeode-geosciencesio.","message":"The library depends on opengeode-core, but pip does not automatically install it. You must install opengeode-core separately if not already present.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from opengeode import GeosciencesIO` instead.","cause":"Trying to import the package using the PyPI distribution name with underscores instead of the proper import path.","error":"ModuleNotFoundError: No module named 'opengeode_geosciencesio'"},{"fix":"Run `pip install opengeode-geosciencesio`.","cause":"The opengeode-geosciencesio package is not installed, even though opengeode-core may be installed.","error":"ImportError: cannot import name 'GeosciencesIO' from 'opengeode'"},{"fix":"Ensure you import GeosciencesIO or another IO class directly: `from opengeode import GeosciencesIO`. The 'io' submodule is not exposed by default.","cause":"In older versions of opengeode-core, the IO subpackage may not be loaded if the IO packages are not imported explicitly.","error":"AttributeError: module 'opengeode' has no attribute 'io'"},{"fix":"Provide the filename: `GeosciencesIO.load('file.vtu')`.","cause":"Omitting the filename argument when calling GeosciencesIO.load().","error":"TypeError: load() missing 1 required positional argument: 'filename'"},{"fix":"Double-check the file path and ensure it is accessible.","cause":"The file path is incorrect or the file does not exist.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'model.vtu'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}