Skip to content

ActiGlobe: Wearable Recording Processor for Time Shift Adjustment and Data Analysis #732

@cwy20030

Description

@cwy20030

Submitting Author Name: C. William Yao
Submitting Author Github Handle: @cwy20030
Other Package Authors Github handles: (comma separated, delete if none) @GVARESCO, @FBSportScience, @gsimonelliCA
Repository: https://github.com/cwy20030/ActiGlobe
Version submitted: 0.2.1
Submission type: Standard
Editor: @robitalec
Reviewers: @vincentvanhees, @cmaimone

Archive: TBD
Version accepted: TBD
Language: en


  • Paste the full DESCRIPTION file inside a code block below:
Package: ActiGlobe
Type: Package
Title: Wearable Recording Processor for Time Shift Adjustment and Data Analysis
Version: 0.2.1
Authors@R: c(person("C. William", "Yao", email = "chun.william.yao.cnmtl@ssss.gouv.qc.ca", role = c("aut","cre","cph"), comment = c(ORCID="0000-0002-7234-7375")),
             person("Giorgio", "Varesco", email = "giorgio.varesco@umontreal.ca", role = c("aut","ctb"), comment = c(ORCID="0000-0001-9385-6972")),
			 person("François", "Bieuzen", email = "fbieuzen@insquebec.org", role = c("aut","ctb"), comment = c(ORCID="0000-0002-9690-9168")),
             person("Guido", "Simonelli", email = "guido.simonelli@umontreal.ca", role = c("aut","ctb","fnd"), comment = c(ORCID="0000-0002-5400-319X")))
Maintainer: C. William Yao <chun.william.yao.cnmtl@ssss.gouv.qc.ca>
Description: Cross-continental travel and local practices of daylight saving time can induce a time shift. When left unadjusted, it can lead to biases in interpreting wearable measures. This research tool streamlines data processing and analysis (e.g., cosinor analysis, circularized kernel density estimation) for longitudinal recordings. Together with additional features such as exporting daily wearable measures and creating visual reports, it aims to facilitate research on longitudinal wearable measurements. To learn its application, please refer to the provided vignettes for a brief tutorial. This tool is developed based on the methodology detailed in: Varesco, G., Yao, C. W., Dubé, E., Simonelli, G., Bieuzen, F., (2024) <doi:10.1113/ep092195>.
License: AGPL (>= 3)
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.3.3
Depends: 
    R (>= 4.2.0)
Date: 2025-10-14
Imports: 
    ggplot2,
    ggrepel,
    grDevices,
    gridExtra,
    hms,
    lubridate,
    readr,
    sandwich,
    utils,
    viridis,
    parallel,
    scales
Suggests:
    spelling, 
    ggthemes,
    knitr,
    rmarkdown,
    testthat (>= 3.0.0),
    zeallot
URL: https://github.com/cwy20030/ActiGlobe
BugReports: https://github.com/cwy20030/ActiGlobe/issues
ByteCompile: true
Config/testthat/edition: 3
NeedsCompilation: no
VignetteBuilder: knitr
Language: en-US

Scope

  • Please indicate which category or categories from our package fit policies this package falls under: (Please check an appropriate box below. If you are unsure, we suggest you make a pre-submission inquiry.):

    • data retrieval
    • data extraction
    • data munging
    • data deposition
    • data validation and testing
    • workflow automation
    • version control
    • citation management and bibliometrics
    • scientific software wrappers
    • field and lab reproducibility tools
    • database software bindings
    • geospatial data
    • translation
  • Explain how and why the package falls under these categories (briefly, 1-2 sentences):

ActiGlobe automates the data harmonization workflow for adjusting time shift during pre-processing (via BriefSum and TAdjust). It also supports parameter extraction for further rest-activity-based circadian analysis (e.g., CosinorM) and reproducible documentation (e.g., write.act) after segmenting the continuous recording by day (i.e., Act2Daily).

  • Who is the target audience and what are scientific applications of this package?

ActiGlobe aims to facilitate researchers studying rest-activity-based circadian rhythms and human behavioral pattern based on longitudinal wearable measurements.

ActiGlobe is a strong candidate for rOpenSci review because it delivers an end‑to‑end, reproducible actigraphy workflow that combines robust preprocessing (including explicit DST and travel handling), multiple analytical strategies (parametric and KDE cosinor, bootstrapped uncertainty), and consolidated, FAIR‑aware reporting (per‑subject PDFs plus CSV outputs). Compared with other R packages in the domain, ActiGlobe’s distinguishing value is the combination of (a) explicit, auditable time‑change correction, (b) circadian modeling tuned for irregular/real‑world recordings, and (c) built‑in consolidated reporting and metadata export that support FAIR principles and reproducible pipelines.

Package (Language) Pre processing Adjust time change Circadian analyses Consolidated report FAIR support Notes
ActiGlobe (R) Full Produces per subject PDFs and CSV/HTML outputs; anonymization and reproducibility align with FAIR principles.
acc (R) Partial CRAN package for accelerometer data: preprocessing, visualization, and analysis pipelines.
accelerometry (R) Partial Non wear/bout detection outputs; structured but metadata incomplete.
ActFrag (R) ✓ (fragmentation) Partial Fragmentation metrics; structured tables but limited metadata.
Actigraphy (R) Partial FDA/circadian modeling; structured outputs but metadata schema unclear.
actigraph.sleepr (R) Partial Tidy sleep scoring tables; lacks consolidated reporting.
actverse (R) ✗/✓ (tz parse) Partial Tidyverse pipelines; partial tz handling; no consolidated reports.
agcounts (R) ✗/✓ (counts) Partial ActiGraph style counts; standardized but metadata minimal.
CircaCP (R) Partial Cosinor/change point outputs; tabular FAIR structure, but limited metadata.
GGIR (R) ✗/✓ (drift/logs) Full g.report produces HTML/CSV with metadata; closest to full FAIR compliance.
nparACT (R) Partial Dedicated nonparametric circadian metrics; standardized tables. No embedded reporting.

Yes.
ActiGlobe includes built‑in anonymization options, minimal‑export defaults, and provenance logging to support ethical handling of human subjects data. The package documentation and vignettes demonstrate how to produce de‑identified, FAIR‑ready outputs and remind users to obtain appropriate consent and institutional approvals before sharing data.

  • If you made a pre-submission inquiry, please paste the link to the corresponding issue, forum post, or other discussion, or @tag the editor you contacted.

  • Explain reasons for any pkgcheck items which your package is unable to pass.

Technical checks

Confirm each of the following by checking the box.

This package:

Publication options

  • Do you intend for this package to go on CRAN?

  • Do you intend for this package to go on Bioconductor?

  • Do you wish to submit an Applications Article about your package to Methods in Ecology and Evolution? If so:

MEE Options
  • The package is novel and will be of interest to the broad readership of the journal.
  • The manuscript describing the package is no longer than 3000 words.
  • You intend to archive the code for the package in a long-term repository which meets the requirements of the journal (see MEE's Policy on Publishing Code)
  • (Scope: Do consider MEE's Aims and Scope for your manuscript. We make no guarantee that your manuscript will be within MEE scope.)
  • (Although not required, we strongly recommend having a full manuscript prepared when you submit here.)
  • (Please do not submit your package separately to Methods in Ecology and Evolution)

Code of conduct

rOpenSci | Software Peer Review

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions