Skip to main content

Python library allowing reading/writing GeoStudio .gsz files

Project description


Python library allowing reading/writing GeoStudio .gsz file. But, why do you need an external software such as Python to read your file while GeoStudio possess graphical tool to create your analysis and visualize your data ?

  1. Automatise your numerical model processing without the need to export it in Excel
  2. Harness the power of Python to treat your data
  3. Make quality plots using matplotlib
  4. Modify analysis without using the graphical interface
  5. Program analysis (e.g. the same analysis but with different parameters)
  6. Perform automatic calibration / optimisation
  7. The idea you have in mind which is not included in the 6 before

Use case (TODO)

  • Scripting
  • Statistical modelling / Sensitivity analysis
  • Automatic calibration
  • Design optimization
  • Real-time forecast and predictive modelling
  • Model converger
  • Post-processing (Paraview, Matplotlib)


  1. Clone or download this repository

  2. Go into the (extracted) folder and run pip install .


One example is provided in the folder example. It contains the rapid_drawdown tutorial problem found on GeoStudio website. In this example, PyGeoStudio is used to plot the overall problem and to plot the evolution of the pore wwater pressure at a given point.


  • Improve reading
  • Implement writing (to modify the input file)
  • Solve analysis directly in Python
  • Loop over input - solve - output to allow optimization
  • Other examples


Every contribution is welcome! Note this is a brand new project for me, and that I develop the library based on my need. If you have a particular problem with GeoStudio you want to solve with Python, just let me know, and I would figure out what I can do to help you.

If you like this project, please star it! It will encourage me to pursuit its development.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyGeoStudio-0.2.0.tar.gz (15.5 kB view hashes)

Uploaded Source

Built Distribution

PyGeoStudio-0.2.0-py3-none-any.whl (17.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page