r.green.gshp.technical
Calculate the Ground Source Heat Pump technical potential using the ASHRAE method.
r.green.gshp.technical [-d] ground_conductivity=name [ground_diffusivity_rast=name] [ground_diffusivity_value=double] [ground_temp_rast=name] [ground_temp_value=double] [g_loads_6h_rast=name] [g_loads_6h_value=double] [g_loads_1m_rast=name] [g_loads_1m_value=double] [g_loads_1y_rast=name] [g_loads_1y_value=double] [fluid_capacity=double] [fluid_massflow=double] [fluid_inlettemp=double] [bh_radius=double] [bh_convection=double] [bh_resistence=double] [pipe_inner_radius=double] [pipe_outer_radius=double] [pipe_distance=double] [k_pipe=double] [k_grout=double] [field_distance=double] [field_number=integer] [field_ratio=double] [bhe_length=name] [bhe_field_length=name] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]
Example:
r.green.gshp.technical ground_conductivity=name
grass.script.run_command("r.green.gshp.technical", ground_conductivity, ground_diffusivity_rast=None, ground_diffusivity_value=0.086, ground_temp_rast=None, ground_temp_value=10., g_loads_6h_rast=None, g_loads_6h_value=60., g_loads_1m_rast=None, g_loads_1m_value=15., g_loads_1y_rast=None, g_loads_1y_value=5., fluid_capacity=4200., fluid_massflow=0.050, fluid_inlettemp=2., bh_radius=0.06, bh_convection=1.52, bh_resistence=nan, pipe_inner_radius=0.01365, pipe_outer_radius=0.0167, pipe_distance=0.0511, k_pipe=0.42, k_grout=1.52, field_distance=6.1, field_number=2, field_ratio=1.2, bhe_length=None, bhe_field_length=None, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("r.green.gshp.technical", ground_conductivity="name")
Parameters
ground_conductivity=name [required]
Raster with depth-averaged ground thermal conductivity lambda [W m-1 K-1]
ground_diffusivity_rast=name
Raster with depth-averaged ground diffusivity [m2 day-1]
ground_diffusivity_value=double
Value with depth-averaged ground diffusivity [m2 day-1]
Default: 0.086
ground_temp_rast=name
Raster with the initial ground temperature T0 [degrees C]
ground_temp_value=double
Value with the initial ground temperature T0 [degrees C]
Default: 10.
g_loads_6h_rast=name
Peak of the maximum 6 hourly ground loads [W]
g_loads_6h_value=double
Peak of the maximum 6 hourly ground loads [W]
Default: 60.
g_loads_1m_rast=name
Month with the maximum ground loads [W]
g_loads_1m_value=double
Month with the maximum ground loads [W]
Default: 15.
g_loads_1y_rast=name
Yearly average ground loads [W]
g_loads_1y_value=double
Yearly average ground loads [W]
Default: 5.
fluid_capacity=double
Fluid capacity Cp [J kg-1 K-1]
Default: 4200.
fluid_massflow=double
Fluid massflow [kg s-1 kW-1]
Default: 0.050
fluid_inlettemp=double
Inlet temperature [degrees C]
Default: 2.
bh_radius=double
Borehole radius [m]
Default: 0.06
bh_convection=double
Internal convection coefficient [W m-2 K-1]
Default: 1.52
bh_resistence=double
Borehole thermal resistence [m K W-1]
Default: nan
pipe_inner_radius=double
Borehole pipe inner radius [m]
Default: 0.01365
pipe_outer_radius=double
Borehole pipe outer radius [m]
Default: 0.0167
pipe_distance=double
Center-to-center distance between pipes [m]
Default: 0.0511
k_pipe=double
Pipe thermal conductivity [W m-1 K-1]
Default: 0.42
k_grout=double
Grout thermal conductivity [W m-1 K-1]
Default: 1.52
field_distance=double
Distance between boreholes heat exchanger
Default: 6.1
field_number=integer
Number of borehole heat exchanger
Default: 2
field_ratio=double
Borefield aspect ratio
Default: 1.2
bhe_length=name
Name of output raster map with the geothermal length of the BHE [m]
bhe_field_length=name
Name of output raster map with the geothermal length of the BHE field [m]
-d
Debug with intermediate maps
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
ground_conductivity : str, required
Raster with depth-averaged ground thermal conductivity lambda [W m-1 K-1]
Used as: input, raster, name
ground_diffusivity_rast : str, optional
Raster with depth-averaged ground diffusivity [m2 day-1]
Used as: input, raster, name
ground_diffusivity_value : float, optional
Value with depth-averaged ground diffusivity [m2 day-1]
Used as: double
Default: 0.086
ground_temp_rast : str, optional
Raster with the initial ground temperature T0 [degrees C]
Used as: input, raster, name
ground_temp_value : float, optional
Value with the initial ground temperature T0 [degrees C]
Used as: double
Default: 10.
g_loads_6h_rast : str, optional
Peak of the maximum 6 hourly ground loads [W]
Used as: input, raster, name
g_loads_6h_value : float, optional
Peak of the maximum 6 hourly ground loads [W]
Used as: double
Default: 60.
g_loads_1m_rast : str, optional
Month with the maximum ground loads [W]
Used as: input, raster, name
g_loads_1m_value : float, optional
Month with the maximum ground loads [W]
Used as: double
Default: 15.
g_loads_1y_rast : str, optional
Yearly average ground loads [W]
Used as: input, raster, name
g_loads_1y_value : float, optional
Yearly average ground loads [W]
Used as: double
Default: 5.
fluid_capacity : float, optional
Fluid capacity Cp [J kg-1 K-1]
Used as: double
Default: 4200.
fluid_massflow : float, optional
Fluid massflow [kg s-1 kW-1]
Used as: double
Default: 0.050
fluid_inlettemp : float, optional
Inlet temperature [degrees C]
Used as: double
Default: 2.
bh_radius : float, optional
Borehole radius [m]
Used as: double
Default: 0.06
bh_convection : float, optional
Internal convection coefficient [W m-2 K-1]
Used as: double
Default: 1.52
bh_resistence : float, optional
Borehole thermal resistence [m K W-1]
Used as: double
Default: nan
pipe_inner_radius : float, optional
Borehole pipe inner radius [m]
Used as: double
Default: 0.01365
pipe_outer_radius : float, optional
Borehole pipe outer radius [m]
Used as: double
Default: 0.0167
pipe_distance : float, optional
Center-to-center distance between pipes [m]
Used as: double
Default: 0.0511
k_pipe : float, optional
Pipe thermal conductivity [W m-1 K-1]
Used as: double
Default: 0.42
k_grout : float, optional
Grout thermal conductivity [W m-1 K-1]
Used as: double
Default: 1.52
field_distance : float, optional
Distance between boreholes heat exchanger
Used as: double
Default: 6.1
field_number : int, optional
Number of borehole heat exchanger
Used as: integer
Default: 2
field_ratio : float, optional
Borefield aspect ratio
Used as: double
Default: 1.2
bhe_length : str, optional
Name of output raster map with the geothermal length of the BHE [m]
Used as: output, raster, name
bhe_field_length : str, optional
Name of output raster map with the geothermal length of the BHE field [m]
Used as: output, raster, name
flags : str, optional
Allowed values: d
d
Debug with intermediate maps
overwrite: bool, optional
Allow output files to overwrite existing files
Default: False
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
r.green.gshp.technical calculates the lenght of the borehole for Groud Source Heat Pump plants.
NOTES
The required inputs are the ground source conductivity and the ground loads.
EXAMPLES
python r.green.gshp.technical.py --overwrite ground_conductivity=g_conductivity ground_diffusivity_rast=g_diffusivity ground_temp_rast=g_temperature g_loads_6h_rast=g_loads_6h g_loads_1m_rast=g_loads_1m g_loads_1y_rast=g_loads_1y fluid_capacity=4000. fluid_massflow=0.074 fluid_inlettemp=4.44 bh_radius=0.054 pipe_inner_radius=0.01365 pipe_outer_radius=0.0167 bh_convection=1000. pipe_distance=0.0471 k_pipe=0.45 k_grout=1.73 field_distance=6.1 field_number=120 field_ratio=1.2 bhe_length=len_bhe bhe_field_length=len_bhe_field -d
SEE ALSO
AUTHOR
Pietro Zambelli (Eurac Research, Bolzano, Italy)
SOURCE CODE
Available at: r.green.gshp.technical source code
(history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819