mc_prep_clean {myClim}

Cleaning datetime series

Description

By default mc_prep_clean runs automatically when mc_read_files(), mc_read_data() are called. mc_prep_clean checks time-series in myClim object in Raw-format for missing, duplicated, and disordered records and regularizes microclimatic time-series to constant time-step. Duplicated records are removed and missing values are filled with NA.

See details.

Usage

mc_prep_clean(data, silent = FALSE)

Arguments

data

myClim object in Raw-format. see myClim-package

silent

if true, then cleaning log table and progress bar is not printed in console (default FALSE), see mc_info_clean()

Details

Processing the data with mc_prep_clean is a mandatory step required for further data handling in myClim library.

This function guarantee that all time series are in chronological order, have regular time-step and no duplicated records. Function mc_prep_clean use time-step provided by user during data import with mc_read (used time-step is permanently stored in logger metadata mc_LoggerMetadata. If time-step is not provided by the user (NA),than myClim automatically detects the time-step from input time series based on the last 100 records. In case of irregular time series, function returns warning and skip the series.

In case the time-step is regular, but is not nicely rounded, function rounds the time series to the closest nice time and shifts original data. E.g., original records in 10 min regular step c(11:58, 12:08, 12:18, 12:28) are shifted to newly generated nice sequence c(12:00, 12:10, 12:20, 12:30). Note that microclimatic records are not modified but only shifted. Maximum allowed shift of time series is 30 minutes. For example, when the time-step is 2h (e.g. 13:33, 15:33, 17:33), the measurement times are shifted to (13:30, 15:30, 17:30). When you have 2h time step and wish to round to the whole hour (13:33 -> 14:00, 15:33 -> 16:00) than use mc_agg(period="2 hours") command after data cleaning.

Value

• cleaned myClim object in Raw-format

• cleaning log is by default printed in console, but can be called also later by mc_info_clean()

Examples

cleaned_data <- mc_prep_clean(mc_data_example_raw)