LightLogR webinar

This repository holds the teaching materials for the course Open and reproducible analysis of light exposure and visual experience data. The published website is available at https://tscnlab.github.io/LightLogR_webinar/ and contains the same Quarto documents in a browsable format.

What is in this course?

• Beginner track – introduces the LightLogR workflow and tidy R practices using a self-contained dataset. Both live (webR) and static scripts are available: beginner-live.qmd and beginner.qmd.
• Advanced track – four use cases with real-world constraints (many participants, sensitivity to light, therapy lamps, multimodal visual experience). Each use case has live and static variants (e.g., advanced_01_a_day_in_daylight-live.qmd and advanced_01_a_day_in_daylight.qmd).
• Recordings and overview – see recordings.qmd and the landing page index.qmd for summaries, requirements, and links to flyers/registration.
• Helper scripts – reusable code for figures and tables in scripts/.

Repository structure

• Quarto sources (*.qmd) for both live and static lessons, plus styling in styles.css and shared assets in assets/.
• Input data and metadata used by the tutorials in data/.
• A reproducible R environment defined by renv.lock and the project file LightLogR_Webinar.Rproj.
• Pre-rendered site output lives in docs/, which backs the GitHub Pages site.

Reproducing the static scripts locally

The static Quarto files run on a local R installation and render the full analysis pipeline end-to-end.

1. Clone or download this repository and open it in RStudio (optional) via LightLogR_Webinar.Rproj.
2. Restore the exact package versions recorded in renv.lock (tested with R 4.5.0):

   install.packages("renv")
   renv::restore()

3. Render a tutorial with Quarto (install Quarto if needed):

   quarto render beginner.qmd
   # or any advanced static file, e.g.
   quarto render advanced_03_light_therapy.qmd

   You can also open a *.qmd in RStudio and run the chunks interactively.
4. Inspect figures/tables generated by standalone scripts in scripts/ by sourcing them after renv::restore() to ensure the environment matches the tutorials.

Live (webR) versions

Files ending in -live.qmd are configured for webR. They are pre-rendered on the website and can be opened locally as references, but the interactive R runtime is available only through the hosted pages.

Data and citation

Course datasets and supporting files are stored in data/. For citation guidance, see _cite.qmd and the DOI badge above.