Pipe data

GHEtool supports both U-type and coaxial type heat exchangers. You can use:

1. Multiple U-tubes

2. Single U-tubes (special case of multiple U-tubes)

3. Double U-tubes (special case of multiple U-tubes)

4. Coaxial pipe

All of the classes above are children from the abstract _PipeData class.

class GHEtool.VariableClasses.PipeData._PipeData._PipeData(k_g: Optional[float] = None, k_p: Optional[float] = None, epsilon: float = 1e-06)

Bases: BaseClass, ABC

Contains information regarding the pipe data of the borefield.

Parameters

k_gfloat

Grout thermal conductivity [W/mK]

k_pfloat

Pipe thermal conductivity [W/mK]

epsilonfloat

Pipe roughness [m]

abstract Re(fluid_data: FluidData) → float

Reynolds number.

Parameters

fluid_data: FluidData

Fluid data

Returns

Reynolds numberfloat

abstract calculate_resistances(fluid_data: FluidData) → None

This function calculates the conductive and convective resistances, which are constant.

Parameters

fluid_dataFluidData

Fluid data

Returns

None

abstract draw_borehole_internal(r_b: float) → None

This function draws the internal structure of a borehole. This means, it draws the pipes inside the borehole.

Parameters

r_bfloat

Borehole radius [m]

Returns

None

abstract pipe_model(fluid_data: FluidData, k_s: float, borehole: Borehole) → _BasePipe

This function returns the BasePipe model.

Parameters

fluid_dataFluidData

Fluid data

k_sfloat

Ground thermal conductivity

boreholeBorehole

Borehole object

Returns

BasePipe

class GHEtool.VariableClasses.PipeData.MultipleUTube.MultipleUTube(k_g: Optional[float] = None, r_in: Optional[float] = None, r_out: Optional[float] = None, k_p: Optional[float] = None, D_s: Optional[float] = None, number_of_pipes: int = 1, epsilon: float = 1e-06)

Bases: _PipeData

Contains information regarding the Multiple U-Tube class.

Parameters

k_gfloat

Grout thermal conductivity [W/mK]

r_infloat

Inner pipe radius [m]

r_outfloat

Outer pipe radius [m]

k_pfloat

Pipe thermal conductivity [W/mK]

D_sfloat

Distance of the pipe until center [m]

number_of_pipesint

Number of pipes [#] (single U-tube: 1, double U-tube:2)

epsilonfloat

Pipe roughness [m]

Re(fluid_data: FluidData) → float

Reynolds number.

Parameters

fluid_data: FluidData

fluid data

Returns

Reynolds numberfloat

calculate_resistances(fluid_data: FluidData) → None

This function calculates the conductive and convective resistances, which are constant.

Parameters

fluid_dataFluidData

Fluid data

Returns

None

draw_borehole_internal(r_b: float) → None

This function draws the internal structure of a borehole. This means, it draws the pipes inside the borehole.

Parameters

r_bfloat

Borehole radius [m]

Returns

None

pipe_model(fluid_data: FluidData, k_s: float, borehole: Borehole) → _BasePipe

This function returns the BasePipe model.

Parameters

fluid_dataFluidData

Fluid data

k_sfloat

Ground thermal conductivity

boreholeBorehole

Borehole object

Returns

BasePipe

class GHEtool.VariableClasses.PipeData.SingleUTube.SingleUTube(k_g: Optional[float] = None, r_in: Optional[float] = None, r_out: Optional[float] = None, k_p: Optional[float] = None, D_s: Optional[float] = None, epsilon: float = 1e-06)

Bases: MultipleUTube

Class for the single U-Tube borehole.

Parameters

k_gfloat

Grout thermal conductivity [W/mK]

r_infloat

Inner pipe radius [m]

r_outfloat

Outer pipe radius [m]

k_pfloat

Pipe thermal conductivity [W/mK]

D_sfloat

Distance of the pipe until center [m]

epsilonfloat

Pipe roughness [m]

class GHEtool.VariableClasses.PipeData.DoubleUTube.DoubleUTube(k_g: Optional[float] = None, r_in: Optional[float] = None, r_out: Optional[float] = None, k_p: Optional[float] = None, D_s: Optional[float] = None, epsilon: float = 1e-06)

Bases: MultipleUTube

Class for the double U-Tube borehole.

Parameters

k_gfloat

Grout thermal conductivity [W/mK]

r_infloat

Inner pipe radius [m]

r_outfloat

Outer pipe radius [m]

k_pfloat

Pipe thermal conductivity [W/mK]

D_sfloat

Distance of the pipe until center [m]

epsilonfloat

Pipe roughness [m]

class GHEtool.VariableClasses.PipeData.CoaxialPipe.CoaxialPipe(r_in_in: Optional[float] = None, r_in_out: Optional[float] = None, r_out_in: Optional[float] = None, r_out_out: Optional[float] = None, k_p: Optional[float] = None, k_g: Optional[float] = None, epsilon: float = 1e-06, is_inner_inlet: bool = True, k_p_out: Optional[float] = None)

Bases: _PipeData

Contains information regarding the Coaxial pipe class.

Parameters

r_in_infloat

Inner radius of the inner annulus [m]

r_in_outfloat

Outer radius of the inner annulus [m]

r_out_infloat

Inner radius of the outer annulus [m]

r_out_outfloat

Outer radius of the outer annulus [m]

k_pfloat

Pipe thermal conductivity of the inner and outer pipe [W/mK]. If k_p_out is set, k_p is only used for the conductivity of the inner pipe.

k_gfloat

Thermal conductivity of the grout [W/mK]

epsilonfloat

Pipe roughness of the tube [m]

is_inner_inletbool

True if the inlet of the fluid is through the inner annulus

k_p_outfloat

Pipe conductivity of the outer pipe [W/mK]. If None, it is assumed that the outer pipe has the same conductivity as the inner pipe (k_p).

Re(fluid_data: FluidData) → float

Reynolds number. Note: This code is based on pygfunction, ‘convective_heat_transfer_coefficient_concentric_annulus’ in the Pipes class.

Parameters

fluid_data: FluidData

fluid data

Returns

Reynolds numberfloat

calculate_resistances(fluid_data: FluidData) → None

This function calculates the conductive and convective resistances, which are constant.

Parameters

fluid_dataFluidData

Fluid data

Returns

None

draw_borehole_internal(r_b: float) → None

This function draws the internal structure of a borehole. This means, it draws the pipes inside the borehole.

Parameters

r_bfloat

Borehole radius [m]

Returns

None

pipe_model(fluid_data: FluidData, k_s: float, borehole: Borehole) → _BasePipe

This function returns the BasePipe model.

Parameters

fluid_dataFluidData

Fluid data

k_sfloat

Ground thermal conductivity

boreholeBorehole

Borehole object

Returns

BasePipe