{"id":9009,"library":"geode-conversion","title":"Geode-Conversion","description":"Geode-Conversion is a proprietary OpenGeode module that provides robust conversion algorithms for volumetric and surface meshes and boundary representations. It is part of the Geode-solutions ecosystem, currently at version 6.5.21, and maintains a frequent release cadence, often with updates released monthly or bi-monthly.","status":"active","version":"6.5.21","language":"en","source_language":"en","source_url":"https://github.com/Geode-solutions/Geode-Conversion","tags":["modeling","mesh","meshing","brep","conversion","geometry","geosciences"],"install":[{"cmd":"pip install Geode-Conversion","lang":"bash","label":"Install with pip"}],"dependencies":[{"reason":"Required Python interpreter version range.","package":"python","version":"<3.13,>=3.9","optional":false}],"imports":[{"symbol":"geode_conversion","correct":"import geode_conversion"}],"quickstart":{"code":"import geode_conversion\nimport os\n\n# Geode-Conversion is a proprietary module and requires a license.\n# For a full quickstart, you would typically load a geometric model\n# and then apply conversion algorithms provided by the library.\n# Replace 'your_license_key' with your actual license key if applicable,\n# or ensure the license file is accessible as per Geode-solutions documentation.\n# This example primarily shows the import path and the proprietary nature.\n\n# Example placeholder for potential usage (requires a licensed setup and data):\n# if os.environ.get('GEODE_LICENSE_PATH'):\n#     print(\"Geode-Conversion loaded successfully.\")\n#     # You would typically interact with Geode-solutions data structures here.\n#     # For example:\n#     # mesh = geode_conversion.load_mesh(\"path/to/mesh.obj\")\n#     # converted_data = geode_conversion.convert_to_bbl(mesh)\n# else:\n#     print(\"Warning: GEODE_LICENSE_PATH not set. Geode-Conversion functionality may be limited or unavailable without a valid license.\")\n\nprint(\"Geode-Conversion imported. A valid license from Geode-solutions is required for full functionality.\")\n","lang":"python","description":"This quickstart demonstrates the basic import of `geode_conversion`. Note that `geode-conversion` is a proprietary module from Geode-solutions and requires a valid license to unlock its full functionality. Without a license, many operations will likely fail or be unavailable. You typically contact Geode-solutions for license information."},"warnings":[{"fix":"Refer to the Geode-solutions documentation and migration guides for the specific OpenGeode SDK version when upgrading. Test your application thoroughly after package updates.","message":"The underlying OpenGeode C++ framework, on which `geode-conversion` is based, undergoes frequent and significant breaking changes between major versions (e.g., v3.x to v4.0, v4.x to v5.0). While direct Python binding impacts are not always explicitly detailed, users should anticipate that upgrading the Python package might require corresponding changes if the underlying C++ API that the Python bindings wrap has changed.","severity":"breaking","affected_versions":"All versions, especially across major OpenGeode SDK updates."},{"fix":"Contact Geode-solutions directly via Slack or email to obtain a license file and follow their instructions for its setup (e.g., via an environment variable like `GEODE_LICENSE_PATH`).","message":"Geode-Conversion is a proprietary module and requires a license from Geode-solutions. Without a valid license, the library's core conversion functionalities will not work, or the module might not load correctly.","severity":"gotcha","affected_versions":"All versions"},{"fix":"When encountering complex issues, consult the OpenGeode documentation, which is primarily C++ focused, and consider engaging with the Geode-solutions community (e.g., via Slack) for support.","message":"The Geode-solutions ecosystem, including `geode-conversion`, is deeply rooted in C++ development. Debugging issues that arise from the Python bindings often requires familiarity with C++ concepts, error messages, and the underlying OpenGeode framework.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Ensure the package is installed in your active Python environment: `pip install Geode-Conversion`.","cause":"The `geode-conversion` package was not installed or installed in a different Python environment.","error":"ModuleNotFoundError: No module named 'geode_conversion'"},{"fix":"Obtain a valid license from Geode-solutions and ensure it is correctly placed and accessible (e.g., via the `GEODE_LICENSE_PATH` environment variable) as per their documentation. Contact Geode-solutions support if the issue persists.","cause":"The `geode-conversion` library could not find a valid license file, or the provided license is expired/incorrect.","error":"RuntimeError: [OpenGeode] License check failed: license file not found or invalid."},{"fix":"Verify that your input mesh data is correctly loaded and parsed into the expected Geode-solutions data structure before attempting to pass it to conversion functions. Consult OpenGeode examples for proper data loading and manipulation.","cause":"Attempting to pass an uninitialized or incorrect object type to a `geode-conversion` function, often due to a failure in loading the initial mesh data.","error":"TypeError: argument 'mesh_object': 'NoneType' object cannot be converted to 'geode_conversion.MeshType'"}]}