climag.modvege_consumption#
Functions for computing harvested and ingested biomass
References#
- climag.modvege_consumption.organic_matter_digestibility(ts_vals: dict[str, float], params: dict[str, float])#
Organic matter digestibility
Parameters#
- ts_valsdict
Dictionary with intermediate time series values
- paramsdict
Dictionary of model parameters
Returns#
- dict
Updated ts_vals dictionary
Notes#
Organic matter digestibility of the green vegetative (GV) and green reproductive (GR) compartments. See Equations (9) and (10) in [1].
Digestibility varies among plant parts, with leaves usually being more digestible than stems. The differing digestibility of plant parts may explain why they are grazed selectively. Digestibility of green compartments decreases linearly with compartment age.
This function returns an updated ts_vals dictionary with:
omd_gv: Organic matter digestibility of the GV compartment [dimensionless]
omd_gr: Organic matter digestibility of the GR compartment [dimensionless]
- climag.modvege_consumption.biomass_ingestion(ts_vals: dict[str, float], params: dict[str, float])#
Biomass ingestion through grazing
Parameters#
- ts_valsdict
Dictionary of intermediate time series values
- paramsdict
Dictionary containing of model parameters
Returns#
- dict
Updated ts_vals dictionary
Notes#
The maximum amount of biomass available for grazing and/or harvesting for each structural compartment.
Maintain the height of the residual biomass after harvest to the minimum residual grass height
The bulk density is used to convert this height to the equivalent biomass amount. See [1], sec. “Harvested biomass”, Equation (19)
The maximum amount of biomass ingestible based on the stocking rate
Ingestion takes precedence over harvesting
The amount of biomass ingested per livestock unit per day is 13 kg DM LU⁻¹ based on average consumption data for dairy cows from [2] and the value used by [3]
One livestock unit (LU) is equivalent to one dairy cow, based on [4]
The amount of biomass ingested in total for each structural compartment
This is weighted according to the organic matter digestibility.
Digestibility varies among plant parts, with leaves usually being more digestible than stems
The differing digestibility of plant parts may explain why they are grazed selectively
Assumption: when grazed/harvested, 10% of the available biomass in each structural component is lost.
This function returns an updated ts_vals dictionary with:
i_bm: The total ingested biomass amount [kg DM ha⁻¹]
bm_gv: Updated standing biomass of the green vegetative compartment [kg DM ha⁻¹]
bm_gr: Updated standing biomass of the green reproductive compartment [kg DM ha⁻¹]
bm_dv: Updated standing biomass of the dead vegetative compartment [kg DM ha⁻¹]
bm_dr: Updated standing biomass of the dead reproductive compartment [kg DM ha⁻¹]
- climag.modvege_consumption.biomass_harvest(ts_vals: dict[str, float], params: dict[str, float])#
Harvest biomass through a cutting event
Parameters#
- ts_valsdict
A dictionary with intermediate time series values.
- paramsdict
A dictionary containing of model parameters
Returns#
- dict
An updated ts_vals dictionary
Notes#
Harvest biomass through a cutting event at the end of the reproductive period. Maintain the height of the residual biomass after harvest to the minimum cut height. This height is calculated by using the bulk density. See [1], sec. “Harvested biomass”, Equation (19).
Assumption: during harvest, 10% of the harvestable biomass in each structural component is lost.
This function updated ts_vals dictionary with:
h_bm: The total harvested biomass amount [kg DM ha⁻¹]
bm_gv: Updated standing biomass of the green vegetative compartment [kg DM ha⁻¹]
bm_gr: Updated standing biomass of the green reproductive compartment [kg DM ha⁻¹]
bm_dv: Updated standing biomass of the dead vegetative compartment [kg DM ha⁻¹]
bm_dr: Updated standing biomass of the dead reproductive compartment [kg DM ha⁻¹]