**pyThermoGIS** is a Python package that provides API access to the [ThermoGIS](https://www.thermogis.nl/en)geothermal simulation software. The simulations are conducted in Java, and this package uses [JPype](https://jpype.readthedocs.io/en/latest/userguide.html) to create a Python-Java binding.
**pyThermoGIS** is a Python package that provides API access to the [ThermoGIS](https://www.thermogis.nl/en)doublet simulations and economic calculations.
It uses [xarray](https://docs.xarray.dev/en/stable/index.html)`Dataset` as input and can be combined with the [pygridsio](https://pypi.org/project/pygridsio/) package to read and process 2D raster data.
This package allows a user to simulate geothermal doublets providing the following parameters:
- Top depth
- Thickness (mean & standard deviation)
- Porosity
- Permeability (mean & standard deviation)
- Temperature (Optional: if not provided, a temperature gradient will be used)
The code will simulate a Geothermal doublet, utilizing ThermoGIS with DoubletCalc1D as the engine to produce values of:
- power [Mega Watt Hour]
- heat pump power [Mega Watt Hour]
- capex (Capital expenditure) [Million €]
- opex (Operational expenditure) [€/kW]
- utc (Unit Technical Cost [€cent/kWH])
- npv (Net-present-value)
- hprod (Discounted Heat Produced)
- cop
- cophp
- pressure
- flow rate [m³/hr]
- well depth [m]
For details on how these parameters are calculated we refer users to the [Thermogis calculation webpage](https://www.thermogis.nl/en/calculation-model)
The simulations are conducted in Java, and this package uses [JPype](https://jpype.readthedocs.io/en/latest/userguide.html) to create a Python-Java binding.
It uses [xarray](https://docs.xarray.dev/en/stable/index.html)`Dataset` to handle input and output parameters.
This module can be combined with the [pygridsio](https://pypi.org/project/pygridsio/) package to read and process 2D raster data.
---
@@ -10,7 +37,9 @@ It uses [xarray](https://docs.xarray.dev/en/stable/index.html) `Dataset` as inpu
### 1. Install Java 17 and Download the ThermoGIS JAR
This module requires a Java 17 VM. We recommend using [Amazon Corretto 17](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/downloads-list.html).
This package requires a Java 17 VM (we recommend using [Amazon Corretto 17](https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/downloads-list.html)) and a ThermoGIS Jar file (Version >=1.7).
*(You can find the JAR in this repository's resources folder or request it via the [ThermoGIS website](https://www.thermogis.nl/).)*
#### 🧱 Required Environment Variables
@@ -18,7 +47,6 @@ This module requires a Java 17 VM. We recommend using [Amazon Corretto 17](https
*(e.g., on Windows: `C:\Program Files\Amazon Corretto\jdk17.0.0_0`)*
-`THERMOGIS_JAR`: Path to the ThermoGIS `.jar` file
*(You can find the JAR in this repository's resources folder or request it via the [ThermoGIS website](https://www.thermogis.nl/).)*