carm.thermal_interference package

Submodules

carm.thermal_interference.fls module

Finite Line Source (FLS) module.

Computes the far-field thermal response of the borehole field using the Finite Line Source analytical model. Handles both single and multi-borehole configurations via a precomputed response matrix and a superposition scheme.

class carm.thermal_interference.fls.FiniteLineSolution[source]

Bases: object

Finite Line Source thermal response for a borehole field.

Precomputes the FLS response matrix at construction time and uses it at each time step to evaluate the borehole wall temperature perturbation via load superposition (convolution over the heat load history).

physicalmodel

Full physical model of the BHE system.

Type:

PhysicalModel

n_steps

Total number of simulation time steps.

Type:

int

time_hist

Array of cumulative simulation times [s], shape (n_steps,).

Type:

NDArray

response_matrix

Precomputed FLS response matrix of shape (n_steps + 1, n_bhes, n_bhes). Entry [t, i, j] is the unit thermal response at borehole j due to borehole i up to time step t.

Type:

NDArray

The numerical implementation of the integral follows the approach used in
pygfunction (Cimmino, 2018).
property response_matrix: ndarray[tuple[Any, ...], dtype[_ScalarT]]

Module contents

class carm.thermal_interference.FiniteLineSolution[source]

Bases: object

Finite Line Source thermal response for a borehole field.

Precomputes the FLS response matrix at construction time and uses it at each time step to evaluate the borehole wall temperature perturbation via load superposition (convolution over the heat load history).

physicalmodel

Full physical model of the BHE system.

Type:

PhysicalModel

n_steps

Total number of simulation time steps.

Type:

int

time_hist

Array of cumulative simulation times [s], shape (n_steps,).

Type:

NDArray

response_matrix

Precomputed FLS response matrix of shape (n_steps + 1, n_bhes, n_bhes). Entry [t, i, j] is the unit thermal response at borehole j due to borehole i up to time step t.

Type:

NDArray

The numerical implementation of the integral follows the approach used in
pygfunction (Cimmino, 2018).
property response_matrix: ndarray[tuple[Any, ...], dtype[_ScalarT]]