mc_states_to_sensor: Convert states to logical (TRUE/FALSE) sensor

In myClim: Microclimatic Data Processing

Convert states to logical (TRUE/FALSE) sensor

Description

This function creates a logical (TRUE/FALSE) sensor from specified states.

Usage

mc_states_to_sensor(
  data,
  tag,
  to_sensor,
  source_sensor = NULL,
  inverse = FALSE
)

Arguments

data	myClim object see myClim-package
tag	The tag of states to be converted into a sensor.
to_sensor	A vector of names for the output sensors. If `to_sensor` is a single sensor name, the logical sensor is created from the union of states across all sensors with the same tag. If `to_sensor` contains multiple sensor names, the length of the vector must match the length of `source_sensor`.
source_sensor	A vector of sensors containing the states to be converted into a new sensor. If NULL, states from all sensors are used. (default is NULL)
inverse	A logical value. If TRUE, the sensor value is FALSE for state intervals (default is FALSE).

Details

The function allows you to create a TRUE/FALSE sensor based on a tag. By default, it generates a new sensor by combining all tags specified in the tag parameter from all available sensors at a particular logger or locality. If you specify a source_sensor, the function converts only the tags from that specific sensor. You can also create multiple new sensors from multiple tags by specifying more values in to_sensor and providing exactly the same number of corresponding values in source_sensor. For example, you can create one TRUE/FALSE sensor from states on a temperature sensor and another from tags on a moisture sensor.

If you use parameter inverse = TRUE you get FALSE for each record where tag is assigned to and FALSE for the records where tag is absent. By default you get TRUE for all the records where tag is assigned.

Value

Returns a myClim object in the same format as the input, with added sensors.

Examples

states <- data.frame(locality_id="A1E05", logger_index=1, sensor_name="Thermo_T", tag="error",
                     start=lubridate::ymd_hm("2020-10-28 9:00"),
                     end=lubridate::ymd_hm("2020-10-28 9:30"))
data <- mc_states_insert(mc_data_example_clean, states)
data <- mc_states_to_sensor(data, tag="error", to_sensor="error_sensor")

myClim documentation built on Oct. 21, 2024, 5:07 p.m.