| Type: | Package |
| Title: | Calculate Soil Management Indicators for Agricultural Practice Assessment |
| Version: | 1.2.0 |
| Description: | Calculate numerical agricultural soil management indicators from on a management timeline of an arable field. Currently, indicators for carbon (C) input into the soil system, soil tillage intensity rating (STIR), number of soil cover and living plant cover days, N fertilization and livestock intensity, and plant diversity are implemented. An additional indicator estimates the stable organic matter of organic amendments. The functions can also be used independently of the management timeline to calculate some indicators. The package contains tables with reference information for the functions, as well as a '*.xlsx' template to collect the management data. |
| License: | MIT + file LICENSE |
| Encoding: | UTF-8 |
| LazyData: | true |
| Imports: | magrittr (≥ 2.0.3), dplyr (≥ 1.1.4), lubridate (≥ 1.9.2), ggplot2 (≥ 3.4.4), ggthemes (≥ 5.0.0), tidyr (≥ 1.3.0), tibble (≥ 3.2.1), readxl (≥ 1.4.3), Rdpack (≥ 2.6), jsonlite |
| Depends: | R (≥ 3.5) |
| Suggests: | jsonvalidate, openxlsx2, knitr, rmarkdown, testthat (≥ 3.0.0) |
| Config/testthat/edition: | 3 |
| VignetteBuilder: | knitr |
| RdMacros: | Rdpack |
| URL: | https://gitlab.com/SoilManageR/ |
| BugReports: | https://gitlab.com/SoilManageR/SoilManageR/-/work_items |
| Config/roxygen2/version: | 8.1.1 |
| NeedsCompilation: | no |
| Packaged: | 2026-11-17 09:50:31 UTC; mail |
| Author: | Olivier Heller |
| Maintainer: | Olivier Heller <olivier.heller@soilmanager.ch> |
| Repository: | CRAN |
| Date/Publication: | 2026-11-17 11:40:21 UTC |
SoilManageR: Calculate Soil Management Indicators for Agricultural Practice Assessment
Description
Calculate numerical agricultural soil management indicators from on a management timeline of an arable field. Currently, indicators for carbon (C) input into the soil system, soil tillage intensity rating (STIR), number of soil cover and living plant cover days, N fertilization and livestock intensity, and plant diversity are implemented. An additional indicator estimates the stable organic matter of organic amendments. The functions can also be used independently of the management timeline to calculate some indicators. The package contains tables with reference information for the functions, as well as a '*.xlsx' template to collect the management data.
Author(s)
Maintainer: Olivier Heller olivier.heller@soilmanager.ch (ORCID)
Authors:
Olivier Heller olivier.heller@soilmanager.ch (ORCID)
Other contributors:
Raphaël Wittwer raphael.wittwer@agroscope.admin.ch (ORCID) [contributor]
Agroscope [copyright holder, funder]
EJP SOIL [funder]
See Also
Useful links:
Report bugs at https://gitlab.com/SoilManageR/SoilManageR/-/work_items
Pipe operator
Description
See magrittr::%>% for details.
Usage
lhs %>% rhs
Arguments
lhs |
A value or the magrittr placeholder. |
rhs |
A function call using the magrittr semantics. |
Value
The result of calling 'rhs(lhs)'.
Estimate C and N inputs of organic amendments
Description
Estimates the carbon (C) and total nitrogen (N) input into the soil system by organic amendments.
Usage
CN_input_amendments(
amount,
amd_type = NA,
DMC = NA,
C_content = NA,
N_content = NA,
return.comment = FALSE,
concentration_liquids = 0.5,
unit = "t/ha",
N_availability = NA
)
Arguments
amount |
Amount of organic amendment in fresh weight (t/ha or m3/ha),
or in plant-available N (kg N_available/ha), see |
amd_type |
Type of organic manure, there are default values available for
"Slurry_dairy_cow", "Manure_dairy_cow", "Slurry_cattle", "Manure_cattle", "Slurry_pig",
"Manure_pig", "Compost", "Biorga_Quick_12N" and others (see |
DMC |
dry matter content of the organic amendment (gDM/kgFM) |
C_content |
C content of the dry matter (gC/kgDM) |
N_content |
N content of the dry matter (gN/kgDM) |
return.comment |
(optional): logical value if comments are returned or not. Default = FALSE |
concentration_liquids |
concentration factor for liquid amendments. Default value is .5. |
unit |
unit of |
N_availability |
fraction of the total N that is plant-available, only
used with |
Details
The C and N inputs by organic amendments is calculated based on the
dry matter content (DMC) and the C and N content of the dry matter
of the amendment. If the contents are not specified,
default values from the Swiss fertilizer recommendations
(Sinaj et al. 2017) are assumed.
The default values are available the look-up-table CN_input_amendments_LUT
For all slurries and liquid amendments (DMC < 150 g/kg), a dilution of 50% is
assumed if default DMC values from the CN_input_amendments_LUT are used.
If the amount is given as plant-available N (unit = "kg N_available/ha"),
the total N input is the amount divided by the N availability of the
amendment (N_availability, default 0.7), and the C input is derived from
the total N input and the C/N ratio of the amendment.
If the amendment is not in CN_input_amendments_LUT and its properties
are not supplied, a warning is given and the inputs are NA.
Value
a tibble with the following parameters:
C_input_org: C input by organic amendment (kgC/ha)
N_input_org: N input by organic amendment (kgN/ha)
comment (optional): Source of information on properties of organic amendment
References
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
See Also
-
C_input()to calculate C inputs for a management_df -
N_input()to calculate N inputs for a management_df -
C_input_crops()to calculate C inputs by crops -
C_input_cover_crops()to calculate C input for cover crops -
CN_input_amendments_LUT()for the look-up-table for organic amendments reference values
Examples
#example where amount, dry matter content, C and N content are known.
CN_input_amendments(40, DMC = 300, C_content = 300, N_content = 30)
#example where only amount and type of amendment are known
CN_input_amendments(20, "Manure_pig")
#example of a diluted slurry
CN_input_amendments(20, amd_type = "Slurry_dairy_cow", DMC = 50)
#example where the plant-available N is known
CN_input_amendments(35, amd_type = "Slurry_cattle", unit = "kg N_available/ha")
Look-up-table with default values to calculate C and N inputs by organic amendments
Description
The dataset is a look-up-table that is used to calculate the carbon (C) and nitrogen (N) inputs by organic amendments with the function 'SoilManageR::CN_input_amendments()' and the stable organic matter with 'SoilManageR::stable_OM_amendments()'. The data set is generated from the organic fertilizers in 'inst/spec/fertilizers.json'; a copy is available as 'CN_input_amendments_LUT.xlsx' under '/inst/extdata/'.
Usage
CN_input_amendments_LUT
Format
A tibble with 31 rows and 11 columns:
- Amendment
Name of the amendment
- DMC
Dry matter content of the amendment [gDM/kgFM]
- OM
Organic matter content of the amendment, relative to its dry matter [gOM/kgDM]. Informative, the calculations derive the organic matter from the C content
- C_content
Carbon content of the amendment, relative to its dry matter [gC/kgDM]
- N_tot
Total N content of the amendment, relative to it's dry fresh weight [gN/kgFM]
- N_content
Nitrogen content of the amendment, relative to its dry matter [gN/kgDM]
- animal_origin
"TRUE" for manure and slurry from livestock, used for the livestock units
- N_availability
Fraction of the total N that is plant-available, used for amounts in kg N_available/ha (0.7 if missing)
- ISMO
Indicator of organic matter stability: fraction of the organic matter (or C) of the amendment that is incorporated into soil organic matter [-], used by
stable_OM_amendments- Comment
Comment, e.g. source of the information. These lines are shown as part of the function output
- ISMO_source
Source of the ISMO value
References
Compilation of Values from the SoilX project. Please check the 'CN_input_amendments_LUT.xlsx' file under '/inst/extdata/' for more information
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
Richner W, Flisch R, Mayer J, Schlegel P, Zähner M, Menzi H (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Eigenschaften und Anwendung von Düngern.” Agrarforschung Schweiz, Spezialpublikation, Chapter 4(6), 1–24. https://ira.agroscope.ch/en-US/publication/41476.
ISMO values:
Levavasseur F, Mary B, Christensen BT, Duparque A, Ferchaud F, Kätterer T, Lagrange H, Montenach D, Resseguier C, Houot S (2020). “The simple AMG model accurately simulates organic carbon storage in soils after repeated application of exogenous organic matter.” Nutrient Cycling in Agroecosystems. doi:10.1007/s10705-020-10065-x.
Bouthier A, Duparque A, Mary B, Sagot S, Trochard R, Levert M, Houot S, Damay N, Denoroy P, Dinh J, Blin B, Ganteil F (2014). “Adaptation et mise en œuvre du modèle de calcul de bilan humique à long terme AMG dans une large gamme de systèmes de grandes cultures et de polyculture-élevage.” Innovations Agronomiques, 34, 125–139. doi:10.17180/rgmy-kq04. https://hal.science/hal-01192501.
Berger S, Sicard L, Houot S, Levavasseur F (2022). “Contribution des Produits Résiduaires Organiques à la séquestration du carbone dans les sols.” Technical Report 20-0518/1A, RECORD. 73 p., https://hal.science/hal-05070924.
Estimate carbon input
Description
C_input() estimates the carbon (C) input into the soil system per year of a
management_df.
Usage
C_input(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a |
extended.output |
an optional logical value.
|
Details
The function takes a management_df as input and returns
a C input values per year in the management_df.
Alternatively, it can return a tibble with all management operations and their respective C input values.
The functions calculates the C input with the C_input_crops(),
C_input_cover_crops() and CN_input_amendments() functions.
If a crop (except temporary ley) is harvested more than once ("harvest_main_crop" without a "sowing_main_crop" in between), only the first harvest gets a C input.
Temporary leys get one C input per year, calculated from the first cut of the year. Cuts in the sowing year of a ley that was sown after the harvest of another main crop in the same year are not counted.
Value
By default, a tibble with C input values (total and by category) by year is returned.
C_input_crop_abvgandC_input_cover_crop_abvgare the parts ofC_input_cropandC_input_cover_cropthat come from above ground residues (product and straw left on the field, without roots and exudates). They are not added toC_inputa second time.If
extended.output = TRUE, a tibble with all management operations and their respective C inputs is returned.
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
calculate_C_input_tibble()a helper function that calculates the C input tibble -
C_input_crops()to calculate C input for crops -
C_input_cover_crops()to calculate C input for cover crops -
CN_input_amendments()to calculate C (and N) inputs for organic amendments
Examples
#example that returns annual C input values
C_input(EXAMPLE_data)
#example that returns a tibble with all operations that have a C input
C_input(EXAMPLE_data, extended.output = TRUE)
Estimate C inputs by cover crops
Description
This function estimates the Carbon (C) input into the soil system by cover crops based on the duration of the cover crop stand.
Usage
C_input_cover_crops(
abvg_biomass = NA,
days = 180,
min_C_abvg = 0,
min_days = 0,
max_C_abvg = 1916,
max_days = 240,
Cc_biomass = 450
)
Arguments
abvg_biomass |
(optional): Dry weight of aboveground biomass of the cover crop ( |
days |
(optional): Number of days that the cover crop was established. If no value is provided, mind_days is assumed ( |
min_C_abvg |
(optional): Minimal above ground C that the cover crop produces, given it is established for the min_days number of days. Default value is 1.253 ( |
min_days |
(optional): Number of days where the interpolation of the biomass starts. The default value is 180 ( |
max_C_abvg |
(optional): Maximum biomass that the cover crop can produce. Default value is 1.916 ( |
max_days |
(optional): Number of days when the maximum biomass of the cover crop is reached. The default value is 240 ( |
Cc_biomass |
(optional): Assumed C content of the cover crop biomass. Default value is 450 ( |
Details
C_input_cover_crops() internally calls C_input_crops() to calculate the
different C fractions. The C in the above ground biomass (C_{Product})
is a function of the time a cover crop is established. A minimum and
a maximum cover crop biomass are assumed at 0 and 240 days respectively,
and linearly interpolated for the period in between.
C_{Product} = \begin{cases}
0 \ kgC/ha \ , \ duration = 0 \ days \\
duration \ * \frac{1916 \ kgC/ha}{240 \ days} \ , \ 0 \ days < duration \leq 240 \ days \\
1916 \ kgC/ha \ , \ duration > 240 \ days
\end{cases}
Assumptions on the C inputs at day 240 are based on values extracted from Seitz et al. (2022).
The remaining parameters to calculate the C input by cover crops are
HI = 1, SER = 3.67, and REF = 0.31, all derived from Seitz et al. (2022).
Note, that with these assumptions the C input of short term cover crops (e.g. few weeks) is overestimated.
The function C_input_cover_crops() estimates the C input by applying the
assumptions mentioned above. Alternatively, the user can
supply an above ground biomass and a CC of the biomass,
or other parameters to estimate the C input by cover crops.
Value
a tibble with the following parameters:
C_input_product: Estimated soil carbon input from product (i.e., the cover corp aboveground biomass) (
kgC/ha),C_input_straw: Estimated soil carbon input by straw or other residues (typically 0 for cover crops) (
kgC/ha),C_input_root: Estimated soil carbon input by roots (
kgC/ha),C_input_exudate: Estimated soil carbon input by roots (
kgC/ha),C_input_total: Total estimated Soil carbon input, sum of C_input_straw, C_input_root, C_input_exudate (
kgC/ha),
References
Seitz D, Fischer LM, Dechow R, Wiesmeier M, Don A (2022). “The potential of cover crops to increase soil organic carbon storage in German croplands.” Plant and Soil, 488(1-2), 157–173. doi:10.1007/s11104-022-05438-w.
See Also
-
C_input()to calculate C inputs for amanagement_df -
C_input_crops()to calculate C input for crops -
CN_input_amendments()to calculate C (and N) inputs for organic amendments -
C_input_crops_LUT()for the look-up-table for crop reference values
Examples
#example when only the duration is known
C_input_cover_crops(days = 205)
#example if the cover crop biomass is known
C_input_cover_crops(abvg_biomass = 2.5, Cc_biomass = 450)
#example with custom assumptions on the above ground biomass developnent over time
C_input_cover_crops(days = 60, min_C_abvg = 600 , min_days = 50, max_C_abvg = 1916, max_days = 240)
Estimate C inputs by crops
Description
Calculates the estimated carbon (C) input into the soil system by harvested main crops.
Usage
C_input_crops(
crop,
crop_product = NA,
crop_residue = NA,
harvest_index = NA,
variable_harvest_index = NA,
HI_intercept = NA,
HI_slope = NA,
shoot_root_ratio = NA,
root_exudation_factor = NA,
Cc_product = 450,
Cc_residue = 450,
Cc_root = 450,
straw.removal = NA,
fixed_belowground_input = NA,
fixed_C_input_root = NA,
return.comment = FALSE
)
Arguments
crop |
Crop type. Must match predefined list (see |
crop_product |
(optional) Dry weight of the exported product, i.e. yield. Default value is taken from table (tDM/ha) |
crop_residue |
(optional) Dry weight of the residues of the main crop (e.g., straw, sugar beet leaves) (tDM/ha) |
harvest_index |
(optional) Ratio of the product to the total above ground biomass |
variable_harvest_index |
(optional) Logical value that is TRUE if the variable harvest index assumptions of Fan et al. (2017) are to be applied (TRUE / FALSE) |
HI_intercept |
(optional) Intercept of the variable harvest index. Values provided by Fan et al. (2017) |
HI_slope |
(optional) Slope of the variable harvest index. Values provided by Fan et al. (2017) (ha/tDM) |
shoot_root_ratio |
(optional) Ratio of the total above ground biomass to the root biomass |
root_exudation_factor |
(optional) Ratio of the root exudated C to the C in the root biomass |
Cc_product |
(optional) C concentration in the exported product. Default value is 450 (gC/kgDM) |
Cc_residue |
(optional) C concentration in the residues of the main crop. Default value is 450 (gC/kgDM) |
Cc_root |
(optional) C concentration in the roots. Default value is 450 (gC/kgDM) |
straw.removal |
(optional) Logical value that is TRUE if straw is removed at harvest.
|
fixed_belowground_input |
(optional) Logical value that is TRUE if fixed below ground Carbon inputs are to be assumed (e.g. for temporary leys) (TRUE / FALSE) |
fixed_C_input_root |
(optional) amount of root C that is assumed if fixed_belowground_input is TRUE (kgC/ha) |
return.comment |
(optional) logical value if comment are returned or not. Default = FALSE (TRUE/FALSE) |
Details
The annual C input by crops were estimated based on crop type and crop yield with the allometric functions of Bolinder et al. (2007):
C_{Product} = Product * CC_{Product}
C_{Straw} = {Product}* \frac{1 - HI}{HI} * CC_{Straw}
C_{Root} = \frac{Product}{SRR*HI} * CC_{Root}
C_{Exudates} = C_{Root} * REF
Where C is the C per fraction (in kgC/ha) and CC is the C
content of given fraction (kgC/tDM). Prodcuct is the dry matter
yield of a crop in tDM/ha, HI is the harvest index
(ratio of product total of product and straw), SRR is the
ratio of the shoot biomass (product and straw) to the root biomass,
and REF is the root exudation factor
(i.e., the ratio of the C exudated by the roots
to the C in the root biomass). All fractions are multiplied with
a crop and fraction specific S-factor that determines the share
of the fraction that is returned to the soil.
If not mentioned otherwise parameters were taken from the
publications of Bolinder et al. (2007),
Keel et al. (2017) or
Wüst-Galley et al. (2020).
Parameters for potatoes and sugar beets were derived from
Bolinder et al. (2015)
For temporary leys we assumed yield-independent annual
C_{Root} of 1.5 MgC/ha and a REF of 0.5
(Taghizadeh-Toosi et al. 2020).
Furthermore, like Wüst-Galley et al. (2020), the
belowground C input (C_{Root} + C_{Exudates}) of corn maize,
silage maize and cereals were fixed to 0.46 MgC/ha, 1.1 MgC/ha and
0.6 MgC/ha respectively, based on the values from
Hirte et al. (2018).
Additionally, we applied the yield dependent harvest index
(HI = Intercept + Product * Slope) proposed by
Fan et al. (2017) for cereals, faba beans,
peas, corn, rapeseed, and soybeans.
Reference yields were derived from the Swiss fertilizer recommendations Sinaj et al. (2017).
All default values can be found in the look-up-table C_input_crops_LUT.
Value
a tibble with the following parameters:
C_input_product: Estimated soil carbon input from product (e.g. damaged potatoes) (kgC/ha),
C_input_straw: Estimated soil carbon input by straw or other residues (kgC/ha),
C_input_root: Estimated soil carbon input by roots (kgC/ha),
C_input_exudate: Estimated soil carbon input by roots (kgC/ha),
C_input_total: Total estimated Soil carbon input, sum of C_input_straw, C_input_root, C_input_exudate (kgC/ha),
comment (optional): comment on the derived values
References
Bolinder MA, Janzen HH, Gregorich EG, Angers DA, VandenBygaart AJ (2007).
“An approach for estimating net primary productivity and annual carbon inputs to soil for common agricultural crops in Canada.”
Agriculture, Ecosystems & Environment, 118(1-4), 29–42.
doi:10.1016/j.agee.2006.05.013.
Bolinder MA, Kätterer T, Poeplau C, Börjesson G, Parent LE (2015).
“Net primary productivity and below-ground crop residue inputs for root crops: Potato (Solanum tuberosum L.) and sugar beet (Beta vulgaris L.).”
Canadian Journal of Soil Science, 95(2), 87–93.
doi:10.4141/cjss-2014-091.
Fan J, McConkey B, Janzen H, Townley-Smith L, Wang H (2017).
“Harvest index - yield relationship for estimating crop residue in cold continental climates.”
Field Crops Research, 204, 153–157.
doi:10.1016/j.fcr.2017.01.014.
Hirte J, Leifeld J, Abiven S, Oberholzer H, Mayer J (2018).
“Below ground carbon inputs to soil via root biomass and rhizodeposition of field-grown maize and wheat at harvest are independent of net primary productivity.”
Agriculture, Ecosystems & Environment, 265, 556–566.
doi:10.1016/j.agee.2018.07.010.
Keel SG, Leifeld J, Mayer J, Taghizadeh-Toosi A, Olesen JE (2017).
“Large uncertainty in soil carbon modelling related to method of calculation of plant carbon input in agricultural systems.”
European Journal of Soil Science, 68(6), 953–963.
doi:10.1111/ejss.12454.
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017).
“Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.”
Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46.
https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
Taghizadeh-Toosi A, Cong W, Eriksen J, Mayer J, Olesen J, Keel SG, Glendining M, Kätterer T, Christensen BT (2020).
“Visiting dark sides of model simulation of carbon stocks in European temperate agricultural soils: allometric function and model initialization.”
Plant and Soil, 450(1-2), 255–272.
doi:10.1007/s11104-020-04500-9.
Wüst-Galley C, Keel SG, Leifeld J (2020).
“A model-based carbon inventory for Switzerland’s mineral agricultural soils using RothC.”
Agroscope Science, 1–110.
doi:10.34776/as105e.
See Also
-
C_input()to calculate C inputs for amanagement_df -
C_input_cover_crops()to calculate C input for cover crops -
CN_input_amendments()to calculate C (and N) inputs for organic amendments -
C_input_crops_LUT()for the look-up-table for crop reference values
Examples
#example without yield information, default yield is assumed
C_input_crops("wheat, winter")
#example with yield information and straw retention
C_input_crops("barley, spring", crop_product = 4.5, straw.removal = FALSE)
#example with more information
C_input_crops("barley, spring", crop_product = 4.5, harvest_index = 0.4,
shoot_root_ratio = 2.4, root_exudation_factor = 0.5)
#example with variable harvest index
C_input_crops("barley, spring", crop_product = 4.5, variable_harvest_index = TRUE,
HI_intercept = 0.35, HI_slope = 0.015, shoot_root_ratio = 2.4,
root_exudation_factor = 0.5)
#example with fixed below ground input
C_input_crops("maize, silage", crop_product = 18.5,
fixed_belowground_input = TRUE, fixed_C_input_root = 1500,
root_exudation_factor = 0.3)
Look-up-table with default values to calculate carbon (C) inputs by crops
Description
The data set is a look-up-table that is used to calculate the C inputs by crops with the Bolinder formula, that is implemented in the function 'SoilManageR::C_input_crops()'. The data set is produced from the excel table 'C_input_crops_LUT.xlsx' file under '/inst/extdata/'.
Usage
C_input_crops_LUT
Format
A tibble with 28 rows and 19 columns:
- Crop
Name of the crop
- RP
Ratio of the C in the product to the total carbon that is allocated by the plant (in a year)
- RS
Ratio of the C in the above ground residues (e.g. straw) to the total carbon that is allocated by the plant (in a year)
- RR
Ratio of the C in the plant roots to the total carbon that is allocated by the plant (in a year)
- RE
Ratio of the C in the root exudates to the total carbon that is allocated by the plant (in a year)
- SP
Proportion of the C in the Product that is transferred to the soil
- SS
Proportion of the C in the above ground residues (e.g. straw) that is transferred to the soil
- SR
Proportion of the C in the roots that is transferred to the soil
- SE
Proportion of the C in root exudates that is transferred to the soil
- crop_product
Reference yield, derived from the Swiss fertilizer recommendations (GRUD, 2017, Chapters 8 and 9) [tDM/ha]
- harvest_index
Ratio of the product to the total of the product and the above ground residues. Calculated by RP/(RP+RS) (assuming all biomass has 45% C)
- varible_harvest_index
Logical value, if the variable harvest index assumption of Fan et al. (2017) are to be applied or not.
- HI_intercept
Intercept of the variable harvest index assumption of Fan et al. (2017) are to be applied.
- HI_slope
Slope of the variable harvest index assumption of Fan et al. (2017) are to be applied. [ha/tDM]
- shoot_root_ratio
Ratio of the product and the above ground residues to the root biomass. Calculated by (RP+RS)/RR (assuming all biomass has 45% C)
- root_exudation_factor
Ratio of the root exudates to the root biomass. Calculated by RE/RR (assuming all biomass has 45% C)
- fixed_belowground_input
Logical value if the fixed below ground C allocation assumption of Taghizadeh-Toosi et al. (2020) is to be applied or not.
- C_input_root
Fixed value of root carbon input that is to be assumed. [kgC/ha]
- Source
Source where the information was derived.
References
Compilation of values from the SoilX project. Please check the 'C_input_crops_LUT.xlsx' file under '/inst/extdata/' for more information.
Bolinder MA, Janzen HH, Gregorich EG, Angers DA, VandenBygaart AJ (2007). “An approach for estimating net primary productivity and annual carbon inputs to soil for common agricultural crops in Canada.” Agriculture, Ecosystems & Environment, 118(1-4), 29–42. doi:10.1016/j.agee.2006.05.013.
Bolinder MA, Kätterer T, Poeplau C, Börjesson G, Parent LE (2015). “Net primary productivity and below-ground crop residue inputs for root crops: Potato (Solanum tuberosum L.) and sugar beet (Beta vulgaris L.).” Canadian Journal of Soil Science, 95(2), 87–93. doi:10.4141/cjss-2014-091.
Fan J, McConkey B, Janzen H, Townley-Smith L, Wang H (2017). “Harvest index - yield relationship for estimating crop residue in cold continental climates.” Field Crops Research, 204, 153–157. doi:10.1016/j.fcr.2017.01.014.
Hirte J, Leifeld J, Abiven S, Oberholzer H, Mayer J (2018). “Below ground carbon inputs to soil via root biomass and rhizodeposition of field-grown maize and wheat at harvest are independent of net primary productivity.” Agriculture, Ecosystems & Environment, 265, 556–566. doi:10.1016/j.agee.2018.07.010.
Keel SG, Leifeld J, Mayer J, Taghizadeh-Toosi A, Olesen JE (2017). “Large uncertainty in soil carbon modelling related to method of calculation of plant carbon input in agricultural systems.” European Journal of Soil Science, 68(6), 953–963. doi:10.1111/ejss.12454.
Seitz D, Fischer LM, Dechow R, Wiesmeier M, Don A (2022). “The potential of cover crops to increase soil organic carbon storage in German croplands.” Plant and Soil, 488(1-2), 157–173. doi:10.1007/s11104-022-05438-w.
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
Taghizadeh-Toosi A, Cong W, Eriksen J, Mayer J, Olesen J, Keel SG, Glendining M, Kätterer T, Christensen BT (2020). “Visiting dark sides of model simulation of carbon stocks in European temperate agricultural soils: allometric function and model initialization.” Plant and Soil, 450(1-2), 255–272. doi:10.1007/s11104-020-04500-9.
Wüst-Galley C, Keel SG, Leifeld J (2020). “A model-based carbon inventory for Switzerland’s mineral agricultural soils using RothC.” Agroscope Science, 1–110. doi:10.34776/as105e.
Example of a management_df
Description
The dataset is derived from a Swiss long term agricultural field experiment. It is intended for demonstration purposes only
Usage
EXAMPLE_data
Format
A tibble with 130 rows and 13 columns:
- crop
Name of the main crop. Cover crop related operations are linked to the next main crop in the rotation [String from list]
- date
Date of the management operation [Date]
- year
Year of the management operation [Integer]
- category
Categorization of the management operation [1 level] [String from list]
- operation
Categorization of the management operation [2 level] [String from list]
- device
Categorization of the management operation [3 level] [String from list]
- value
Numerical value linked to management operation (e.g., depth of tillage operation, mass of organic amendment) [Integer]
- unit
Unit of the numerical value (e.g. cm, t/ha) [String from list]
- machine
Further information on the machine used (e.g., type, manufacturer, tool) [String [UTF-8]]
- product
Further information on the applied product (e.g., name, manufacturer, C content) [String [UTF-8]]
- combination
Indicate if a operation was done in combination with others. Use consecutive integer numbers if combined operations occur. Leave empty if not combined
- comments
Comments related to the management operation [String [UTF-8]]
- DMC
Dry matter content of organic amendments [gDM/kgFM]
- C_content
Carbon content of the amendments, relative to its dry matter [gC/kgDM]
- N_content
Nitrogen content of organic amendments, relative to its dry matter [gN/kgDM]
- crop_product
Crop product yield [tDM/ha]
- crop_residue
Crop residue mass [tDM/ha]
- Cc_product
Carbon content of the crop product [gC/kgDM$]
- Cc_residue
Carbon content of the crop residue [gC/kgDM]
Estimate nitrogen fixation by legumes
Description
This function estimates the nitrogen (N) fixation by legumes into the soil system based on either fixed values or a dynamic calculation based on the formula provided by Nucera et al. (2023).
Usage
N_fixation_legumes(
crop,
crop_product = NA,
alpha_crop = NA,
beta_crop = NA,
N_con = NA,
NHI = NA,
BGNF = NA,
N_fix = NA
)
Arguments
crop |
name of the crop, must be in the |
crop_product |
reference yield, derived from the Swiss fertilizer recommendations (tDM/ha) |
alpha_crop |
slope of the crop specific regression (-) |
beta_crop |
intercept of the crop specific regression (-) |
N_con |
N concentration in grain (kgN/dtDM) |
NHI |
nitrogen harvest index, defined as the ratio of the harvested N to the above ground N (-) |
BGNF |
below-ground nitrogen factor (-) |
N_fix |
fixed N input per ha (kgN/ha), if this value is provided, the calculation is skipped and the value is used as N fixation input |
Details
The function takes the name of the crop and optionally the parameters for the calculation as input and returns the estimated N fixation in kgN/ha.
Default values for the calculation parameters are provided in the N_fixation_legumes_LUT and can be used if not provided by the user.
The dynamic N input is calculated based on the product yield of a crop with the following formula provided by Nucera et al. (2023):
N_{fixation} = ((crop\_product*10 * alpha\_crop * N\_con * (1/NHI)) + beta\_crop) * BGNF
Value
a list with the following elements: N_fixation (the estimated N fixation by legumes in kgN/ha)
References
Nucera E, Huguenin-Elie O, Mayer J, Liebisch F, Spiess E (2023). “Method for estimating nitrogen input by symbiotic fixation on Swiss farms.” Agroscope Science, 164. doi:10.34776/AS164E. https://ira.agroscope.ch/en-US/Page/Publikation/Index/53885.
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
Huguenin-Elie O, Mosimann E, Schlegel P, Lüscher A, Kessler W, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Grasland.” Agrarforschung Schweiz, Spezialpublikation, Chapter 9(6), 1–22. https://ira.agroscope.ch/de-CH/publication/37264.
See Also
-
calculate_N_input_tibble()a helper function that calculates the N input tibble -
N_input()a function that calculates the N input by mineral and organic fertilization and summarizes it by year
Examples
# example with fixed N fixation value for leys
N_fixation_legumes(crop = "ley, temporary")
# example with dynamic calculation
N_fixation_legumes(crop = "soybean", crop_product = 2.5)
Look-up-table with default values to calculate N fixation
Description
The dataset is a look-up-table that is used to calculate the nitrogen (C) fixation by crops and cover crops 'SoilManageR::N_fixation_legumes_LUT()'. The data set is produced from the excel table 'N_fixation_legumes_LUT.xlsx' file under '/inst/extdata/'.
Usage
N_fixation_legumes_LUT
Format
A tibble with 7 rows and 9 columns:
- Crop
Name of the crop
- crop_product
Reference yield, derived from the Swiss fertilizer recommendations [tDM/ha]
- alpha_crop
slope of the crop specific regression [-]
- beta_crop
intercept of the crop specific regression [-]
- N_con
N concentration in grain [kgN/dtDM]
- NHI
nitrogen harvest index, defined as the ratio of the harvested N to the above ground N [-]
- BGNF
below-ground nitrogen factor [-]
- N_fix
fixed N input per ha [kgN/ha]
- Comment
Comment, e.g. source of the information
References
Compilation of Values from multiple sources project. Please check the 'CN_input_amendments_LUT.xlsx' file under '/inst/extdata/' for more information
Nucera E, Huguenin-Elie O, Mayer J, Liebisch F, Spiess E (2023). “Method for estimating nitrogen input by symbiotic fixation on Swiss farms.” Agroscope Science, 164. doi:10.34776/AS164E. https://ira.agroscope.ch/en-US/Page/Publikation/Index/53885.
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
Huguenin-Elie O, Mosimann E, Schlegel P, Lüscher A, Kessler W, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Grasland.” Agrarforschung Schweiz, Spezialpublikation, Chapter 9(6), 1–22. https://ira.agroscope.ch/de-CH/publication/37264.
Estimate nitrogen input
Description
This function estimates the nitrogen (N) input by mineral and organic fertilization as well as by leguminous plants into the soil system per year.
Usage
N_input(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a |
extended.output |
an optional logical value:
|
Details
The function takes a management_df as input and returns N input values
per year in the management_df.
Alternatively, it can return a extensive tibble with all management operations and their N input values.
The functions calculates the N input by
organic fertilization with the calculate_N_input_tibble() and the
CN_input_amendments() function.
Furthermore, it calculates the livestock intensity (LSU/ha) by dividing
the animal derived N by 105kgN/LSU.
Be aware that the function currently neglects N that is fixated by plants (e.g. legumes)
Value
by default, a tibble with N input values (organic N, mineral N, fixed N, and total N) by year is returned. If extended.output = TRUE, a tibble with daily resolution is returned.
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
CN_input_amendments()for the calculation of N inputs from organic amendments -
calculate_N_input_tibble()a helper function that calculates the N input tibble -
N_fixation_legumes()a helper function that calculates the N fixation by legumes
Examples
#example that returns annual N input values
N_input(EXAMPLE_data)
#example that returns a tibble with all management operations and their N input
N_input(EXAMPLE_data, extended.output = TRUE)
Calculate STIR value
Description
The function calculates the soil tillage intensity rating (STIR) value
of tillage and sowing operations.
By default, the STIR() function of SoilManageR
operates on SI units (cm and km/h) and not in imperial units (inch, mph)
as the original STIR equation (USDA-NRCS 2023).
However, the user can specify that the input is in imperial units.
The function can process custom input, if no such input is provided
it assumes default values from the STIR_value_LUT.
Usage
STIR(
device = NA,
speed = NA,
speed_unit = "km/h",
type_modifier = NA,
depth = NA,
depth_unit = "cm",
area_disturbed = NA,
original.STIR.value = FALSE
)
Arguments
device |
tillage or sowing implement or operation, must match predefined list, or all necessary inputs (speed, type modifier, depth, area_disturbed) must be provided |
speed |
speed of the operation (km/h or mph) |
speed_unit |
unit of the speed input, must be either NA, "km/h" or "mph". Default value is "km/h" |
type_modifier |
tillage operation type modifier, must be a value between 0 and 1 |
depth |
depth of the soil that is affected by the operation (cm or inch) |
depth_unit |
unit of the depth input, must be either NA, "cm" or "inch". Default value is "cm" |
area_disturbed |
share of the surface that is disturbed by the operation (0 to 1) |
original.STIR.value |
logical value, if TRUE, the original STIR value of
the operation in the |
Details
The concept of the STIR value was developed within the RUSLE2 framework by the USDA-NRCS (2023). The STIR equation is defined as
STIR = (0.5 * speed) * (3.25 * type_{modifier}) * depth * area_{disturbed}
where speed and depth are provided in mph and inches(!).
For the purpose of this function we assume that 1 inch = 2.54 cm and 1 mph = 1.609 km/h.
The tillage type_{modifier} is defined to be:
-
1.00for inversion operation -
0.80for mixing and some inversion operations -
0.70for mixing operations -
0.40for lifting and fracturing operations -
0.15for compression operations
In the STIR_value_LUT there are more than 400 operations,
incl. the original operations from the RUSLE2 software (as of 2023-02-24)
and operations defined by the SoilX project.
For further details on the STIR please consider the RUSLE2 website (https://fargo.nserl.purdue.edu/rusle2_dataweb/RUSLE2_Index.htm) or the description of the SoilManageR package
Value
STIR value of the operation
References
USDA-NRCS (2023). “Revised Universal Soil Loss Equation, Version 2 (RUSLE2), Official NRCS RUSLE2 Program and Database (V 2023-02-24).” USDA-NCRS. https://fargo.nserl.purdue.edu/rusle2_dataweb/RUSLE2_Index.htm.
See Also
-
tillage_intensity()to calculate STIR values for management_df -
STIR_values_LUT()for the reference data used by theSTIR()function
Examples
#example without additional information
STIR("plough")
#example with additional information
STIR("rotary_harrow", depth = 15)
#custom example
STIR(speed = 10, type_modifier = 0.8, depth = 15, area_disturbed = 0.45)
#example that returns orginial STIR value
STIR("plough", original.STIR.value = TRUE)
#example that uses imperial units
STIR("plough", depth = 5, depth_unit = "inch", speed = 8, speed_unit = "mph")
Look-up-table with default values for tillage operations
Description
The dataset is a look-up-table that is used to derive STIR values with the function 'SoilManageR::STIR()' and residue incorporation by tillage operations with the function 'SoilManageR::soil_cover()'. The data set is produced from the excel table 'STIR_value_LUT.xlsx' file under '/inst/extdata/' and was mostly derived from the official RUSLE2 database (USDA-NRCS 2023).
Usage
STIR_values_LUT
Format
A tibble with 50 rows and 15 columns:
- Operation
Name of the operation
- Speed
Average speed of the operation [km/h]
- Speed_MIN
Min speed of the operation [km/h]
- Speed_Max
Max speed of the operation [km/h]
- Surf_Disturbance
Share of the disturbed soil surface [%]
- Depth
Average depth of the operation [cm]
- Depth_MIN
Min depth of the operation [cm]
- Depth_MAX
Max depth of the operation [cm]
- TILLAGE_TYPE
Type of tillage operation
- TILLAGE_TYPE_Modifier
Numerical value of the tillage type modifier [0-1]
- STIR
Soil tillage intensity rating value, based on default values
- Diesel_use
iesel use of the operation per area [l/ha]
- Burial_Coefficient
Burial of plant residues on the soil surface [0-1]
- Source
Source of the values in the table
- Description
Description of the operation
References
USDA-NRCS (2023). “Revised Universal Soil Loss Equation, Version 2 (RUSLE2), Official NRCS RUSLE2 Program and Database (V 2023-02-24).” USDA-NCRS. https://fargo.nserl.purdue.edu/rusle2_dataweb/RUSLE2_Index.htm.
arrange management_df by date, category
Description
the function arranges the management_df by date and by category of operations. The order of the operations is harvest, fertilizer_application,crop_protection, tillage, sowing, irrigation, other
Usage
arrange_management_df(var_MGMT_data, include.combination = TRUE)
Arguments
var_MGMT_data |
management_df to be arranged |
include.combination |
logical, if the combinations should considered Default is TRUE |
Value
a rearranged management_df
Examples
#rearrange EXAMPLE data
arrange_management_df(EXAMPLE_data)
Calculate C input tibble
Description
A function that calculates the C input by crops, cover crops and organic amendments. The output is returned as a tibble.
Usage
calculate_C_input_tibble(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Details
The function is mainly a helper function for the C_input() function.
Value
tibble with C input values
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
C_input_crops()to calculate C input for crops -
C_input_cover_crops()to calculate C input for cover crops -
CN_input_amendments()to calculate C (and N) inputs for organic amendments -
C_input()a function that calculates the N input by mineral and organic fertilization and summarizes it by year
Examples
#Calculate C input tibble
calculate_C_input_tibble(EXAMPLE_data)
Calculate N input tibble
Description
A function that calculates the N input by mineral and organic fertilization, and N fixation by leguminous plants. Furthermore, the livestock intensity of the animal derived N inputs is calculated
Usage
calculate_N_input_tibble(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Details
The function is mainly a helper function for the N_input() function.
Value
tibble with N and LSU values
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
CN_input_amendments()for the calculation of N inputs from organic amendments -
N_input()a function that calculates the N input by mineral and organic fertilization and summarizes it by year -
N_fixation_legumes()a helper function that calculates the N fixation by legumes
Examples
#Calculate N input tibble
calculate_N_input_tibble(EXAMPLE_data)
Calculate STIR tibble
Description
A function that calculates the STIR value of all operations in a management_df.
The output is returned as a tibble.
Usage
calculate_STIR_tibble(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Details
The function is mainly a helper function for the tillage_intensity() function.
Value
a tibble with all management operations and STIR values
See Also
-
STIR()for the calculation of aSTIRvalue for operations -
STIR_values_LUT()for the reference data used for tillage operations -
calculate_indicators()to calculate all management indicators for amanagement_df -
tillage_intensity()aggregates the STIR values
Examples
#example that returns a tibble with all operations that have a STIR value
calculate_STIR_tibble(EXAMPLE_data)
Calculate all soil management indicators
Description
Checks the management_df for consistency with the check_management_df() function.
Then it calculates the C_input(), tillage_intensity(), soil_cover(),plant_diversity()
N_input() and productivity_indicator().
Usage
calculate_indicators(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Value
data frame with indices per year. The column crop is the main
crop of the year: the crop of the last management record on or before
June 1st, also if this record is from an earlier year (e.g. a winter crop
without operations in spring).
See Also
Examples
#example input
calculate_indicators(EXAMPLE_data)
Calculate soil management indicators by crop
Description
Alternative to 'calculate_indicators()' that C inputs, N inputs, STIR and soil cover for each crop separately. The function identifies the last harvest of each crop per year and aggregates the management intensities for the periods in between. Harvests of temporary leys that are sown after a main crop and harvest in the same year are not considered.
Usage
calculate_indicators_by_crop(var_management_df)
Arguments
var_management_df |
a 'management_df()' |
Details
The yield ('crop_product') and relative yield of a crop are taken from its last harvest. For temporary leys, 'crop_product' is the yield of each cut (as in [productivity_indicator()]): the yields of all cuts of the ley in the year of its last harvest are summed. Cuts in the sowing year of a ley that was sown after the harvest of another main crop in the same year are not counted (also not in [productivity_indicator()] and [C_input()]).
Value
a tibble with the indicator values per crop
Examples
# calculate examples
calculate_indicators_by_crop(EXAMPLE_data)
# this would return a tibble, but it can take a while
Extract indicators by a specific date
Description
Calculate for a specific date (e.g. day of sampling) and discount the indicator values of events in the past. The default half life time of all discounts is set to 1 year (365 days).
Usage
calculate_indicators_by_date(
var_management_df,
var_date,
half_life_time_STIR = 365,
half_life_time_C_input = 365,
half_life_time_N_input = 365,
half_life_time_soil_cover = 365
)
Arguments
var_management_df |
input management data frame |
var_date |
date of the extraction in the format "YYYY-MM-DD" |
half_life_time_STIR |
half life time for the discounting of the STIR value |
half_life_time_C_input |
half life time for the discounting of the C inputs |
half_life_time_N_input |
half life time for the discounting of the N inputs |
half_life_time_soil_cover |
half life time for the discounting of soil cover days |
Value
tibble with the discounted indicator values per date
Examples
# calculate indicators by a specific date
calculate_indicators_by_date(EXAMPLE_data, "2019-10-03")
# this would return a tibble, but it may take a while
Calculate soil cover tibble
Description
The function takes a management_df as input and returns a soil_cover_tibble with daily resolution
of the estimated soil cover.
Usage
calculate_soil_cover_tibble(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Details
The function is mainly a helper function for the soil_cover() function.
Value
object of the class soil_cover_tibble with daily resolution is returned.
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
soil_cover()aggregates the soil cover information -
plant_cover()for more detail on the plant cover function -
plot.soil_cover_tibble()for plotting thesoil_cover_tibble -
STIR_values_LUTfor tillage operation specific burial coefficients
Examples
#example that returns a soil_cover_tibble
calculate_soil_cover_tibble(EXAMPLE_data)
Calculate stable organic matter tibble
Description
A function that calculates the organic matter (OM) input and the stable OM
of all organic fertilization operations of a management_df with
stable_OM_amendments(). The output is returned as a tibble.
Usage
calculate_stable_OM_amended_tibble(var_MGMT_data)
Arguments
var_MGMT_data |
a |
Details
The function is mainly a helper function for the stable_OM_amended() and
stable_OM_amended_by_crop() functions. Only organic amendments are
considered so far, crop residues and cover crops are not included.
Value
the management_df with the additional columns OM_input_org
(OM input, kg OM/ha, derived from the C input) and stable_OM_amended
(OM input times ISMO, kg OM/ha). Both are NA for other operations.
See Also
-
stable_OM_amendments()for the calculation and its assumptions -
stable_OM_amended()to summarize the stable OM by year -
stable_OM_amended_by_crop()to summarize the stable OM by crop
Examples
# Calculate stable OM tibble
calculate_stable_OM_amended_tibble(EXAMPLE_data)
Check management_df for consistency
Description
The function checks objects of the class management_df() for internal consistency.
It formally checks the class and the column names.
Additionally, the function checks if the dates are of class Date (other
classes such as POSIXct are converted with as.Date() by the calculation
functions), if dates are consistently increasing,
if all categories and combinations of category and operation are in the
choice list of the management template, if a crop (except temporary ley)
is harvested more than once,
and if all organic amendments, tillage and sowing devices and crops
are in the relevant look-up-tables. It is checked if the are operations
where the device is not mentioned.
Furthermore, the amount of organic amendments (<100t/ha) and
N fertilizer (<100kgN/ha) application rates per event are checked.
Mineral fertilizers entered as product amount (kg/ha or l/ha) must be in
the mineral_fertilizers_LUT with N content (and density for l/ha), and
should not be entered as kg N/ha on the same date as well. Products that
are not in the catalogue of their operation are reported as information.
The depth of tillage operations are compared with the min and max depth
from the STIR_value_LUT.
Finally, the order of tillage, sowing and harvest operations are checked
for plausibility (see details for more information).
Usage
check_management_df(var_MGMT_data)
Arguments
var_MGMT_data |
an object of the |
Details
The order of tillage, sowing and harvest operations are checked with the following assumptions:
after "stubble_cultivation" the following operations are allowed: "stubble_cultivation", "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop"
after "primary_tillage" the following operations are allowed: "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop"
after "seedbed_preparation" the following operations are allowed: "stubble_cultivation", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop"
after "sowing_main_crop" the following operations are allowed: "sowing_main_crop", "harvest_main_crop", "sowing_cover_crop","harvest_cover_crop","cleaning_cut"
after "sowing_cover_crop" the following operations are allowed: "stubble_cultivation", "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop", "harvest_main_crop","harvest_cover_crop","cleaning_cut"
after "harvest_main_crop" the following operations are allowed: "harvest_main_crop", "straw_removal", "hay_removal", "stubble_cultivation", "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop","harvest_cover_crop","cleaning_cut"
after "straw_removal" the following operations are allowed: "harvest_main_crop", "straw_removal", "stubble_cultivation", "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop"
after "hay_removal" the following operations are allowed: "harvest_main_crop", "hay_removal", "stubble_cultivation", "primary_tillage", "seedbed_preparation", "sowing_main_crop", "sowing_cover_crop"
Additionally, there are exceptions for potato crops: "bedder" can be used after a "potato_planter" and "mulching" can be applied before a "potato_harvester"
Value
a test_report list (only returned if some tests failed; findings that
are only information are shown as message). Besides the
tables of unexpected orders and depths, it contains the element diagnostics:
a data frame with one row per finding and the columns severity, code
(stable diagnostic code, e.g. "SM-W204"), row (row of the input data),
attribute and message.
See Also
-
management_df()for creating an management_df -
management_df_from_excel()for importing a management_df from an excel template
Examples
#example input
check_management_df(EXAMPLE_data)
Count number of pesticide applications
Description
Counts the number of pesticide applications in the management dataframe. Besides, separate counts of herbicide, fungicide and insecticide applications are provided.
Usage
count_pesticide_applications(var_management_df)
Arguments
var_management_df |
management dataframe |
Value
list with two tibbles: yearly and cropwise counts of pesticide applications
Examples
# count pesticide applications in the EXAMPLE_data
count_pesticide_applications(EXAMPLE_data)
Filter management_df for pattern in comments
Description
Excludes operations (lines) from management_df based on a character pattern in the comments column.
Usage
filter_management_df(var_MGMT_data, filter_pattern)
Arguments
var_MGMT_data |
management_df |
filter_pattern |
string based on which the lines should be excluded |
Value
a filtered management_df
Examples
# filter EXAMPLE_data and exclude all lines that contain "UFA 330" in comments
filter_management_df(EXAMPLE_data,"UFA 330")
Identify main crops
Description
Identifies all main crops that are harvested in the management dataframe.
Usage
identify_main_crops(var_management_df)
Arguments
var_management_df |
management dataframe |
Value
a management dataframe with a column "crop_no" that identifies the main crops
Examples
# identify main crop in the EXAMPLE data
identify_main_crops(EXAMPLE_data)
Constructor for management_df
Description
This function is a constructor for empty objects of the management_df() class,
the core of the SoilManageR package.
Usage
management_df(
crop = NA,
year = NA,
date = NA,
category = NA,
operation = NA,
device = NA,
value = NA,
unit = NA,
machine = NA,
product = NA,
combination = NA,
comments = NA,
DMC = NA,
C_content = NA,
N_content = NA,
crop_product = NA,
crop_residue = NA,
Cc_product = NA,
Cc_residue = NA
)
Arguments
crop |
Name of the main crop. Must match a pre-existing list |
year |
Year of the management operation ("YYYY") |
date |
Date of the management operation ("YYYY-MM-DD") |
category |
Categorization of the management operation (1 level). Must match a pre-existing list. |
operation |
Categorization of the management operation (2 level). Must match a pre-existing list. |
device |
Categorization of the management operation (3 level). Must match a pre-existing list. |
value |
Numerical value linked to management operation (e.g., depth of tillage operation, mass of organic amendment) |
unit |
Unit of the numerical value (e.g. cm, t/ha) |
machine |
Further information on the machine used (e.g., type, manufacturer, tool) |
product |
Further information on the applied product (e.g., name, manufacturer). Must match pre-existing list for organic amendments. |
combination |
Indicate if a operation was done in combination with others. Use consecutive integer numbers if combined operations occur. Leave empty if not combined. |
comments |
Comments related to the management operation |
DMC |
Dry matter content of organic amendments (gDM/kgFM) |
C_content |
Carbon content of the amendments, relative to its dry matter (gC/kgDM) |
N_content |
Nitrogen content of organic amendments, relative to its dry matter (gN/kgDM) |
crop_product |
Crop product yield (tDM/ha) |
crop_residue |
Crop residue mass (tDM/ha) |
Cc_product |
Carbon content of the crop product (gC/kgDM) |
Cc_residue |
Carbon content of the crop residue (gC/kgDM) |
Value
See Also
-
management_df_from_excel()for importing amanagement_dffrom an excel template -
check_management_df()to check the integrity of amanagement_df -
EXAMPLE_data()for an example of amanagement_df
Examples
#creation of an empty management_df
management_df()
Import management_df from excel file
Description
This function imports management data from an excel template and transforms it into a management_df. Additionally, it checks if all columns that are expected for a managment_df are available. The excel template can be found in the SoilManageR Package under inst/extdata/SoilManageR_mgmt_data_template. Optionally, the parameter year can be overwritten by the year extracted from date.
Usage
management_df_from_excel(
path_to_xlsx,
var_sheet = "Management_template",
overwrite_year = TRUE
)
Arguments
path_to_xlsx |
path to the excel file with the management data |
var_sheet |
name of the sheet with the management data template in the excel sheet, default is "Management_template" |
overwrite_year |
logical: if TRUE (default), the year will be set to the year extracted from the date |
Value
a management_df
See Also
-
management_df()for creating an management_df -
check_management_df()to check the integrity of a management_df
Examples
#create path
path_to_xlsx_template <- system.file(
"/extdata/SoilManageR_mgmt_data_template.xlsx", package = "SoilManageR")
#load management_df
management_df_from_excel(path_to_xlsx_template)
Import a management_df from JSON
Description
Reads management data in the SoilManageR JSON format and converts it into a
management_df. The JSON is an object with the optional element
spec_version and the element records: an array with one object per
management operation. The attributes of a record are the columns of a
management_df; omitted attributes and null become missing values.
Usage
management_df_from_json(json, validate_schema = TRUE)
Arguments
json |
path to a JSON file, or JSON text |
validate_schema |
logical: if TRUE (default), the JSON is also
validated against the JSON Schema when the package |
Details
The records are validated before the conversion: types, dates (YYYY-MM-DD),
required values (crop, date, category, operation, and the device for all
categories except "other"), a unit for every value, the vocabulary of the
specifications and the allowed combinations of category, operation, device
and unit. If the package jsonvalidate is installed, the JSON is also
validated against the JSON Schema management.schema.json (in the folder
schemas of the installed package), which contains the same rules.
If the data is not valid, an error of class management_json_error is
raised; its element diagnostics lists all findings with code, record,
attribute and message.
Historical names (aliases) of crops, categories, operations, devices and
products are replaced by their current identifiers. The year is derived
from the date. Seed mixtures are not expanded. Plausibility checks (e.g.
order of operations, tillage depths) are done with check_management_df().
Value
a management_df
See Also
-
management_df_to_json()to write a management_df as JSON -
management_df_from_excel()to import management data from the Excel template -
check_management_df()to check the plausibility of a management_df
Examples
path_to_json <- system.file("extdata", "EXAMPLE_data.json", package = "SoilManageR")
mgmt_data <- management_df_from_json(path_to_json)
# JSON text
management_df_from_json('{"records": [{"crop": "wheat, winter", "date": "2021-10-12",
"category": "tillage", "operation": "primary_tillage", "device": "plough",
"value": 25, "unit": "cm"}]}')
Write a management_df as JSON
Description
Converts a management_df into the SoilManageR JSON format (see
management_df_from_json()): an object with the specification version
and one record per management operation. Missing values and the year
(derived from the date) are omitted.
Usage
management_df_to_json(mgmt_data, path = NULL, pretty = TRUE)
Arguments
mgmt_data |
a management_df |
path |
optional path of the JSON file to write |
pretty |
logical: if TRUE (default), the JSON is indented |
Value
the JSON text (invisibly if written to path)
See Also
-
management_df_from_json()to import management data from JSON
Examples
json <- management_df_to_json(EXAMPLE_data[1:3, ])
cat(json)
Look-up-table with mineral fertilizers
Description
The dataset is a look-up-table that is used to calculate the N input of mineral fertilizers that are entered as product amount (kg/ha or l/ha) instead of kg N/ha. The data set is generated from the mineral fertilizers in 'inst/spec/fertilizers.json'; a copy is available as 'mineral_fertilizers_LUT.xlsx' under '/inst/extdata/'.
Usage
mineral_fertilizers_LUT
Format
A tibble with 12 columns:
- Fertilizer
Identifier of the fertilizer, used in the product column
- Label
Name of the fertilizer
- Operation
Operations in which the fertilizer is used
- Physical_form
solid or liquid
- Density
Density of liquid fertilizers [kg/l]
- N_content
N content [gN/kg product]
- P2O5_content
P content [gP2O5/kg product]
- K2O_content
K content [gK2O/kg product]
- Mg_content
Mg content [gMg/kg product]
- S_content
S content [gS/kg product]
- CaO_content
Ca content [gCaO/kg product]
- Comment
Comment, e.g. source of the information
Estimate soil cover percentage by plants
Description
This function estimates the percentage of soil cover based on the number of days since sowing. The parameters used are derived from Mosimann and Rüttimann (2006).
Usage
plant_cover(varCrop, varDays = 0)
Arguments
varCrop |
Crop type, must match with crop name in |
varDays |
Number of days since sowing of the crop |
Details
The function assumes that plant cover unfolds in four phases with different soil cover rates:
0 to 10 % of soil cover
10 to 50 % of soil cover
50 to 75 % of soil cover
75 to 100 % of soil cover
Value
percentage of soil cover by plants, value of 0 to 100 %.
References
Mosimann T, Rüttimann M (2006). “Berechnungsgrundlagen zum Fruchtfolgefaktor zentrales Mittelland 2005 im Modell Erosion CH (V2.02).” Terragon, Bubendorf. https://uwe.lu.ch/-/media/UWE/Dokumente/Themen/Bodenschutz/Bodenschutz_Landwirtschaft/dokumentationbodenerosionsschluessel_terragon2006.pdf.
See Also
-
soil_cover()to calculate soil coverage by plants and residue for a management_df -
plant_cover_LUT()for the data used by theplant_cover()function
Examples
plant_cover("wheat, winter", 140)
Look-up-table with default values to estimate soil cover by plants
Description
The dataset is a look-up-table that is used to estimate the soil cover percentage by plant with the function 'SoilManageR::plant_cover()'. The data set is produced from the excel table 'plant_cover_LUT.xlsx' file under '/inst/extdata/'.
Usage
plant_cover_LUT
Format
A tibble with 28 rows and 7 columns:
- Crop
Name of the crop
- Slope_0_10
Increase of crop cover per day between 0 and 10% soil cover [%/day]
- Slope_10_50
Increase of crop cover per day between 10 and 50% soil cover [%/day]
- Slope_50_75
Increase of crop cover per day between 50 and 75% soil cover [%/day]
- Slope_75_100
Increase of crop cover per day between 75 and 100% soil cover [%/day]
- days_30
Number of days it takes to reach 30% soil cover [day]
- Comments
Source where the information was derived
References
Mosimann T, Rüttimann M (2006). “Berechnungsgrundlagen zum Fruchtfolgefaktor zentrales Mittelland 2005 im Modell Erosion CH (V2.02).” Terragon, Bubendorf. https://uwe.lu.ch/-/media/UWE/Dokumente/Themen/Bodenschutz/Bodenschutz_Landwirtschaft/dokumentationbodenerosionsschluessel_terragon2006.pdf.
Calculate plant diversity indicators
Description
Derives three indicators for plant diversity of a crop rotation based on management information (mainly sowing events).
Usage
plant_diversity(var_MGMT_data, start_year, end_year)
Arguments
var_MGMT_data |
a 'management_df' with a management history |
start_year |
start year of the cropping sequence of interest |
end_year |
end year of the cropping sequence of interest |
Details
For the function to work properly the species (or variety) must be mentioned
in the "product" column. The species of a mixture are either
represented in a single row of the management_df each, or the mixture is
entered as one row with the identifier of a seed mixture of the package
specifications as "product", which is expanded to its component species.
Sowing records without product (e.g. rolling) are not counted.
The function calculates the crop diversity index (CDI), the total
number of different species, and the Shannon index for all sown species.
The CDI is calculated in the following way inspired by
Tiemann et al. (2015):
CDI = \overline{S_{year}} * S_{rotation}
where \overline{S_{year}} is the average number of sown species per
year and S_{rotation} is the total number of different species
sown in the full crop rotation or cropping sequence.
The Shannon Index is calculated with the shannon_index() function.
Value
a tibble with three indicators for plant diversity
References
Tiemann LK, Grandy AS, Atkinson EE, Marin-Spiotta E, McDaniel MD (2015). “Crop rotational diversity enhances belowground communities and functions in an agroecosystem.” Ecology Letters, 18(8), 761-771. doi:10.1111/ele.12453.
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
shannon_index()for more detail on the Shannon index
Examples
plant_diversity(EXAMPLE_data,2013,2020)
Plotting soil_cover_tibbles
Description
This function plots objects of the class soil_cover_tibble in a custom format
Usage
## S3 method for class 'soil_cover_tibble'
plot(x, ...)
Arguments
x |
an soil_cover_tibble object |
... |
arguments to be passed to methods |
Value
none, it plots the soil_cover_tibble
Examples
data <- soil_cover(EXAMPLE_data, extended.output = TRUE)
plot(data)
Plot a management dataframe
Description
Visual representation of a management_df.
Usage
plot_management_df(management_df, title = "Management Timeline")
## S3 method for class 'management_df'
plot(x, title = "Management Timeline", ...)
Arguments
management_df, x |
a management data frame |
title |
the title of the plot |
... |
further arguments, not used |
Details
The colors in the background represent the soil cover by main crops (dark green), cover crops (light green), and crop residues (brown). "T" indicates tillage event with a STIR value >= 0. "P" indicates a crop protection event. "F" indicates a mineral fertilization event. The values in the middle indicate C inputs into the soil system im MgC/ha, either by crops (C), residue removal (R), cover crops (CC) or organic amendments (OA). Negative values are withdrawals by residue removal. Dotted vertical lines represent sowing events, the sown crop or cover crop is noted in the lowest quarter at the right side of the line. Note that large management_df can be heavy to compute and the plots may be messy.
plot_management_df() is the default plot method of a management_df,
so plot(management_df) gives the same plot.
Value
a plot
Examples
# creates a visual representation of the EXAMPLE data
plot_management_df(EXAMPLE_data)
# the same with the default plot method
plot(EXAMPLE_data)
Calculate average productivity
Description
Estimates estimates the relative yield of a cropping sequence per year.
The function takes a management_df as input and
returns a relative_yield value per year in the management_df.
Alternatively, it can return a tibble with additional information on each crop.
The productivity_indicator() calculates the relative yields
with the relative_yield() function.
Usage
productivity_indicator(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a management_df that contains the management information |
extended.output |
an optional logical value.
|
Details
Temporary leys are usually cut several times per year. Their
crop_product is expected as the yield of each cut: the yields of all
cuts of a year are summed before the relative yield is calculated. The
same input is used by calculate_indicators_by_crop(). Cuts in the sowing
year of a ley that was sown after the harvest of another main crop in the
same year (e.g. a ley sown after a cereal harvest and cut in autumn) are
not counted.
Value
By default, a tibble with relative yields by year is returned.
If extended.output = TRUE, a tibble with additional information is returned.
See Also
-
relative_yield()for calculating relative yields -
calculate_indicators()for calculating all soil management indicators
Examples
#example that returns annual relative yield values
productivity_indicator(EXAMPLE_data)
#example that returns a tibble with additional information
productivity_indicator(EXAMPLE_data, extended.output = TRUE)
Calculate relative yield
Description
This function calculates the relative yield of an observed dry matter yield compared to the reference dry matter yield in the Swiss fertilizing guidelines (Sinaj et al. 2017).
Usage
relative_yield(var_crop, var_yield)
Arguments
var_crop |
string with name of crop type, must match with the Crops in the C_input_crops_LUT |
var_yield |
observed dry matter yield (tDM/ha) |
Value
the numeric value for the relative yield
References
Sinaj S, Charles R, Baux A, Dupuis B, Hiltbrunner J, Levy Häner L, Pellet D, Blanchet G, Jeangros B (2017). “Grundlagen für die Düngung landwirtschaftlicher Kulturen in der Schweiz (GRUD): Düngung von Ackerkulturen.” Agrarforschung Schweiz, Spezialpublikation, Chapter 8(6), 1–46. https://ira.agroscope.ch/en-US/Page/Publikation/Index/36799.
See Also
-
productivity_indicator()to calculate relative yields for amanagement_df -
C_input_crops_LUT()for reference yield used in therelative_yield()function
Examples
relative_yield("wheat, winter", 4.8)
select management operations that seed or terminate cover crops
Description
This is a helper function, not intended for stand-alone use by other packages.
Usage
select_cover_crop_sowing_and_termination(var_MGMT_data)
Arguments
var_MGMT_data |
a 'management_df' that contains the management information |
Value
a tibble with management operations that seed or terminate cover crops, with the following columns: crop, year, date, category, operation, duration_CC, biomass_CC
Examples
# example
select_cover_crop_sowing_and_termination(EXAMPLE_data)
Calculate Shannon Index for diversity
Description
This function calculates the Index of Shannon (1948) for a tibble with different species.
The formula that is used is
SI = -\sum_{i=1}^S (p_i * ln(p_i))
where p_i is the relative abundance of each species (i) of
the total number of species (S).
Usage
shannon_index(var_tibble)
Arguments
var_tibble |
a tibble with two columns (name of species, count per species), the second column must be called "count" |
Value
double of the Shannon Index
References
Shannon CE (1948). “A Mathematical Theory of Communication.” Bell System Technical Journal, 27(3), 379-423.
Spellerberg IF, Fedor PJ (2003). “A tribute to Claude Shannon (1916–2001) and a plea for more rigorous use of species richness, species diversity and the ‘Shannon–Wiener’Index.” Global ecology and biogeography, 12(3), 177–179. doi:10.1046/j.1466-822X.2003.00015.x.
See Also
plant_diversity() to calculate the shannon_index()
(and other diversity indices) for a management_df
Examples
#create tibble
tibble_example <- tibble::tibble(Plant = c("A","B","C","D","E"), count = c(10,5,8,20,10))
#calculate Shannon Index
shannon_index(tibble_example) # = 1.505...
Estimate soil cover by plants and residues
Description
Derives the days where soil cover by living plants or residues is >=30%.
Usage
soil_cover(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a |
extended.output |
an optional logical value.
|
Details
The function takes a management_df as input and returns soil cover
days per year in the management_df.
Alternatively, it can return a soil_cover_tibble with daily resolution
of the estimated soil cover.
The function calculates plant soil cover with the plant_cover() function
and the soil coverage by residues.
The residue mass is dependent on the residue supply by crops, its decay and its incorporation by tillage operations (Büchi et al. 2016).
Residue supply is estimated with the yield dependent
residue C C_input_straw provided by the function C_input_crops() and
a C content of 450 \ [mgC/gDM].
If residues are removed, the removed residue mass is subtracted.
Residue decay is calculated with the formula of Steiner et al. (1999):
M_t = M_{t-1} * (1 - k_{decay})
Where M_{t-1} is the residue mass of the prior day [g/m^2] and
k_{decay} is the daily decay rate that was assumed to be
0.028 g/g, the average decomposition rate of winter wheat straw
(Steiner et al. 1999).
Residue incorporation by tillage was estimated with the operation-specific
burial coefficient extracted from the RUSLE2 database
(USDA-NRCS 2023) that are provided in the
look-up-table STIR_values_LUT.
Residue mass is translated into percentage of soil cover by the formula of Steiner et al. (2000):
cover_{residues} = (1-e^{-k(M)})* 100 \%
Where M is the residue mass [g/m^2] and k is a cover
coefficient [m^2/g]. k was assumed to be 0.0175
(Steiner et al. 2000).
Value
By default, a tibble with soil cover days by year is returned.
If extended.output = TRUE, an object of the class
soil_cover_tibblewith daily resolution is returned.
References
Büchi L, Valsangiacomo A, Burel E, Charles R (2016).
“Integrating simulation data from a crop model in the development of an agri-environmental indicator for soil cover in Switzerland.”
European Journal of Agronomy, 76, 149–159.
doi:10.1016/j.eja.2015.11.004.
Steiner JL, Schomberg HH, Unger PW, Cresap J (1999).
“Crop residue decomposition in no-tillage small-grain fields.”
Soil Science Society of America Journal, 63(6), 1817–1824.
doi:10.2136/sssaj1999.6361817x.
Steiner JL, Schomberg HH, Unger PW, Cresap J (2000).
“Biomass and residue cover relationships of fresh and decomposing small grain residue.”
Soil Science Society of America Journal, 64(6), 2109–2114.
doi:10.2136/sssaj2000.6462109x.
USDA-NRCS (2023).
“Revised Universal Soil Loss Equation, Version 2 (RUSLE2), Official NRCS RUSLE2 Program and Database (V 2023-02-24).”
USDA-NCRS.
https://fargo.nserl.purdue.edu/rusle2_dataweb/RUSLE2_Index.htm.
See Also
-
calculate_indicators()to calculate all management indicators for amanagement_df -
calculate_soil_cover_tibble()a helper function that calculates the soil cover tibble -
plant_cover()for more detail on the plant cover function -
plot.soil_cover_tibble()for plotting thesoil_cover_tibble -
STIR_values_LUTfor tillage operation specific burial coefficients
Examples
#example that returns annual soil cover days by plants and residues
soil_cover(EXAMPLE_data)
#example that returns a soil_cover_tibble
soil_cover(EXAMPLE_data, extended.output = TRUE)
Estimate the stable organic matter of organic amendments per year
Description
stable_OM_amended() estimates the organic matter (OM) applied with
organic amendments and the part of it that is expected to be incorporated
into the soil organic matter (stable OM), per year of a management_df.
Usage
stable_OM_amended(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a |
extended.output |
an optional logical value.
|
Details
The OM input and the stable OM of each organic fertilization are
calculated with stable_OM_amendments(): the OM input is derived from the
C input (C_{input} / 0.5797) and multiplied with the indicator of
organic matter stability (ISMO) of the amendment. See
stable_OM_amendments() for the assumptions and sources.
Amendments with unknown ISMO give a warning and are not included in the
stable OM of the year (their OM input is included in OM_input_org).
Only organic amendments are considered so far. Crop residues and cover
crops are not included. The indicator is not part of
calculate_indicators().
Value
By default, a tibble with the OM input by organic amendments (
OM_input_org, kg OM/ha) and the stable OM (stable_OM_amended, kg OM/ha) per year. Years without organic amendments have the value 0.If
extended.output = TRUE, a tibble with all management operations and their OM input and stable OM.
See Also
-
stable_OM_amendments()for the calculation and its assumptions -
stable_OM_amended_by_crop()to summarize the stable OM by crop -
calculate_stable_OM_amended_tibble()a helper function that calculates the stable OM per operation
Examples
# stable OM per year
stable_OM_amended(EXAMPLE_data)
# all operations with their stable OM
stable_OM_amended(EXAMPLE_data, extended.output = TRUE)
Estimate the stable organic matter of organic amendments per crop
Description
Alternative to stable_OM_amended() that summarizes the organic matter
(OM) input and the stable OM of organic amendments for each crop instead
of each year.
Usage
stable_OM_amended_by_crop(var_management_df)
Arguments
var_management_df |
a |
Details
The crop periods are the same as in calculate_indicators_by_crop(): the
function identifies the last harvest of each crop per year with
identify_main_crops() and assigns all operations up to this harvest to
the crop. Operations after the last harvest of the management timeline have
no crop number (crop_no is NA).
The OM input and the stable OM are calculated with
stable_OM_amendments(), see there for the assumptions and sources.
Amendments with unknown ISMO give a warning and are not included in the
stable OM of the crop. Only organic amendments are considered so far,
crop residues and cover crops are not included.
Value
a tibble with the crop number, the year and date of the last
harvest, the crop, the OM input by organic amendments (OM_input_org,
kg OM/ha) and the stable OM (stable_OM_amended, kg OM/ha) per crop
See Also
-
stable_OM_amendments()for the calculation and its assumptions -
stable_OM_amended()to summarize the stable OM by year -
calculate_indicators_by_crop()for the other indicators by crop
Examples
# stable OM per crop
stable_OM_amended_by_crop(EXAMPLE_data)
Estimate the stable organic matter of organic amendments
Description
Estimates the amount of organic matter (OM) that is applied with an organic amendment and the part of it that is expected to be incorporated into the soil organic matter, based on the indicator of organic matter stability (ISMO).
Usage
stable_OM_amendments(
amount,
amd_type = NA,
DMC = NA,
C_content = NA,
N_content = NA,
ISMO = NA,
return.comment = FALSE,
concentration_liquids = 0.5,
unit = "t/ha",
N_availability = NA
)
Arguments
amount |
Amount of organic amendment in fresh weight (t/ha or m3/ha),
or in plant-available N (kg N_available/ha), see |
amd_type |
Type of organic manure, there are default values available for
"Slurry_dairy_cow", "Manure_dairy_cow", "Slurry_cattle", "Manure_cattle", "Slurry_pig",
"Manure_pig", "Compost", "Biorga_Quick_12N" and others (see |
DMC |
dry matter content of the organic amendment (gDM/kgFM) |
C_content |
C content of the dry matter (gC/kgDM) |
N_content |
N content of the dry matter (gN/kgDM) |
ISMO |
indicator of organic matter stability of the amendment
(fraction between 0 and 1). Default: value of the |
return.comment |
(optional): logical value if comments on the sources of the C input and the ISMO are returned or not. Default = FALSE |
concentration_liquids |
concentration factor for liquid amendments. Default value is .5. |
unit |
unit of |
N_availability |
fraction of the total N that is plant-available, only
used with |
Details
The OM input is not taken from the OM content of the amendment. It is
derived from the C input of CN_input_amendments(), assuming that 57.97 %
of the organic matter is carbon:
OM_{input} = \frac{C_{input}}{0.5797}
The same assumption was used to derive most C contents in
CN_input_amendments_LUT, so the OM input agrees with the OM content of
these amendments. For amendments whose C content was derived otherwise
(e.g. from a declared C/N ratio, such as the LANDOR products), the OM input
differs from the declared OM content. Because the OM input is derived from
the C input, all options of CN_input_amendments() apply (own DMC or C
content, dilution of liquid amendments, amounts in plant-available N).
The stable OM is the OM input multiplied by the ISMO of the amendment:
OM_{stable} = OM_{input} \cdot ISMO
The ISMO (indicator of potential residual organic carbon, I_{ROC},
(Lashermes et al. 2009)) estimates the proportion of the
organic C of an amendment that contributes to the soil organic C storage.
It was calibrated on laboratory incubations that were extrapolated until
the remaining C of the amendment degraded at a rate of 0.02 per year, and
is calculated from the biochemical fractions of the amendment and the C
mineralized during 3 days of incubation. As the OM input is derived from
the C input with a constant factor, the same fraction is applied to the OM.
In the AMG model, the ISMO is used as humification coefficient
(h or K_1): the fraction of the C input that is incorporated
into the active soil organic matter within one year
(Bouthier et al. 2014; Levavasseur et al. 2020). This organic
matter is not permanently stable, it is further mineralized over the
following years. The agreement with field data is uncertain: Lashermes et
al. (2009) found that the ISMO seemed to overestimate the residual C
measured in the few long-term field experiments available to them, while
Levavasseur et al. (2020) found that it underestimates on average the
humification coefficient fitted in seven long-term field experiments.
If ISMO is not supplied, the ISMO of amd_type in
CN_input_amendments_LUT is used. Its values are taken from
Levavasseur et al. (2020),
Bouthier et al. (2014) and
Berger et al. (2022)
(see column ISMO_source). If the ISMO is unknown, a warning is given and
stable_OM_amended is NA.
Only organic amendments are considered so far. Crop residues and cover crops are not included.
Value
a tibble with the following parameters:
OM_input_org: OM input by the organic amendment (kg OM/ha), derived from the C input
stable_OM_amended: stable OM, i.e. OM input times ISMO (kg OM/ha)
comment (optional): sources of the C input and the ISMO
References
Berger S, Sicard L, Houot S, Levavasseur F (2022).
“Contribution des Produits Résiduaires Organiques à la séquestration du carbone dans les sols.”
Technical Report 20-0518/1A, RECORD.
73 p., https://hal.science/hal-05070924.
Bouthier A, Duparque A, Mary B, Sagot S, Trochard R, Levert M, Houot S, Damay N, Denoroy P, Dinh J, Blin B, Ganteil F (2014).
“Adaptation et mise en œuvre du modèle de calcul de bilan humique à long terme AMG dans une large gamme de systèmes de grandes cultures et de polyculture-élevage.”
Innovations Agronomiques, 34, 125–139.
doi:10.17180/rgmy-kq04.
https://hal.science/hal-01192501.
Lashermes G, Nicolardot B, Parnaudeau V, Thuriès L, Chaussod R, Guillotin ML, Linères M, Mary B, Metzger L, Morvan T, Tricaud A, Villette C, Houot S (2009).
“Indicator of potential residual carbon in soils after exogenous organic matter application.”
European Journal of Soil Science, 60(2), 297–310.
ISSN 1365-2389.
doi:10.1111/j.1365-2389.2008.01110.x.
Levavasseur F, Mary B, Christensen BT, Duparque A, Ferchaud F, Kätterer T, Lagrange H, Montenach D, Resseguier C, Houot S (2020).
“The simple AMG model accurately simulates organic carbon storage in soils after repeated application of exogenous organic matter.”
Nutrient Cycling in Agroecosystems.
doi:10.1007/s10705-020-10065-x.
See Also
-
stable_OM_amended()to calculate the stable OM of organic amendments for amanagement_df -
CN_input_amendments()for the C input that the OM input is derived from -
CN_input_amendments_LUT()for the default values of the organic amendments
Examples
# amendment of the look-up-table
stable_OM_amendments(20, "Manure_pig")
# own properties and ISMO
stable_OM_amendments(30, DMC = 250, C_content = 400, N_content = 25, ISMO = 0.6)
Estimate tillage intensity
Description
Calculates the soil tillage intensity per year.
The function takes a management_df as input and returns a STIR value
per year in the management_df. Alternatively, it can return a
extensive tibble with each operation and their respective STIR values.
Usage
tillage_intensity(var_MGMT_data, extended.output = FALSE)
Arguments
var_MGMT_data |
a |
extended.output |
an optional logical value. Default value is
|
Value
by default, a tibble with STIR values by year is returned. If extended.output = TRUE, a tibble with daily resolution is returned.
See Also
-
STIR()for the calculation of aSTIRvalue for operations -
STIR_values_LUT()for the reference data used for tillage operations -
calculate_indicators()to calculate all management indicators for amanagement_df -
calculate_STIR_tibble()a helper function that calculates the STIR input tibble
Examples
#example that returns annual STIR values
tillage_intensity(EXAMPLE_data)
#example that returns a tibble with all operations that have a STIR value
tillage_intensity(EXAMPLE_data, extended.output = TRUE)