Filter data from myClim object — mc

This function filter data by localities, logger types and sensors.

mc_filter(
  data,
  localities = NULL,
  logger_types = NULL,
  loggers = NULL,
  sensors = NULL,
  reverse = FALSE,
  stop_if_empty = TRUE
)

Arguments

data: myClim object see myClim-package
localities: locality_ids for filtering data; if NULL then do nothing (default NULL)
logger_types: types of logger for filtering data; if NULL then do nothing (default NULL). The logger_types parameter can by used only for raw data format see myClim-package.
loggers: logger_names for filtering data; if NULL then do nothing (default NULL). The loggers parameter can by used only for raw data format see myClim-package.
sensors: sensor_names for filtering data; if NULL then do nothing see names(mc_data_sensors) (default NULL)
reverse: if TRUE then input localities and/or sensors are excluded (default FALSE)
stop_if_empty: if TRUE then error for empty output (default TRUE)

Value

filtered myClim object

Details

In default settings it returns the object containing input localities / logger types / loggers / sensors. When you provide vector of localities e.g. localities=c("A6W79", "A2E32") selected localities are filtered with all loggers / sensors on those localities. When you provide vector of loggers e.g. loggers=c("TMS_1", "TMS_2") selected loggers are filtered through all localities. The same as When you provide vector of logger_types logger_types=c("TMS", "TMS_L45") selected loggers by type are filtered through all localities. (loggers or logger_types criterion is applicable only for raw data format see myClim-package) and the sensors parameter sensors=c("TMS_T1", "TMS_T2"), selected sensors are filtered through all localities. When you combine localities, logger_types/loggers and sensors, then filtering return selected sensors in selected loggers on selected localities.

Parameter reverse = TRUE returns myClim object complemented to object filtered by parameter reverse = FALSE.

reverse = TRUE and localities are selected then the listed localities are removed from myClim object.
reverse = TRUE and loggers are selected then the listed loggers are removed from all localities.
reverse = TRUE and logger_types are selected then the listed logger types are removed from all localities.
reverse = TRUE and sensors are selected then listed sensors are removed from all loggers / localities.
reverse = TRUE and localities and loggers are selected then the listed loggers are removed only from listed localities.

Only one of parameters loggers or logger_types can be used.

Examples

## keep only "A6W79", "A2E32" localities with all their sensors
filtered_data <- mc_filter(mc_data_example_raw, localities=c("A6W79", "A2E32"))

## remove "A6W79", "A2E32" localities and keep all others
filtered_data <- mc_filter(mc_data_example_raw, localities=c("A6W79", "A2E32"), reverse=TRUE)

## keep only "TMS_T1", and "TMS_T2" sensors on all localities
filtered_data <- mc_filter(mc_data_example_raw, sensors=c("TMS_T1", "TMS_T2"))

## remove "TMS_T1", and "TMS_T2" sensors from all localities
filtered_data <- mc_filter(mc_data_example_raw, sensors=c("TMS_T1", "TMS_T2"),reverse=TRUE)

## keep only "TMS_T1", and "TMS_T2" sensors on "A6W79", "A2E32" localities
filtered_data <- mc_filter(mc_data_example_raw, localities=c("A6W79", "A2E32"),
                           sensors=c("TMS_T1", "TMS_T2"))
## Remove "Dendro" loggers on all localities
filtered_data <- mc_filter(mc_data_example_raw, logger_types="Dendro", reverse=TRUE)