Geosoft GX for Python Repository
This is the repository for Seequent's Geosoft GX Developer support for Python development. Refer to the documentation for more information.
From release 9.6, tutorials for various subjects are available as Jupyter Notebooks, and are added as subjects are developed. See the following github page for what is currently available:
https://github.com/GeosoftInc/gxpy/tree/master/examples/jupyter_notebooks/Tutorials (Select the branch that matches the GX Developer version you are working with.)
If you are new to GX Developer, refer to the GX Developer tutorial that is documented as part of the 9.3 release.
Also see the Geosoft organization on Github for the other programming language specific repos.
Quick Start
Configuration
See Python Configuration Menu to install a Python menu that simplifies Python configuration for an Oasis montaj installation.
To update an existing Python installation, load the Python menu from your User Menus and select Python > Configure Python... > update geosoft package.
If you encounter problems due to a non-standard installation you can also update Python manually (see below).
Manual Configuration
Uninstall Geosoft from Python, then install version 2022.1 as follows (you must have the Geosoft Desktop 2022.1 platform installed).
pip uninstall geosoft
pip install geosoft
Or, alternately:
pip install geosoft --upgrade
Version Compatibility
The base GX API, which is exposed to Python by the geosoft.gxapi module, is consistent across versions. This means that earlier versions of geosoft.pxpy will work with Geosoft Desktop 2022.1. While we recommend that older scripts be updated to conform to the 2022.1 API, should you need support for multiple versions of geosoft.gxpy you can create separate Anaconda Python environments for each version. For example, you might create an environment 'py36_gx20212' for Python 3.6 and the GX API version 2021.2 or 'py37_gx20221' for Python 3.7 and GX Developer 2022.1. If you do not depend on earlier versions of the GX Developer Python API it is best to use only the most recently released API.
Vesion 2022.1 supports Python 3.6, 3.7, 3.8 and 3.9.
If you need Python 3.4 support, install geosoft version 9.2.1, which will work with both Geosoft Desktop versions 9.2 and 9.5, but will not contain any methods and classes introduced since version 9.2.
If you need Python 3.5 support, install geosoft version 9.5, which will work with both Geosoft Desktop and redistributable versions 9.5 and 9.6, but will not contain any methods and classes introduced since version 9.6.
License
Any source code found here are released under the BSD 2-clause license. Core functionality exposed by the GX API may have additional license implications. For more information consult the License page in the GX Developer Wiki