From 6acfd0dfb2670e3eeab6144c90586f28105583a8 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Wed, 20 Jun 2018 14:53:02 +0200 Subject: Update static docs --- docs/reference/PEC_soil.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/reference/PEC_soil.html') diff --git a/docs/reference/PEC_soil.html b/docs/reference/PEC_soil.html index 65c8519..feed9d5 100644 --- a/docs/reference/PEC_soil.html +++ b/docs/reference/PEC_soil.html @@ -64,7 +64,7 @@ the concepts layed out for example in the PPR panel opinion (EFSA 2012)." /> pfm - 0.4.5 + 0.4.6 -- cgit v1.2.1 From 8989a484b9b2d23463c95e0a3927e307ec0a5e64 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Wed, 4 Jul 2018 10:59:47 +0200 Subject: Some documentation updates Document that TOXSWA 5.5.3 is supported in the help files --- docs/reference/PEC_soil.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/reference/PEC_soil.html') diff --git a/docs/reference/PEC_soil.html b/docs/reference/PEC_soil.html index feed9d5..5073067 100644 --- a/docs/reference/PEC_soil.html +++ b/docs/reference/PEC_soil.html @@ -150,7 +150,7 @@ the concepts layed out for example in the PPR panel opinion (EFSA 2012).

interval

Period of the deeper mixing, defaults to 365, which is a year if -rate units are in days

+degradation rate units are in days

n_periods -- cgit v1.2.1 From 22b36c824fe5e1561868a649216fe079c6fbfb85 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Tue, 10 Jul 2018 18:06:29 +0200 Subject: Update static docs --- docs/reference/PEC_soil.html | 77 +++++++++++++++++++++++++++++++++++++------- 1 file changed, 66 insertions(+), 11 deletions(-) (limited to 'docs/reference/PEC_soil.html') diff --git a/docs/reference/PEC_soil.html b/docs/reference/PEC_soil.html index 5073067..8903470 100644 --- a/docs/reference/PEC_soil.html +++ b/docs/reference/PEC_soil.html @@ -33,9 +33,10 @@ +the concepts layed out in the PPR panel opinion (EFSA PPR panel 2012 +and in the EFSA guidance on PEC soil calculations (EFSA, 2015, 2017)." /> @@ -64,7 +65,7 @@ the concepts layed out for example in the PPR panel opinion (EFSA 2012)." /> pfm - 0.4.6 + 0.5.1 @@ -108,17 +109,20 @@ the concepts layed out for example in the PPR panel opinion (EFSA 2012)." />

This is a basic calculation of a contaminant concentration in bulk soil -based on complete, instantaneous mixing. If an interval is given, an +based on complete, instantaneous mixing. If an interval is given, an attempt is made at calculating a long term maximum concentration using -the concepts layed out for example in the PPR panel opinion (EFSA 2012).

+the concepts layed out in the PPR panel opinion (EFSA PPR panel 2012 +and in the EFSA guidance on PEC soil calculations (EFSA, 2015, 2017).

PEC_soil(rate, rate_units = "g/ha", interception = 0, mixing_depth = 5,
   PEC_units = "mg/kg", PEC_pw_units = "mg/L", interval = NA,
-  n_periods = Inf, tillage_depth = 20, chent = NA, DT50 = NA,
+  n_periods = Inf, tillage_depth = 20, leaching_depth = tillage_depth,
+  crop = "annual", cultivation = FALSE, chent = NA, DT50 = NA,
   Koc = NA, Kom = Koc/1.724, t_avg = 0, scenarios = c("default",
-  "EFSA_2015"), porewater = FALSE)
+ "EFSA_2017", "EFSA_2015"), leaching = scenarios == "EFSA_2017", + porewater = FALSE)

Arguments

@@ -160,9 +164,28 @@ degradation rate units are in days

+ + + + + + + + + + + + - @@ -193,6 +216,11 @@ the DT50 is taken to be a modelling half-life at 20°C and pF2 (for when 'chents' is specified, the DegT50 with destination 'PECgw' will be used), and corrected using an Arrhenius activation energy of 65.4 kJ/mol. Also model and scenario adjustment factors from the EFSA guidance are used.

+ + + + @@ -212,14 +240,24 @@ p. 13).

