actisensorlog

actisensorlog processes SensorLog and SensorLogger exports. The package focuses on timestamp normalization, distance calculations, duplicate-time checks, and daily summaries.

Core entry points:

• acti_process_sensorlog() for duplicate checking, home-distance calculations, and timezone handling
• acti_sensorlog_process_time() for parsing SensorLog timestamps
• acti_minute_sensorlog() and acti_summarize_sensorlog() for minute and daily summaries

Installation

You can install actisensorlog from GitHub with:

# install.packages("remotes")
remotes::install_github("jhuwit/actisensorlog")

Quick Start

library(actisensorlog)

sensorlog <- suppressMessages(
  actiread::acti_read_sensorlog(actiread::acti_example_sensorlog_file())
)

processed_sensorlog <- acti_process_sensorlog(
  sensorlog,
  lat = 39.3,
  lon = -76.6,
  expected_timezone = "America/New_York",
  check_data = FALSE
)

minute_sensorlog <- acti_minute_sensorlog(processed_sensorlog)
summary_sensorlog <- acti_summarize_sensorlog(processed_sensorlog)

The SensorLog example gains distance, distance_traveled, and is_within_home fields:

head(processed_sensorlog)

The minute-level view fills missing minutes between observations:

head(minute_sensorlog)

The daily summary collapses the data to a single row per date:

summary_sensorlog

sensorlogger <- suppressMessages(
  actiread::acti_read_sensorlogger_location(
    actiread::acti_example_sensorlogger_location_file()
  )
)

processed_sensorlogger <- acti_process_sensorlog(
  sensorlogger,
  lat = 39.3,
  lon = -76.6,
  expected_timezone = "America/New_York"
)

minute_sensorlogger <- acti_minute_sensorlog(processed_sensorlogger)
summary_sensorlogger <- acti_summarize_sensorlog(processed_sensorlogger)

The packaged SensorLogger location example follows the same flow:

head(processed_sensorlogger)

head(minute_sensorlogger)

summary_sensorlogger