Data Storage

JTrack stores smartphone, wearable, and EMA data using a structured, BIDS-inspired organization. Data is grouped by study, participant, and data source, facilitating longitudinal analyses and reproducible research.

BIDS Structure

Data Sources

The platform collects three primary categories of data:

  • Smartphone sensor data

  • EMA questionnaire responses

  • Wearable device data (e.g., Garmin)

Each data source is stored independently and linked through the participant identifier.

Smartphone Sensor Data

Smartphone sensors generate timestamped JSON records. Each sensor type produces its own data structure depending on the information collected.

Example: Activity Recognition

{
     "activityType": "WALKING",
     "confidence": 100.0,
     "deviceid": "fa95d3-9d74-4c4f-8def-8bee65276",
     "sensorname": "activity",
     "studyId": "Demo_Study",
     "timestamp": 1690969600686,
     "username": "Demo_Study_00001_1"
 }

Example: Application Usage

{
     "appName": "Quickstep",
     "beginTimeStamp": 1690969205734,
     "endTimeStamp": 1690969486927,
     "lastTimeUsed": 1690969262708,
     "totalTimeinForeground": 32446,
     "deviceid": "fa62d3-9d74-4c4f-8def-8be6e65276",
     "sensorname": "application_usage",
     "studyId": "Demo_Study",
     "timestamp": 1690969606410,
     "username": "Demo_Study_00001_1"
 }

Example: Location

{
     "accuracy": 20.0,
     "alt": 32536.115439935587,
     "lat": 50.5519819674761,
     "lon": 6.319306026624161,
     "provider": "fused",
     "deviceid": "fa562d3-9d74-4c4f-8def-8b3b665276",
     "sensorname": "location",
     "studyId": "Demo_Study",
     "timestamp": 1690969600504,
     "username": "Demo_Study_00001_1"
 }

EMA Data

EMA responses are stored as timestamped question-answer records.

Example:

{
     "username": "Demo_Study_00001_1",
     "studyId": "Demo_Study",
     "subjectId": "",
     "deviceid": "f562d3-9d74-4c4f-8def-8b365276",
     "questionId": 1,
     "answerId": 1,
     "timestamp": "1778938864409",
     "answerText": null,
     "answer": null,
     "freeText": "Sehr beeinträchtigt",
     "sensorname": "ema",
     "startTime": "1778938782793",
     "endTime": "1778938781362",
     "surveyVersion": 12,
     "databaseId": 44232
 }

Garmin Wearable Data

Garmin devices can provide physiological and activity-related measurements, depending on the device model and enabled sensors.

Example: Heart Rate

{
     "deviceName": "vívoactive 6",
     "deviceid": "aaac108-2886-4d1c-85ed-8f154ecf22",
     "frequency": "15m",
     "id": 9,
     "studyId": "Demo_Study",
     "timestamp": 1779139800000,
     "timestamp_end": 1779140699999,
     "timestamp_start": 1779139800000,
     "username": "Demo_Study_00001_1",
     "value": 81.0,
     "sensorname": "garmin",
     "wearable_sensor": "HEART_RATE"
 }

Example: Respiration

{
     "deviceName": "vívoactive 6",
     "deviceid": "aac108-2886-4d1c-85ed-870f4ecf22",
     "frequency": "15m",
     "id": 12,
     "studyId": "Demo_Study",
     "timestamp": 1779139940000,
     "timestamp_end": 1779140839999,
     "timestamp_start": 1779139940000,
     "username": "Demo_Study_00001_1",
     "value": 13.0,
     "sensorname": "garmin",
     "wearable_sensor": "RESPIRATION"
 }

Example: Steps

{
     "deviceName": "Forerunner 255",
     "deviceid": "520dd6-2889-4385-bf-9f15f1214001",
     "frequency": "15m",
     "id": 38,
     "studyId": "Demo_Study",
     "timestamp": 1779213600000,
     "timestamp_end": 1779214499999,
     "timestamp_start": 1779213600000,
     "username": "Demo_Study_00001_1",
     "value": 24.0,
     "sensorname": "garmin",
     "wearable_sensor": "STEPS"
 }

Data Export

JDash provides functionality to export both raw and processed study data.

Raw Data Export

Raw exports contain the original JSON records collected from smartphones, wearable devices, and EMA questionnaires. These exports preserve the original data structure and timestamps as recorded by the JTrack applications.

Examples include:

  • Smartphone sensor records

  • EMA questionnaire responses

  • Garmin wearable measurements

Processed Data Export

Processed exports transform raw records into tabular CSV files suitable for quality control, reporting, and downstream analysis.

Currently available exports include:

  • Data-per-day summaries per subject

Additional processed export formats will be added in future releases.

Note

Processed CSV files are generated from the underlying raw JSON records and may include derived metrics, aggregations, or quality-control indicators depending on the selected export type.