diff --git a/README.md b/README.md index 3366dd0be5275d1c9e589bcbec6b049006273625..7cba212b6e05aeb9b6f64f43f7fe570866eaea8e 100644 --- a/README.md +++ b/README.md @@ -3,17 +3,23 @@ [![PyPI](https://img.shields.io/pypi/v/geoloop.svg)](https://pypi.org/project/geoloop/) [![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://geoloop-8f7a36.ci.tno.nl/) -## What is *Geoloop*? +## What is **Geoloop**? -*Geoloop* is a Python package for evaluating borehole heat exchanger (BHE) performance -with depth-dependent thermal properties, temperature profiles, and borehole design options. +**Geoloop** is a Python package for simulating borehole heat exchanger (BHE) systems, +with a focus on optimal implementation of subsurface thermal properties and their impact on system performance. -It integrates realistic subsurface models to improve simulation reliability and supports -informed decision-making for both research and practical applications. +**Geoloop** incorporates (uncertainty in) depth-variations in subsurface thermal conductivity, subsurface temperature, +BHE design and diverse operational boundary conditions such as seasonal load variations or +minimum fluid temperatures, in a tool for deterministic or stochastic performance analyses with the opportunity +for optimization of the system design and operation. This makes Geoloop ideal for scenario analyses and sensitivity +studies in both research and practical applications. -The package is based on thermal response factors (or *g*-functions) for borehole heat exchangers, calculated -using an analytical solution to the Finite Line Source model. The model set-up with *g*-functions is extended -into a stacked, depth-dependent formulation for depth-dependent thermal response calculations. +**Geoloop** uses thermal response factors (*g*-functions) calculated using the analytical Finite Line Source model from +the *pygfunction* package. This setup is extended into a stacked approach for depth-dependent thermal response calculations. +A detailed description and benchmark of this depth-dependent semi-analytical method is provided in Korevaar & Van Wees (in prep.). +**Geoloop's** generic framework allows for easy switching between simulation methods, including the innovative depth-dependent +semi-analytical approach, the depth-uniform implementation of g-functions as implemented in *pygfunction* and a numerical +finite volume approach. --- @@ -25,14 +31,14 @@ Install from PyPI using: pip install geoloop ``` -For detailed setup instructions (including Pixi-based environments and development setup), +For detailed setup instructions (including uv-based environments and development setup), see the [Installation Guide](https://geoloop-8f7a36.ci.tno.nl/installation/install/). --- ## Requirements -Geoloop requires **Python 3.10 or higher**. +Geoloop requires **Python 3.12 or higher**. Core dependencies include: - pygfunction @@ -72,3 +78,7 @@ See the [LICENSE.md](LICENSE.md) file for details. ## Acknowledgments Developed with the support of the Dutch funding agency **RVO**, in a consortium project with grant nr. MOOI322009. + +--- + + diff --git a/docs/index.md b/docs/index.md index c95eb91bb08d7137c8c61cb9d9cc40d4a8bd86e7..b17ef2f9a2415c0c93a5fcc16086adabd8c24e76 100644 --- a/docs/index.md +++ b/docs/index.md @@ -6,17 +6,21 @@

-*Geoloop* is a Python package for simulation of borehole heat exchanger (BHE) systems. It offers -broad functionality for fast calculations of BHE system performance, while including uncertainty in subsurface -thermal properties and operational conditions. +**Geoloop** is a Python package for simulating borehole heat exchanger (BHE) systems, +with a focus on optimal implementation of subsurface thermal properties and their impact on system performance. -*Geoloop* incorporates depth-variations in subsurface thermal conductivity, subsurface temperature, and -borehole design, and diverse operational boundary conditions such as seasonal load variations or -minimum fluid temperatures in a tool for deterministic or stochastic performance analyses with the opportunity +**Geoloop** incorporates (uncertainty in) depth-variations in subsurface thermal conductivity, subsurface temperature, +BHE design and diverse operational boundary conditions such as seasonal load variations or +minimum fluid temperatures, in a tool for deterministic or stochastic performance analyses with the opportunity for optimization of the system design and operation. This makes Geoloop ideal for scenario analyses and sensitivity -studies. - -It offers a tool to support informed decision-making in both research and practical applications. +studies in both research and practical applications. + +**Geoloop** uses thermal response factors (*g*-functions) calculated using the analytical Finite Line Source model from +the *pygfunction* package. This setup is extended into a stacked approach for depth-dependent thermal response calculations. +A detailed description and benchmark of this depth-dependent semi-analytical method is provided in Korevaar & Van Wees (in prep.). +**Geoloop's** generic framework allows for easy switching between simulation methods, including the innovative depth-dependent +semi-analytical approach, the depth-uniform implementation of g-functions as implemented in *pygfunction* and a numerical +finite volume approach. --- diff --git a/docs/installation/install.md b/docs/installation/install.md index e4d1b82b95238a4045815451f3e5bb61a68c623c..bc12f83b7c4dc7a62ce458d11d0b1bf49da57e79 100644 --- a/docs/installation/install.md +++ b/docs/installation/install.md @@ -15,7 +15,7 @@ pip install geoloop This installs *Geoloop* along with its required dependencies. -Geoloop requires **Python 3.12 or newer**. +Geoloop requires **Python 3.12 or higher**. --- diff --git a/pyproject.toml b/pyproject.toml index 742c83a049bb0a3d0bf929af65a54af37f574535..b079eac314ba6dbb316949986093d5fbea78dd9d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,20 +1,22 @@ +[build-system] +requires = ["setuptools>=61", "wheel"] +build-backend = "setuptools.build_meta" + [project] name = "geoloop" version = "1.0.0" -description = "This is a Python code for simulationo of (deep) Borehole Heat Exchangers (BHEs)" -readme = "README.md" -license = { text = "Apache 2.0" } +description = "This is a Python package for simulation of (deep) Borehole Heat Exchanger (BHE) systems" authors = [ { name = "Zanne Korevaar", email = "zanne.korevaar@tno.nl" }, - { name = "Jan-Diederik", email = "jan_diederik.vanwees@tno.nl" } + { name = "Jan-Diederik van Wees", email = "jan_diederik.vanwees@tno.nl" } ] +readme = "README.md" +license = { file = "LICENSE" } +requires-python = ">=3.12,<3.14" keywords = [ - "BHE", "geothermal", "ground source heat pump", - "deep borehole heat exchanger", "geoloop" + "borehole heat exchanger", "BHE", "geothermal", "ground-source heat pump", + "deep borehole heat exchanger" ] - -requires-python = ">=3.12,<3.14" - dependencies = [ "pygfunction>=2.2.2", "matplotlib>=3.10.1", @@ -47,10 +49,6 @@ dev = [ "mkdocstrings-python>=1.18.2", ] -[build-system] -requires = ["setuptools>=61", "wheel"] -build-backend = "setuptools.build_meta" - [tool.setuptools.packages.find] where = ["src"] diff --git a/setup.py b/setup.py deleted file mode 100644 index 21de9df672b3e163ae60e874ebaf3a478b46a9c2..0000000000000000000000000000000000000000 --- a/setup.py +++ /dev/null @@ -1,8 +0,0 @@ -from setuptools import find_packages, setup - -setup( - name="geoloop", - version="1.0.0", - packages=find_packages(), - install_requires=[], -)