README
======
This page contains the supplementary material for the following article:
Zhuzhi Fan and Céline Coutrix. 2020. [Impact of Hand Used on One-Handed Back-of-Device Performance](http://iihm.imag.fr/coutrix/publications-files/ISS20-Impact-Fan.pdf). In Proceedings of the 2020 ACM International Conference on Interactive Surfaces and Spaces (ISS '20). Association for Computing Machinery, New York, NY, USA, paper #188. DOI:https://doi.org/10.1145/3427316
Our preregistered analysis is available at https://osf.io/6u3kg
Authors and licenses
--------------------
- [Consent form](https://drive.google.com/file/d/1M-gdIkSUBgarWIsY-KIVD7A5pwTa9lOQ/view?usp=sharing) by Zhuzhi Fan and Céline Coutrix, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
- [Data collection (experimental) software](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Data%20collection%20software) by Zhuzhi Fan, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
- [Data collected](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collected%20and%20Analyse%20code/data.zip) by Zhuzhi Fan, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
- [R analysis code](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collected%20and%20Analyse%20code/Analyse%20Code.zip) by Zhuzhi Fan and Céline Coutrix, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
OSF Storage Content
-----------------------
| Directory | Content |
|-----------|:--------:|
| `Software/` | |
| `Data collection software/` | Software installed in device to collect participants' performance data (e.g. error rate and movement time) during the experiment |
| `Data collected and Analyse code/` | Data collected during our experiment and code used to analyse data|
| `Scientific paper/` | The first version of our paper |
| `Experiment data/` | |
| ` logs/` | main data of experiment |
| ` questionnaires/` | questionnaire data |
| ` TA_withEndPointInTwoColumn/` | data of target acquisition with both start and end points separated as two columns. |
How to collect data
-----------------------
1. Download [data collection software](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Data%20collection%20software) and install it in your android device.
2. Mirror your android device to your computer screen with a screen mirroring application, [Scrcpy](https://github.com/Genymobile/scrcpy) is recommended.
3. Run the data collection software and begin the experiment following the [procedure explained in the paper](http://iihm.imag.fr/coutrix/publications-files/ISS20-Impact-Fan.pdf).
4. Transfer the collected experimental data to your computer for data analysis: the collected experimental data is stored in your device's External Storage folder (usually in \root\sdcard ), as RecordXX.csv (XX is the experiment number).
More details about our data collection software can be found on its [wiki page](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/wikis/home) on our gitlab repository.
How to run our analysis
-----------------------
1. Either download our [data](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collected%20and%20Analyse%20code/data.zip) or use your own collected data (see above).
2. Download the [R analysis code](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collected%20and%20Analyse%20code/Analyse%20Code.zip) in the same directory.
2. Make sure you have [R Studio](https://www.rstudio.com/) installed.
3. Create a new project in the directory where you downloaded the R analysis code.
4. Open the file [ImpactofHandUsedonOneHandedBackofDevicePerformance.Rmd](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collected%20and%20Analyse%20code/code%20and%20data/ImpactofHandUsedonOneHandedBackofDevicePerformance.Rmd) in the editor.
5. Run the code
More details about our data analyzing code can be found on its [wiki page](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/wikis/Data-collected-and-Data-Analyze) on our gitlab repository.