This assumes that the complete load to soil during the time specified by 'interval' (typically 365 days) is dosed at once. As in the PPR panel -opinion cited below (PPR panel 2012), only temperature correction using the +opinion cited below (EFSA PPR panel 2012), only temperature correction using the Arrhenius equation is performed.

Total soil and porewater PEC values for the scenarios as defined in the EFSA -guidance (2015, p. 13) can easily be calculated.

+guidance (2017, p. 14/15) can easily be calculated.

Note

-

If temperature information is available in the selected scenarios, as +

While time weighted average (TWA) concentrations given in the examples +from the EFSA guidance from 2015 (p. 80) are be reproduced, this is not +true for the TWA concentrations given for the same example in the EFSA guidance +from 2017 (p. 92).

+

According to the EFSA guidance (EFSA, 2017, p. 43), leaching should be + taken into account for the EFSA 2017 scenarios, using the evaluation depth + (here mixing depth) as the depth of the layer from which leaching takes + place. However, as the amount leaching below the evaluation depth + (often 5 cm) will partly be mixed back during tillage, the default in this function + is to use the tillage depth for the calculation of the leaching rate.

+

If temperature information is available in the selected scenarios, as e.g. in the EFSA scenarios, the DT50 for groundwater modelling (destination 'PECgw') is taken from the chent object, otherwise the DT50 with destination 'PECsoil'.

@@ -231,6 +269,11 @@ guidance (2015, p. 13) can easily be calculated.

selection and scenario parameterisation for predicting environmental concentrations of plant protection products in soil. EFSA Journal10(2) 2562, doi:10.2903/j.efsa.2012.2562

+

EFSA (European Food Safety Authority) 2017) EFSA guidance document for + predicting environmental concentrations of active substances of plant + protection products and transformation products of these active substances + in soil. EFSA Journal 15(10) 4982 + doi:10.2903/j.efsa.2017.4982

EFSA (European Food Safety Authority) (2015) EFSA guidance document for predicting environmental concentrations of active substances of plant protection products and transformation products of these active substances @@ -242,6 +285,18 @@ guidance (2015, p. 13) can easily be calculated.

PEC_soil(100, interception = 0.25)
#> scenario #> t_avg default #> 0 0.1
+# This is example 1 starting at p. 92 of the EFSA guidance (2017) +# Note that TWA concentrations differ from the ones given in the guidance +# for an unknown reason (the values from EFSA (2015) can be reproduced). +PEC_soil(1000, interval = 365, DT50 = 250, t_avg = c(0, 21), + Kom = 1000, scenarios = "EFSA_2017")
#> scenario +#> t_avg CTN CTC CTS +#> 0 19.76834 13.8619 10.53795 +#> 21 19.59345 13.7169 10.39882
PEC_soil(1000, interval = 365, DT50 = 250, t_av = c(0, 21), + Kom = 1000, scenarios = "EFSA_2017", porewater = TRUE)
#> scenario +#> t_avg CLN CLC CLS +#> 0 0.5541984 0.6779249 0.9816693 +#> 21 0.5484576 0.6693125 0.9609119
# This is example 1 starting at p. 79 of the EFSA guidance (2015) PEC_soil(1000, interval = 365, DT50 = 250, t_avg = c(0, 21), scenarios = "EFSA_2015")
#> scenario -- cgit v1.2.1
tillage_depth

Periodic (see interval) deeper mixing in cm

leaching_depth

EFSA (2017) uses the mixing depth (ecotoxicological +evaluation depth) to calculate leaching for annual crops where tillage +takes place. By default, losses from the layer down to the tillage +depth are taken into account in this implementation.

crop

Ignored for scenarios other than EFSA_2017. Only annual crops +are supported when these scenarios are used. Only crops with a single cropping +cycle per year are currently supported.

cultivation

Does mechanical cultivation in the sense of EFSA (2017) +take place, i.e. twice a year to a depth of 5 cm? Ignored for scenarios +other than EFSA_2017

chent

An optional chent object holding substance specific information. Can +

An optional chent object holding substance specific information. Can also be a name for the substance as a character string

leaching

Should leaching be taken into account? The default is FALSE, +except when the EFSA_2017 scenarios are used.

porewater