# QuantActions
## Metrics from TIE (Tap Intelligence Engine)

### Structure
These metrics have been downloaded from taps.ai. The metrics can be in 
- [parquet](https://parquet.apache.org/) format: this is a highly flexible and compact table format 
- `csv` format. 

The metrics are organized in folders, i.e. each metrics has its own folder.
In each folder you will find a set of files, each file corresponds to one participant in the study. TIE has already taken care of merging the data of multiple devices in case a participant has more than one.

### Format
The table format for each metrics is the same. The table is indexed with daily UTC timestamps.
Each row contains the values for one day (24 hours starting 00:00 UTC).
More info on metrics can be found in our SDK documentation (linked in the following list), this contains also information about scientific literature surrounding the metrics. Columns in the tables contain various values depending on the metric: 

- [Behavioural Age](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-b-e-h-a-v-i-o-u-r-a-l_-a-g-e/index.html)
    - `behavioural-age`: years
- [Engagement Score](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-s-o-c-i-a-l_-e-n-g-a-g-e-m-e-n-t/index.html)
    - `engagement-score`: [0-100]
- [Proxy CRT (Choice Reaction Time)](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-a-c-t-i-o-n_-s-p-e-e-d/index.html)
    - `proxy-crt`: in milliseconds
    - `ci-l` : confidence interval low (25th percentile)
    - `ci-m` : confidence interval median (50th percentile)
    - `ci-h` : confidence interval high (75th percentile)
- [Screen Time Aggregate](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-s-c-r-e-e-n_-t-i-m-e_-a-g-g-r-e-g-a-t-e/index.html)
    - `screen-time`: total screen time in milliseconds
    - `social-screen-time`: screen time on social apps in milliseconds
- [Sleep Duration](https://www.nature.com/articles/s41746-019-0147-4)
    - `sleep-len`: sleep duration in hours
    - `conf`: overall confidence of the prediction [0-1]	
    - `ci-l`: confidence interval low (25th percentile)	in hours
    - `ci-h`: confidence interval high (75th percentile) in hours
- [Sleep Score](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-s-l-e-e-p_-s-c-o-r-e/index.html)
    - `sleep-score`: [0-100]	
    - `ci-l`: confidence interval low (25th percentile)
    - `ci-h`: confidence interval high (75th percentile)
    - `wake-utc`: UTC time of the putative sleep end (wake-up time)
    - `time-zone`: relative to the wake up time	
    - `conf`: overall confidence of the prediction [0-1]
- [Sleep Summary](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk.data.model/-sleep-summary/index.html)
    - `sleep-utc`: UTC time of the putative sleep start (going-to-bed time)
    - `wake-utc`: UTC time of the putative sleep end (wake-up time)
    - `int-start`: UTC time of start of sleep interruptions
    - `int-stop`: UTC time of stop of sleep interruptions
    - `int-ntaps`: number of taps in each sleep interruption	
    - `time-zone`: relative to the wake up time
    - `conf`: overall confidence of the prediction [0-1]
- [Speed Score (Cognitive Fitness)](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-c-o-g-n-i-t-i-v-e_-f-i-t-n-e-s-s/index.html)
    - `speed-score`: [0-100]	
    - `ci-l` : confidence interval low (25th percentile)
    - `ci-m` : confidence interval median (50th percentile)
    - `ci-h` : confidence interval high (75th percentile)
- [Typing Speed](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-metric/-t-y-p-i-n-g_-s-p-e-e-d/index.html)
    - `typing-speed`: taps/min 	
    - `ci-l` : confidence interval low (25th percentile)
    - `ci-h` : confidence interval high (75th percentile)
- [Wave Trend (Mental fitness dynamics)](https://quantactions.github.io/quantactions-android-sdk/-s-d-k/com.quantactions.sdk/-trend/-t-h-e_-w-a-v-e/index.html)
    - `stat2W`: effect size over 2 weeks	
    - `stat6W`: effect size over 6 weeks
    - `sign2W`: significance of effect over 2 weeks (+1 positive, -1 negative, 0 non significant)	
    - `sign6W`: significance of effect over 6 weeks (+1 positive, -1 negative, 0 non significant)	

### Contact
In case of questions contact us at [support@quantactions.com](mailto:support@quantactions.com)