Skip to content

Commit

Permalink
docs: update data dictionary: hour, weekend/weekday stats
Browse files Browse the repository at this point in the history
  • Loading branch information
chanshing committed Jun 12, 2024
1 parent 5beeee4 commit 69e0425
Showing 1 changed file with 88 additions and 39 deletions.
127 changes: 88 additions & 39 deletions data-dictionary.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,90 @@
## Data Dictionary

- **Filename**: The name of the data file.
- **Filesize(MB)**: The size of the file in megabytes.
- **Device**: The brand or model of the device that recorded the data, or the file extension.
- **DeviceID**: A unique identifier for the specific device used.
- **ReadErrors**: Number of errors encountered while reading data from the device.
- **SampleRate**: The frequency at which data points are sampled per second, measured in Hz.
- **ReadOK**: A binary indicator (1 for success, 0 for failure) showing whether the data was read successfully.
- **NumTicks**: Total number of data points recorded.
- **StartTime**: Timestamp marking the beginning of the data recording.
- **EndTime**: Timestamp marking the end of the data recording.
- **WearTime(days)**: Total time the device was worn, expressed in days.
- **NumInterrupts**: Number of interruptions in the data recording.
- **CalibErrorBefore(mg)**: Calibration error before any correction was applied, measured in milli-g.
- **CalibOK**: A binary indicator (1 for successful calibration, 0 for unsuccessful) showing the calibration status.
- **CalibErrorAfter(mg)**: Calibration error after attempting correction, measured in milli-g.
- **NonwearTime(days)**: Total time the device was not worn, expressed in days.
- **NumNonwearEpisodes**: Number of separate episodes when the device was not worn.
- **ResampleRate**: The new sampling rate after data has been resampled.
- **NumTicksAfterResample**: Number of data points after resampling.
- **Covers24hOK**: Indicates whether data is available for each hour bin of the 24h across any day. For example, if data is absent from 14:00-15:00 on Day 1 (and all other hours are covered), and then it is available during 14:00-15:00 on Day 2, then `Covers24hOK=1`. If data is fully absent from 14:00-15:00 across all days, then `Covers24hOK=0`.
- **ENMO(mg)**: Euclidean norm minus one and zero-truncated, measured in milli-g.
- **TotalSteps**: Total number of steps recorded.
- **StepsDayAvg**: Average number of steps per day.
- **StepsDayMed**: Median number of steps per day.
- **StepsDayMin**: Minimum number of steps in any single day.
- **StepsDayMax**: Maximum number of steps in any single day.
- **TotalWalking(mins)**: Total minutes spent walking.
- **WalkingDayAvg(mins)**: Average walking duration per day in minutes.
- **WalkingDayMed(mins)**: Median walking duration per day in minutes.
- **WalkingDayMin(mins)**: Minimum walking duration in any single day in minutes.
- **WalkingDayMax(mins)**: Maximum walking duration in any single day in minutes.
- **CadencePeak1(steps/min)**: The highest cadence recorded in one minute of the day, averaged across all days.
- **CadencePeak30(steps/min)**: The mean of the 30 highest minutes of the day (not necessarily continuous), averaged across all days.
- **Cadence95th(steps/min)**: The 95th percentile of cadence of the day, averaged across all days.
- **Steps5thAt**: Average time of day when 5% of steps was accumulated.
- **Steps25thAt**: Average time of day when 25% of steps was accumulated.
- **Steps50thAt**: Average time of day when 50% of steps was accumulated.
- **Steps75thAt**: Average time of day when 75% of steps was accumulated.
- **Steps95thAt**: Average time of day when 95% of steps was accumulated.
1. General Information
- **Filename**: The name of the data file.
- **Filesize(MB)**: The size of the file in megabytes.
- **Device**: The brand or model of the device that recorded the data, or the file extension.
- **DeviceID**: A unique identifier for the specific device used.
- **ReadErrors**: Number of errors encountered while reading data from the device.
- **SampleRate**: The frequency at which data points are sampled per second, measured in Hz.
- **ReadOK**: A binary indicator (1 for success, 0 for failure) showing whether the data was read successfully.
- **NumTicks**: Total number of data points recorded.
- **StartTime**: Timestamp marking the beginning of the data recording.
- **EndTime**: Timestamp marking the end of the data recording.
- **WearTime(days)**: Total time the device was worn, expressed in days.
- **NumInterrupts**: Number of interruptions in the data recording.
- **CalibErrorBefore(mg)**: Calibration error before any correction was applied, measured in milli-g.
- **CalibOK**: A binary indicator (1 for successful calibration, 0 for unsuccessful) showing the calibration status.
- **CalibErrorAfter(mg)**: Calibration error after attempting correction, measured in milli-g.
- **NonwearTime(days)**: Total time the device was not worn, expressed in days.
- **NumNonwearEpisodes**: Number of separate episodes when the device was not worn.
- **ResampleRate**: The new sampling rate after data has been resampled.
- **NumTicksAfterResample**: Number of data points after resampling.
- **Covers24hOK**: Indicates whether data is available for each hour bin of the 24h across any day. For example, if data is absent from 14:00-15:00 on Day 1 (and all other hours are covered), and then it is available during 14:00-15:00 on Day 2, then `Covers24hOK=1`. If data is fully absent from 14:00-15:00 across all days, then `Covers24hOK=0`.
1. ENMO
- **ENMO(mg)**: Euclidean norm minus one and zero-truncated, measured in milli-g.
- **ENMO(mg)_Hour{XX}**: ENMO for each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `ENMO(mg)_Hour12` is the ENMO during 12:00 - 13:00, averaged across all days.
- **ENMO(mg)_Weekend**: Euclidean norm minus one and zero-truncated, measured in milli-g. Weekends only.
- **ENMO(mg)_Hour{XX}_Weekend**: ENMO for each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `ENMO(mg)_Hour12_Weekend` is the ENMO during 12:00 - 13:00, averaged across all days. Weekends only.
- **ENMO(mg)_Weekday**: Euclidean norm minus one and zero-truncated, measured in milli-g. Weekdays only.
- **ENMO(mg)_Hour{XX}_Weekday**: ENMO for each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `ENMO(mg)_Hour12_Weekend` is the ENMO during 12:00 - 13:00, averaged across all days. Weekdays only.
1. Steps
- **TotalSteps**: Total number of steps recorded.
- **StepsDayAvg**: Average number of steps per day.
- **StepsDayMed**: Median number of steps per day.
- **StepsDayMin**: Minimum number of steps in any single day.
- **StepsDayMax**: Maximum number of steps in any single day.
- **Steps_Hour{XX}**: Average number of steps taken during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Steps_Hour12` is the average number of steps taken during 12:00 - 13:00, averaged across all days.
<!-- weekends -->
- **TotalSteps_Weekend**: Total number of steps recorded. Weekends only.
- **StepsDayAvg_Weekend**: Average number of steps per day. Weekends only.
- **StepsDayMed_Weekend**: Median number of steps per day. Weekends only.
- **StepsDayMin_Weekend**: Minimum number of steps in any single day. Weekends only.
- **StepsDayMax_Weekend**: Maximum number of steps in any single day. Weekends only.
- **Steps_Hour{XX}_Weekend**: Average number of steps taken during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Steps_Hour12_Weekend` is the average number of steps taken during 12:00 - 13:00, averaged across all days. Weekends only.
<!-- weekdays -->
- **TotalSteps_Weekday**: Total number of steps recorded. Weekdays only.
- **StepsDayAvg_Weekday**: Average number of steps per day. Weekdays only.
- **StepsDayMed_Weekday**: Median number of steps per day. Weekdays only.
- **StepsDayMin_Weekday**: Minimum number of steps in any single day. Weekdays only.
- **StepsDayMax_Weekday**: Maximum number of steps in any single day. Weekdays only.
- **Steps_Hour{XX}_Weekday**: Average number of steps taken during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Steps_Hour12_Weekday` is the average number of steps taken during 12:00 - 13:00, averaged across all days. Weekdays only.
1. Walking
- **TotalWalking(mins)**: Total minutes spent walking.
- **WalkingDayAvg(mins)**: Average walking duration per day in minutes.
- **WalkingDayMed(mins)**: Median walking duration per day in minutes.
- **WalkingDayMin(mins)**: Minimum walking duration in any single day in minutes.
- **WalkingDayMax(mins)**: Maximum walking duration in any single day in minutes.
- **Walking(mins)_Hour{XX}**: Average time spent walking during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Walking(mins)_Hour12` is the average time spent walking during 12:00 - 13:00, averaged across all days.
<!-- weekends -->
- **TotalWalking(mins)_Weekend**: Total minutes spent walking. Weekends only.
- **WalkingDayAvg(mins)_Weekend**: Average walking duration per day in minutes. Weekends only.
- **WalkingDayMed(mins)_Weekend**: Median walking duration per day in minutes. Weekends only.
- **WalkingDayMin(mins)_Weekend**: Minimum walking duration in any single day in minutes. Weekends only.
- **WalkingDayMax(mins)_Weekend**: Maximum walking duration in any single day in minutes. Weekends only.
- **Walking(mins)_Hour{XX}_Weekend**: Average time spent walking during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Walking(mins)_Hour12_Weekend` is the average time spent walking during 12:00 - 13:00, averaged across all days. Weekends only.
<!-- weekdays -->
- **TotalWalking(mins)_Weekday**: Total minutes spent walking. Weekdays only.
- **WalkingDayAvg(mins)_Weekday**: Average walking duration per day in minutes. Weekdays only.
- **WalkingDayMed(mins)_Weekday**: Median walking duration per day in minutes. Weekdays only.
- **WalkingDayMin(mins)_Weekday**: Minimum walking duration in any single day in minutes. Weekdays only.
- **WalkingDayMax(mins)_Weekday**: Maximum walking duration in any single day in minutes. Weekdays only.
- **Walking(mins)_Hour{XX}_Weekday**: Average time spent walking during each hour bin, where `{XX}` is a placeholder for the hour in 24-hour format. For example, `Walking(mins)_Hour12_Weekday` is the average time spent walking during 12:00 - 13:00, averaged across all days. Weekdays only.
1. Cadence
- **CadencePeak1(steps/min)**: The highest cadence recorded in one minute of the day, averaged across all days.
- **CadencePeak30(steps/min)**: The mean of the 30 highest minutes of the day (not necessarily continuous), averaged across all days.
- **Cadence95th(steps/min)**: The 95th percentile of cadence of the day, averaged across all days.
<!-- weekends -->
- **CadencePeak1(steps/min)_Weekend**: The highest cadence recorded in one minute of the day, averaged across all days. Weekends only.
- **CadencePeak30(steps/min)_Weekend**: The mean of the 30 highest minutes of the day (not necessarily continuous), averaged across all days. Weekends only.
- **Cadence95th(steps/min)_Weekend**: The 95th percentile of cadence of the day, averaged across all days. Weekends only.
<!-- weekdays -->
- **CadencePeak1(steps/min)_Weekday**: The highest cadence recorded in one minute of the day, averaged across all days. Weekdays only.
- **CadencePeak30(steps/min)_Weekday**: The mean of the 30 highest minutes of the day (not necessarily continuous), averaged across all days. Weekdays only.
- **Cadence95th(steps/min)_Weekday**: The 95th percentile of cadence of the day, averaged across all days. Weekdays only.
1. Steps Distribution
- **Steps5thAt**: Average time of day when 5% of steps was accumulated.
- **Steps25thAt**: Average time of day when 25% of steps was accumulated.
- **Steps50thAt**: Average time of day when 50% of steps was accumulated.
- **Steps75thAt**: Average time of day when 75% of steps was accumulated.
- **Steps95thAt**: Average time of day when 95% of steps was accumulated.

0 comments on commit 69e0425

Please sign in to comment.