LightLogR0.9.2 package

Process Data from Wearable Light Loggers and Optical Radiation Dosimeters

add_Date_col

Create a Date column in the dataset

cut_Datetime

Create Datetime bins for visualization and calculation

data2reference

Create reference data from other data

Datetime_breaks

Create a (shifted) sequence of Datetimes for axis breaks

Datetime_limits

Find or set sensible limits for Datetime axis

Datetime2Time

Convert Datetime columns to Time columns

durations

Calculate duration of data in each group

filter_Datetime_multiple

Filter multiple times based on a list of arguments.

filter_Datetime

Filter Datetimes in a dataset.

filter_Time

Filter Times in a dataset.

frequency_crossing_threshold

Frequency of crossing light threshold

gg_heatmap

Plot a heatmap across days and times of day

import_Dataset

Import a light logger dataset or related data

import_Statechanges

Import data that contain Datetimes of Statechanges

interdaily_stability

Interdaily stability (IS)

interval2state

Adds a state column to a dataset from interval data

intradaily_variability

Intradaily variability (IV)

mean_daily

Calculate mean daily metrics from daily summary

pulses_above_threshold

Pulses above threshold

add_states

Add states to a dataset based on groups and start/end times

add_Time_col

Create a Time-of-Day column in the dataset

aggregate_Date

Aggregate dates to a single day

aggregate_Datetime

Aggregate Datetime data

barroso_lighting_metrics

Circadian lighting metrics from Barroso et al. (2014)

bright_dark_period

Brightest or darkest continuous period

Brown_check

Check whether a value is within the recommended illuminance/MEDI level...

Brown_cut

Create a state column that cuts light levels into sections by Brown et...

Brown_rec

Set the recommended illuminance/MEDI levels by Brown et al. (2022)

Brown2reference

Add Brown et al. (2022) reference illuminance to a dataset

centroidLE

Centroid of light exposure

count_difftime

Counts the Time differences (epochs) per group (in a grouped dataset)

create_Timedata

create_Timedata

disparity_index

Disparity index

dominant_epoch

Determine the dominant epoch/interval of a dataset

dose

Calculate the dose (value·hours)

dst_change_handler

Handle jumps in Daylight Savings (DST) that are missing in the data

dst_change_summary

Get a summary of groups where a daylight saving time change occurs.

duration_above_threshold

Duration above/below threshold or within threshold range

exponential_moving_average

Exponential moving average filter (EMA)

extract_clusters

Find and extract clusters from a dataset

extract_gaps

Extract gap episodes from the data

extract_metric

Add metrics to extracted sSummary

extract_states

Extract summaries of states

gap_finder

Check for and output gaps in a dataset

gap_handler

Fill implicit gaps in a light logger dataset

gap_table

Tabular summary of data and gaps in all groups

gapless_Datetimes

Create a gapless sequence of Datetimes

gg_day

Create a simple Time-of-Day plot of light logger data, faceted by Date

gg_days

Create a simple datetime plot of light logger data, faceted by group

gg_doubleplot

Double Plots

gg_gaps

Visualize gaps and irregular data

gg_overview

Plot an overview of dataset intervals with implicit missing data

gg_photoperiod

Add photoperiods to gg_day() or gg_days() plots

gg_state

Add states to gg_day() or gg_days() plots

has_gaps

Does a dataset have implicit gaps

has_irregulars

Does a dataset have irregular data

import_adjustment

Adjust device imports or make your own

join_datasets

Join similar Datasets

LightLogR-package

LightLogR: Process Data from Wearable Light Loggers and Optical Radiat...

ll_import_expr

Get the import expression for a device

log_zero_inflated

Add a defined number to a numeric and log transform it

mean_daily_metric

Calculate mean daily metrics from Time Series

midpointCE

Midpoint of cumulative light exposure.

normalize_counts

Normalize counts between sensor outputs

number_states

Number non-consecutive state occurrences

nvRC_metrics

Performance metrics for circadian response

nvRC

Non-visual circadian response

nvRD_cumulative_response

Cumulative non-visual direct response

nvRD

Non-visual direct response

period_above_threshold

Length of longest continuous period above/below threshold

photoperiod

Calculate photoperiod and boundary times

pipe

Pipe operator

remove_partial_data

Remove groups that have too few data points

reverse2_trans

Create a reverse transformation function specifically for date scales

sc2interval

Statechange (sc) Timestamps to Intervals

sleep_int2Brown

Recode Sleep/Wake intervals to Brown state intervals

spectral_integration

Integrate spectral irradiance with optional weighting

spectral_reconstruction

Reconstruct spectral irradiance from sensor counts

summarize_numeric

Summarize numeric columns in dataframes to means

supported_devices

Get all the supported devices in LightLogR

symlog_trans

Scale positive and negative values on a log scale

threshold_for_duration

Find threshold for given duration

timing_above_threshold

Mean/first/last timing above/below threshold.

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.

  • Maintainer: Johannes Zauner
  • License: MIT + file LICENSE
  • Last published: 2025-06-10