Umeå University's logo

Light exposure fundamentally influences human physiology and behavior, with light being the most important zeitgeber of the circadian system. Throughout the day, people are exposed to various scenes differing in light level, spectral composition and spatio-temporal properties. Personalized light exposure can be measured through wearable light loggers and dosimeters, including wrist-worn actimeters containing light sensors, yielding time series of an individual’s light exposure. There is growing interest in relating light exposure patterns to health outcomes, requiring analytic techniques to summarize light exposure properties. Building on the previously published Python-based pyActigraphy module, here we introduce the module pyLight. This module allows users to extract light exposure data recordings from a wide range of devices. It also includes software tools to clean and filter the data, and to compute common metrics for quantifying and visualizing light exposure data. For this tutorial, we demonstrate the use of pyLight in one example dataset with the following processing steps: (1) loading, accessing and visual inspection of a publicly available dataset, (2) truncation, masking, filtering and binarization of the dataset, (3) calculation of summary metrics, including time above threshold (TAT) and mean light timing above threshold (MLiT). The pyLight module paves the way for open-source, large-scale automated analyses of light-exposure data.