rapids/docs/features/fitbit-steps-summary.md

Fitbit Steps Summary

Sensor parameters description for [FITBIT_STEPS_SUMMARY]:

Key	Description
[TABLE]	Database table name or file path where the steps summary data is stored. Source data type and column format are defined in Device Data Source Configuration.

Column format could be JSON or PLAIN_TEXT. Data with JSON column format is obtained from Fitbit API directly. Summary data and intraday data come together in JSON format. Each row doesn't have to contain the data for a single day as it depends on the way Fitbit API is queried. Examples of the source data with two formats are as follows. Data with JSON format is chunked.

??? example "Example of the structure of source data"

=== "JSON"

    |device_id                                |fitbit_data                                               |
    |---------------------------------------- |--------------------------------------------------------- |
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524     |"activities-steps":[{"dateTime":"2020-10-07","value":"1775"}],"activities-steps-intraday":{"dataset":[{"time":"00:00:00","value":5},{"time":"00:01:00","value":3},{"time":"00:02:00","value":0},...],"datasetInterval":1,"datasetType":"minute"}}
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524     |"activities-steps":[{"dateTime":"2020-10-08","value":"3201"}],"activities-steps-intraday":{"dataset":[{"time":"00:00:00","value":14},{"time":"00:01:00","value":11},{"time":"00:02:00","value":10},...],"datasetInterval":1,"datasetType":"minute"}}
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524     |"activities-steps":[{"dateTime":"2020-10-09","value":"998"}],"activities-steps-intraday":{"dataset":[{"time":"00:00:00","value":0},{"time":"00:01:00","value":0},{"time":"00:02:00","value":0},...],"datasetInterval":1,"datasetType":"minute"}}

=== "PLAIN_TEXT"

    |device_id                              |local_date_time        |steps     |
    |-------------------------------------- |---------------------- |--------- |
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524   |2020-10-07             |1775      |
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524   |2020-10-08             |3201      |
    |a748ee1a-1d0b-4ae9-9074-279a2b6ba524   |2020-10-09             |998       |

RAPIDS provider

!!! info "Available day segments" - Only available for segments that span 1 or more complete days (e.g. Jan 1st 00:00 to Jan 3rd 23:59)

!!! info "File Sequence" bash - data/raw/{pid}/fitbit_steps_summary_raw.csv - data/raw/{pid}/fitbit_steps_summary_parsed.csv - data/raw/{pid}/fitbit_steps_summary_parsed_with_datetime.csv - data/interim/{pid}/fitbit_steps_summary_features/fitbit_steps_summary_{language}_{provider_key}.csv - data/processed/features/{pid}/fitbit_steps_summary.csv

Parameters description for [FITBIT_STEPS_SUMMARY][PROVIDERS][RAPIDS]:

Key	Description
[COMPUTE]	Set to True to extract FITBIT_STEPS_SUMMARY features from the RAPIDS provider
[FEATURES]	Features to be computed from steps summary data, see table below

Features description for [FITBIT_STEPS_SUMMARY][PROVIDERS][RAPIDS]:

Feature	Units	Description
maxsumsteps	steps	The maximum daily step count during a day segment.
minsumsteps	steps	The minimum daily step count during a day segment.
avgsumsteps	steps	The average daily step count during a day segment.
mediansumsteps	steps	The median of daily step count during a day segment.
stdsumsteps	steps	The standard deviation of daily step count during a day segment.

!!! note "Assumptions/Observations"

NA