From fd6858f5c0a34ba07cfeb44048970f412d7e7d0d Mon Sep 17 00:00:00 2001 From: korevaarzer Date: Mon, 16 Mar 2026 09:16:38 +0100 Subject: [PATCH 1/2] Add to the docs: requirement of local_time column in the heat load or flow rate time-profile to allow for smoothing --- docs/manual/loadflow_configuration.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/manual/loadflow_configuration.md b/docs/manual/loadflow_configuration.md index 4f25eca..e0dbd30 100644 --- a/docs/manual/loadflow_configuration.md +++ b/docs/manual/loadflow_configuration.md @@ -87,10 +87,9 @@ For a variable flow rate, an example of such a file is provided in the `input` s [BHE with a daily-variable flow rate profile](../examples/variable_flow_rate/variable_flow_rate.md) > **_NOTE:_** The heat load in the CSV datafile has unit kW and the first four rows in the datafile are considered header lines; -> make sure the column names are defines in row 4. +> make sure the column names are defined in row 4. - -> The simulation internally operates on a uniform time array, which is generated based on the parameters `nyear` and `nled` +> **_NOTE:_** The simulation internally operates on a uniform time array, which is generated based on the parameters `nyear` and `nled` > in the main simulation configuration. Both heat load and flow rate profiles are interpolated or indexed to match this simulation time array. When using a pre-defined heat load or flow rate profile, it is possible to apply a smoothing factor over time, that averages short-term fluctuations. @@ -99,6 +98,9 @@ For an example of using a smoothed heat load, see the example of a [BHE field in In addition, the pre-defined heat load or flow rate can be scaled using the parameter `**_scale`. For the heat load this scaling factor represents the dwelling equivalent (DE) of power. I.e. the heat load is increased by a factor that is equal to the amount of extra dwellings that are supplied. +> **_NOTE:_** To apply a smoothing factor to the pre-defined heat load or flow rate profile, a column named "local_time" is required +> in the input CSV file, that includes the timestamps for the data column. + For a pre-defined heat load profile or a variable heat load following a cosine pattern, the flow rate in the main model configuration (`m_flow`) is automatically scaled such that the ratio of the required pumping power to the generated power (or the COP of the -- GitLab From 561b39911384348ec2cd0a4b56d700d8548fb6ff Mon Sep 17 00:00:00 2001 From: korevaarzer Date: Mon, 16 Mar 2026 09:17:00 +0100 Subject: [PATCH 2/2] Increment package version --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index aeaba3b..9eb18e2 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "geoloop" -version = "1.0.5" +version = "1.0.6" description = "This is a Python package for simulation of (deep) vertical Borehole Heat Exchanger (BHE) systems" authors = [ { name = "Zanne Korevaar", email = "zanne.korevaar@tno.nl" }, -- GitLab