Introduction
This repository include Python scripts that transform raw sensor data collected from Android mobile devices into features of interest for analysis.
Current research topic: identify contextual prompt-level factors that predict response or no response in microEMA.
Statistical methodology: multi-level modeling
Outcomes: compliance rate
Predictors:
-
Within-person or prompt level:
- time of the day
- day of the week
- day in study
- activity level
- battery level
- location
-
Between-person or person level
- age
- gender
- study mode
Exploratory Discussions on Factors
Detailed discussions on factors can be found here.
Features Overview
Smartphone
| Outcome | Variable Type | Data Source |
|---|---|---|
| Answer Status | Categorical (Completed, CompletedThenDismissed, PartiallyCompleted, Started/NeverStarted, NeverPrompted, OverwrittenByDaily) | ./logs/PromptResponses.log.csv |
| Feature | Level | Effect Type | Variable Type | Data Source |
|---|---|---|---|---|
| Day of the Week | Level 1 (Within-person or prompt level) | Random | Categorical (Mon-Sat: 0-6) | ./logs/.../PromptResponses.log.csv |
| Time of the Day | Level 1 (Within-person or prompt level) | Random | Categorical (morning, afternoon, evening/night) | ./logs/.../PromptResponses.log.csv |
| Days in Study | Level 1 (Within-person or prompt level) | Random | Numeric (numeric value of day from the first day) | ./logs (start from the first date of created folder) |
| Battery Level | Level 1 (Within-person or prompt level) | Random | Numeric (Battery%) | ./data/.../Battery.##.event.csv |
| Charging Status | Level 1 (Within-person or prompt level) | Random | Binary (True/False) | ./data/.../Battery.##.event.csv |
| Location (LOC) | Level 1 (Within-person or prompt level) | Random | [Latitude, Longitude] | ./data/.../GPS.csv |
| Phone Lock | Level 1 (Within-person or prompt level) | Random | Binary (Phone Locked/Phone Unlocked) | ./data/.../AppEventCounts.csv |
| Last Phone Usage Duration | Level 1 (Within-person or prompt level) | Random | Numeric (minutes) | ./data/.../AppEventCounts.csv |
| Screen Status | Level 1 (Within-person or prompt level) | Random | Binary (Screen On/Screen Off) | ./logs/.../SystemBroadcastReceiver.csv |
| Wake/Sleep Time | Level 1 (Within-person or prompt level) | Random | Local time (2021-01-01 06:30:00 CST) | daily report |
Smartwatch
| Outcome | Level | Effect Type | Variable Type | Data Source |
|---|---|---|---|---|
| Compliance Rate | Level 1 (Within-person or prompt level) | Random | Numeric | ./logs-watch/PromptResponses.log.csv |
| Level 2 (Between-person or person level) | Random |
| Feature | Level | Effect Type | Variable Type | Data Source |
|---|---|---|---|---|
| Day of the Week | Level 1 (Within-person or prompt level) | Random | Categorical (Mon-Sat: 0-6) | ./logs-watch/.../PromptResponses.log.csv |
| Time of the Day | Level 1 (Within-person or prompt level) | Random | Categorical (morning, afternoon, evening/night) | ./logs-watch/.../PromptResponses.log.csv |
| Days in Study | Level 1 (Within-person or prompt level) | Random | Numeric (numeric value of day from the first day) | ./logs-watch (start from the first date of created folder) |
| Battery Level | Level 1 (Within-person or prompt level) | Random | Numeric (Battery%) | ./data-watch/.../Battery.##.event.csv |
| Location (LOC) | Level 1 (Within-person or prompt level) | Random | ||
| Activity Level (ACT) | Level 1 (Within-person or prompt level) | Random |
Code Usage for Feature Matrix Generation
- This project has been wrapped up as a Pypi package. Use pip to install.
- Clone this project and run locally.
#!python
python main_ema.py [intermediate_participant_path] [output_dir_path] [date_in_study] [decryption_password]
e.g., python main_ema.py G:...\intermediate_file\participant_id C:...\output_folder 2021-01-01 password
Special Notice
- Delete misc folder before running code, if new participants' intermediate folder has been created.
1 maintainer
Release files for microt-prompt 0.1.22
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| microt_prompt-0.1.22.tar.gz | 36.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| microt_prompt-0.1.22-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 105.8 kB
Release files / microt_prompt-0.1.22.tar.gz
| Download URL | microt_prompt-0.1.22.tar.gz |
|---|---|
| Size | 36.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
066b26b308cc428862ae74dbc4195698298bfa32a08df5dd813b97f9671b16b4
|
|
BLAKE2b-256 checksum How to use checksums |
c8b29c5bfeafa9da866cebcb50aea1e44e3b2c6966c6f3ab495556b5bc467fd3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.5 CPython/3.10.0
|
Release files / microt_prompt-0.1.22-py3-none-any.whl
| Download URL | microt_prompt-0.1.22-py3-none-any.whl |
|---|---|
| Size | 69.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6142481d72bd6cbc5a5863dceaee4cfe554000c97c270672a658a65073d06dda
|
|
BLAKE2b-256 checksum How to use checksums |
edf30b7e0a0fdfd22a2522d77fab1e7ce76556d820b12cf4ae560fcb408f0213
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.5 CPython/3.10.0
|
