The wrapper function returning 4 standardised and ecologically relevant myClim variables derived from soil moisture measurements. The mc_env_moist function needs time-series of volumetric water content (VWC) measurements as input. Therefore, non-VWC soil moisture measurements must be first converted to VWC. For TMS loggers see mc_calc_vwc()

mc_env_moist(
  data,
  period,
  use_utc = TRUE,
  custom_start = NULL,
  custom_end = NULL,
  min_coverage = 1
)

Arguments

data

cleaned myClim object see myClim-package

period

output period see mc_agg()

use_utc

if FALSE, then local time is used for day aggregation see mc_agg() (default TRUE)

custom_start

start date for custom period see mc_agg() (default NULL)

custom_end

end date for custom period see mc_agg() (default NULL)

min_coverage

the threshold specifying how many missing values can you accept within aggregation period. see mc_agg() value from range 0-1 (default 1)

Value

table in long format with standardised myClim variables

Details

This function was designed for time-series of step shorter than one day and will not work with coarser data. In contrast with other myClim functions returning myClim objects, this wrapper function returns long table. Variables are named based on sensor name, height, and function e.g., (VWC.soil_0_15_cm.5p, VWC.soil_0_15_cm.mean)

Standardised myClim soil moisture variables:

  • VWC.5p: Minimum soil moisture = 5th percentile of VWC values

  • VWC.mean: Mean soil moisture = mean of VWC values

  • VWC.95p: Maximum soil moisture = 95th percentile of VWC values

  • VWC.sd: Standard deviation of VWC measurements

Examples

data <- mc_prep_crop(mc_data_example_agg, lubridate::ymd_h("2020-11-01 00"),
                     lubridate::ymd_h("2021-02-01 00"), end_included = FALSE)
data <- mc_calc_vwc(data, localities=c("A2E32", "A6W79"))
mc_env_moist(data, "month")
#>    locality_id serial_number           sensor_name       height   datetime
#> 1        A2E32          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2020-11-01
#> 2        A2E32          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2020-12-01
#> 3        A2E32          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2021-01-01
#> 4        A2E32          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2020-11-01
#> 5        A2E32          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2020-12-01
#> 6        A2E32          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2021-01-01
#> 7        A2E32          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2020-11-01
#> 8        A2E32          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2020-12-01
#> 9        A2E32          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2021-01-01
#> 10       A2E32          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2020-11-01
#> 11       A2E32          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2020-12-01
#> 12       A2E32          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2021-01-01
#> 13       A6W79          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2020-11-01
#> 14       A6W79          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2020-12-01
#> 15       A6W79          <NA>   VWC.soil_0_15_cm.5p soil 0-15 cm 2021-01-01
#> 16       A6W79          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2020-11-01
#> 17       A6W79          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2020-12-01
#> 18       A6W79          <NA>  VWC.soil_0_15_cm.95p soil 0-15 cm 2021-01-01
#> 19       A6W79          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2020-11-01
#> 20       A6W79          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2020-12-01
#> 21       A6W79          <NA> VWC.soil_0_15_cm.mean soil 0-15 cm 2021-01-01
#> 22       A6W79          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2020-11-01
#> 23       A6W79          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2020-12-01
#> 24       A6W79          <NA>   VWC.soil_0_15_cm.sd soil 0-15 cm 2021-01-01
#>       time_to       value
#> 1  2020-12-01 0.314532352
#> 2  2021-01-01 0.320491413
#> 3  2021-02-01 0.341144905
#> 4  2020-12-01 0.332362840
#> 5  2021-01-01 0.362125650
#> 6  2021-02-01 0.392771867
#> 7  2020-12-01 0.321261539
#> 8  2021-01-01 0.331435449
#> 9  2021-02-01 0.353720182
#> 10 2020-12-01 0.005022976
#> 11 2021-01-01 0.014920693
#> 12 2021-02-01 0.015006167
#> 13 2020-12-01 0.227505658
#> 14 2021-01-01 0.252133071
#> 15 2021-02-01 0.299580002
#> 16 2020-12-01 0.269696653
#> 17 2021-01-01 0.340694831
#> 18 2021-02-01 0.425596891
#> 19 2020-12-01 0.248901171
#> 20 2021-01-01 0.281706679
#> 21 2021-02-01 0.354659799
#> 22 2020-12-01 0.014359974
#> 23 2021-01-01 0.031077848
#> 24 2021-02-01 0.036357728