r.green.biomassfor.legal

Estimates potential bioenergy depending on forest increment, forest management and forest treatment

r.green.biomassfor.legal forest=name boundaries=name [energy_tops_hf=float] [forest_column_yield=string] [forest_column_yield_surface=string] [forest_column_management=string] [forest_column_treatment=string] [output_basename=name] [energy_cormometric_vol_hf=float] [energy_tops_cop=float] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.green.biomassfor.legal forest=name boundaries=name

grass.script.run_command("r.green.biomassfor.legal", forest, boundaries, energy_tops_hf=0.49, forest_column_yield="yield", forest_column_yield_surface="yield_surface", forest_column_management="management", forest_column_treatment="treatment", output_basename="biomassfor", energy_cormometric_vol_hf=1.97, energy_tops_cop=0.55, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.green.biomassfor.legal", forest="name", boundaries="name")

Parameters

Command linePython (grass.script)

forest=name [required]
    Name of vector parcel map
    Name of vector parcel map
boundaries=name [required]
    Name of vector boundaries map (boolean map)
    Name of vector boundaries map (boolean map)
energy_tops_hf=float
    Energy for tops and branches in high forest in MWh/m3
    Default: 0.49
forest_column_yield=string
    Vector field of yield
    Default: yield
forest_column_yield_surface=string
    Vector field of stand surface (ha)
    Default: yield_surface
forest_column_management=string
    Vector field of forest management (1: high forest, 2:coppice)
    Default: management
forest_column_treatment=string
    Vector field of forest treatment (1: final felling, 2:thinning)
    Default: treatment
output_basename=name
    Basename for potential bioenergy (HF,CC and total)
    Default: biomassfor
energy_cormometric_vol_hf=float
    Energy for the whole tree in high forest (tops, branches and stem) in MWh/m3
    Default: 1.97
energy_tops_cop=float
    Energy for tops and branches for Coppices in MWh/m3
    Default: 0.55
--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

forest : str, required
    Name of vector parcel map
    Name of vector parcel map
    Used as: input, vector, name
boundaries : str, required
    Name of vector boundaries map (boolean map)
    Name of vector boundaries map (boolean map)
    Used as: input, vector, name
energy_tops_hf : float, optional
    Energy for tops and branches in high forest in MWh/m3
    Default: 0.49
forest_column_yield : str, optional
    Vector field of yield
    Default: yield
forest_column_yield_surface : str, optional
    Vector field of stand surface (ha)
    Default: yield_surface
forest_column_management : str, optional
    Vector field of forest management (1: high forest, 2:coppice)
    Default: management
forest_column_treatment : str, optional
    Vector field of forest treatment (1: final felling, 2:thinning)
    Default: treatment
output_basename : str, optional
    Basename for potential bioenergy (HF,CC and total)
    Used as: output, , name
    Default: biomassfor
energy_cormometric_vol_hf : float, optional
    Energy for the whole tree in high forest (tops, branches and stem) in MWh/m3
    Default: 1.97
energy_tops_cop : float, optional
    Energy for tops and branches for Coppices in MWh/m3
    Default: 0.55
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

Compute the legal biomass forestry residual potential, based on the annual/periodic forest yield.

NOTES

This module permits to evalute the maximum bio-energy from forest residual available in a particular area, on the base of the prescribed yield. The mandatory data input are a vector file with fields with values of yield, management, treatment, and forest surface. The yield value is expressed in cubic meters, the forest surface in hectares, the management is an integer value that can be 1 for high forest and 2 for coppice, the treatment is an integer field that can be 1 for final felling and 2 for thinning. The energy section contains the calorific parameters that permits to convert the biomass in energy. The output maps are expressed in Mwh.

EXAMPLE

This example shows a typical input vector file with a table composed by fields of increment, forest surface, management and treatment. This example is based on data of Maè Valley, one of the test area of the R.green project


yield	surface	management	treatment
35.87	800	1	1
16.48	700	1	2
24.82	300	2	1

r.green.biomassfor.legal --overwrite forest=forest@biomasfor boundaries=Boundary@biomasfor forest_column_yield=yield forest_column_yield_surface=surface forest_column_management=management forest_column_treatment=treatment energy_tops_hs=0.49 energy_cormometric_vol_hf=1.97 energy_tops_cops=0.55 output_basename=mae

The output map is a standardize energy map with the pixel value equal to the corresponding bioenergy stimated.

REFERENCE

Sacchelli, S., Zambelli, P., Zatelli, P., Ciolli, M., 2013. Biomasfor - an open-source holistic model for the assessment of sustainable forest bioenergy. iFor. Biogeosci. For. 6, 285-293

AUTHORS

Francesco Geri, Pietro Zambelli, Sandro Sacchelli, Marco Ciolli

SOURCE CODE

Available at: r.green.biomassfor.legal source code (history)
Latest change: Friday Feb 21 10:10:05 2025 in commit 7d78fe3