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⁻¹]