Package: LightLogR 0.4.0

Johannes Zauner

LightLogR: Process Data from Wearable Light Loggers and Optical Radiation Dosimeters

Import, processing, validation, and visualization of personal light exposure measurement data from wearable devices. The package implements features such as the import of data and metadata files, conversion of common file formats, validation of light logging data, verification of crucial metadata, calculation of common parameters, and semi-automated analysis and visualization.

Authors:Johannes Zauner [aut, cre], Manuel Spitschan [aut], Steffen Hartmeyer [aut], MeLiDos [fnd], EURAMET [fnd], European Union [fnd], TSCN-Lab [cph]

LightLogR_0.4.0.tar.gz
LightLogR_0.4.0.zip(r-4.5)LightLogR_0.4.0.zip(r-4.4)LightLogR_0.4.0.zip(r-4.3)
LightLogR_0.4.0.tgz(r-4.4-any)LightLogR_0.4.0.tgz(r-4.3-any)
LightLogR_0.4.0.tar.gz(r-4.5-noble)LightLogR_0.4.0.tar.gz(r-4.4-noble)
LightLogR_0.4.0.tgz(r-4.4-emscripten)LightLogR_0.4.0.tgz(r-4.3-emscripten)
LightLogR.pdf |LightLogR.html✨
LightLogR/json (API)
NEWS

# Install 'LightLogR' in R:
install.packages('LightLogR', repos = c('https://tscnlab.r-universe.dev', 'https://cloud.r-project.org'))

Peer review:

Bug tracker:https://github.com/tscnlab/lightlogr/issues

Datasets:

On CRAN:

dosimetrylighttime-series-analysiswearable-deviceswearable-sensors

57 exports 9 stars 2.64 score 116 dependencies 10 scripts 204 downloads

Last updated 9 days agofrom:25a1651740. Checks:OK: 7. Indexed: yes.

TargetResultDate
Doc / VignettesOKSep 09 2024
R-4.5-winOKSep 09 2024
R-4.5-linuxOKSep 09 2024
R-4.4-winOKSep 09 2024
R-4.4-macOKSep 09 2024
R-4.3-winOKSep 09 2024
R-4.3-macOKSep 09 2024

Exports:%>%aggregate_Dateaggregate_Datetimebarroso_lighting_metricsbright_dark_periodBrown_checkBrown_recBrown2referencecentroidLEcount_difftimecreate_Timedatacut_Datetimedata2referenceDatetime_breaksDatetime_limitsdisparity_indexdominant_epochdst_change_handlerdst_change_summaryduration_above_thresholdexponential_moving_averagefilter_Datefilter_Datetimefilter_Datetime_multiplefilter_Timefrequency_crossing_thresholdgap_findergap_handlergapless_Datetimesgg_daygg_daysgg_doubleplotgg_overviewimportimport_adjustmentimport_Datasetimport_Statechangesinterdaily_stabilityinterval2stateintradaily_variabilityjoin_datasetsll_import_exprmidpointCEnvRCnvRC_circadianBiasnvRC_circadianDisturbancenvRC_relativeAmplitudeErrornvRDnvRD_cumulative_responseperiod_above_thresholdpulses_above_thresholdsc2intervalsleep_int2Brownsupported_devicessymlog_transthreshold_for_durationtiming_above_threshold

Dependencies:askpassbase64encbitbit64bslibcachemcallrclicliprcolorspacecommonmarkcowplotcpp11crayoncrosstalkcurldata.tabledescdigestdplyrevaluatefansifarverfastmapflextablefontawesomefontBitstreamVerafontLiberationfontquiverfsgdtoolsgenericsggplot2ggsciggtextgluegridtextgtablehighrhmshtmltoolshtmlwidgetshttrisobandjpegjquerylibjsonliteknitrlabelinglaterlatticelazyevallifecyclelubridatemagrittrmarkdownMASSMatrixmemoisemgcvmimemunsellnlmeofficeropensslpackratpillarpkgbuildpkgconfigpkgloadPKIplotlypngprettyunitsprocessxprogresspromisespspurrrR6raggrappdirsRColorBrewerRcppreadrrenvrlangrmarkdownrprojrootrsconnectrstudioapisassscalessliderstringistringrsyssystemfontstextshapingtibbletidyrtidyselecttimechangetinytextzdbutf8uuidvctrsviridisLitevroomwarpwithrxfunxml2yamlzip

Readme and manuals

Help Manual

Help pageTopics
Aggregate dates to a single dayaggregate_Date
Aggregate Datetime dataaggregate_Datetime
Circadian lighting metrics from Barroso et al. (2014)barroso_lighting_metrics
Brightest or darkest continuous periodbright_dark_period
Check whether a value is within the recommended illuminance/MEDI levels by Brown et al. (2022)Brown_check
Set the recommended illuminance/MEDI levels by Brown et al. (2022)Brown_rec
Add Brown et al. (2022) reference illuminance to a datasetBrown2reference
Centroid of light exposurecentroidLE
Counts the Time differences (epochs) per group (in a grouped dataset)count_difftime
Create a Time-of-Day column in the datasetcreate_Timedata
Create Datetime bins for visualization and calculationcut_Datetime
Create reference data from other datadata2reference
Create a (shifted) sequence of Datetimes for axis breaksDatetime_breaks
Find or set sensible limits for Datetime axisDatetime_limits
Disparity indexdisparity_index
Determine the dominant epoch/interval of a datasetdominant_epoch
Handle jumps in Daylight Savings (DST) that are missing in the datadst_change_handler
Get a summary of groups where a daylight saving time change occurs.dst_change_summary
Duration above/below threshold or within threshold rangeduration_above_threshold
Exponential moving average filter (EMA)exponential_moving_average
Filter Datetimes in a dataset.filter_Date filter_Datetime
Filter multiple times based on a list of arguments.filter_Datetime_multiple
Filter Times in a dataset.filter_Time
Frequency of crossing light thresholdfrequency_crossing_threshold
Check for and output gaps in a datasetgap_finder
Fill implicit gaps in a light logger datasetgap_handler
Create a gapless sequence of Datetimesgapless_Datetimes
Create a simple Time-of-Day plot of light logger data, faceted by Dategg_day
Create a simple datetime plot of light logger data, faceted by groupgg_days
Double Plotsgg_doubleplot
Plot an overview of dataset intervals with implicit missing datagg_overview
Adjust device imports or make your ownimport_adjustment
Import a light logger dataset or related dataimport import_Dataset
Import data that contain 'Datetimes' of 'Statechanges'import_Statechanges
Interdaily stability (IS)interdaily_stability
Adds a state column to a dataset from interval datainterval2state
Intradaily variability (IV)intradaily_variability
Join similar Datasetsjoin_datasets
Get the import expression for a devicell_import_expr
Midpoint of cumulative light exposure.midpointCE
Non-visual circadian responsenvRC
Performance metrics for circadian responsenvRC_circadianBias nvRC_circadianDisturbance nvRC_metrics nvRC_relativeAmplitudeError
Non-visual direct responsenvRD
Cumulative non-visual direct responsenvRD_cumulative_response
Length of longest continuous period above/below thresholdperiod_above_threshold
Pulses above thresholdpulses_above_threshold
Sample of wearable data combined with environmental datasample.data.environment
Statechange (sc) Timestamps to Intervalssc2interval
Recode Sleep/Wake intervals to Brown state intervalssleep_int2Brown
Get all the supported devices in LightLogRsupported_devices
Scale positive and negative values on a log scalesymlog_trans
Find threshold for given durationthreshold_for_duration
Mean/first/last timing above/below threshold.timing_above_threshold