... | ... | @@ -19,11 +19,11 @@ Before installation, you need: |
|
|
|
|
|
You can install our software with one of three methods below:
|
|
|
|
|
|
(1) Install apk in [build folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/build)
|
|
|
(1) Install apk in [build folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Data%20collection%20software/build)
|
|
|
|
|
|
(2) Compile packed android project in [android folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/android)
|
|
|
(2) Compile packed android project in [android folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Data%20collection%20software/android)
|
|
|
|
|
|
(3) Install Create your own projects using [processing](https://www.processing.org/download/) with all pde files in [processing project folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Processing%20Project%20folder), recommended when you have a number of participants different from 12
|
|
|
(3) Install Create your own projects using [processing](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Data%20collection%20software/Processing%20Project%20folder) with all pde files in [processing project folder](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/tree/master/Processing%20Project%20folder), recommended when you have a number of participants different from 12
|
|
|
|
|
|
## Software utilization
|
|
|
|
... | ... | @@ -35,7 +35,7 @@ Open the software, we can see the interface below: |
|
|
|
|
|
We choose the No. Participant and with which phase to begin the experiment, and then click button of "STARTXP" to start the experiment. If your experiment are not suspended accidentally or intentionally, you can choose phase 0 as beginning phase and the software will present tasks phase by phase till the end automatically.
|
|
|
|
|
|
After click the button of "STARTXP", one file named [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/ExperimentsPara.xml) will be automatically created and stored in your device's External Storage folder (usually in \root\sdcard). This file records parameters of tasks.
|
|
|
After click the button of "STARTXP", one file named [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collection%20software/ExperimentsPara.xml) will be automatically created and stored in your device's External Storage folder (usually in \root\sdcard). This file records parameters of tasks.
|
|
|
|
|
|
Here below is the head of the file ExperimentsPara.xml :
|
|
|
|
... | ... | @@ -62,7 +62,7 @@ Each element of `Experimentation` has one element of `Training` and one element |
|
|
|
|
|
For example, as the head of the file ExperimentsPara.xml shown above, it records parameters of first task of training phase for the first participant(`id`=0). The `BeginingHand` of s/he is the right hand, and the `Order` is "TCL". It means that s/he begins the experiment with the right hand for target acquisition tasks, then s/he alternates to left hand for target acquisition tasks. After completing target acquisition tasks with both hands, s/he completes circular steering tasks with right hand and then with left hand. Finally, s/he takes linear steering tasks with the same order of hand. And before trial phase of each task for each hand, s/he passed training phase first.
|
|
|
|
|
|
More details, please see [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/ExperimentsPara.xml).
|
|
|
More details, please see [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collection%20software/ExperimentsPara.xml).
|
|
|
|
|
|
### When you have 12 participants and your participants will take experiments in the same order as us.
|
|
|
|
... | ... | @@ -82,21 +82,21 @@ In this case, you need to define your own participants number and experiment ord |
|
|
|
|
|
#### Modify number of participants
|
|
|
|
|
|
In file of [PreProcedure.pde](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Processing%20Prj%20folder/PreProcedure.pde), you can find the definition of the total number of participants `final int Num_Participants=12;`. You can modify this variable to re-define the number.
|
|
|
In file of [PreProcedure.pde](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collection%20software/Processing%20Project%20folder/PreProcedure.pde), you can find the definition of the total number of participants `final int Num_Participants=12;`. You can modify this variable to re-define the number.
|
|
|
|
|
|
#### Modify experiment order
|
|
|
|
|
|
To realize this, two methods existed:
|
|
|
- Modify directly the [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/ExperimentsPara.xml) stored in your device.
|
|
|
- Modify directly the [ExperimentsPara.xml](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collection%20software/ExperimentsPara.xml) stored in your device.
|
|
|
|
|
|
- In the function of `FuncStateUpdateExperimentsPara_xml` in [PreProcedure.pde](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Processing%20Prj%20folder/PreProcedure.pde), we define the rule how to create "ExperimentsPara.xml". Modify code in this function, you can obtain the "ExperimentsPara.xml" wanted.
|
|
|
- In the function of `FuncStateUpdateExperimentsPara_xml` in [PreProcedure.pde](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Data%20collection%20software/Processing%20Project%20folder/PreProcedure.pde), we define the rule how to create "ExperimentsPara.xml". Modify code in this function, you can obtain the "ExperimentsPara.xml" wanted.
|
|
|
|
|
|
|
|
|
## Result collected
|
|
|
|
|
|
During the experiment, the experiment result is synchronized into a file of "RecordX.xml" (X means the NO. record), for example[Record1.csv](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/Record1.csv). Each time you open the software, a new record will be saved in your device's External Storage folder (usually in \root\sdcard).
|
|
|
During the experiment, the experiment result is synchronized into a file of "RecordX.xml" (X means the NO. record). Each time you open the software, a new record will be saved in your device's External Storage folder (usually in \root\sdcard).
|
|
|
|
|
|
We glanced over the head of a "RecordX.xml" file here:
|
|
|
We glanced over the head of one record [file](https://gricad-gitlab.univ-grenoble-alpes.fr/fanzh/bihandmorph/-/blob/master/SupplementalMaterialISSArticle188/code%20and%20data/data/log/p0_2020.csv) here:
|
|
|
|
|
|
| id | Participant | State | TaskType | HandUsed | Direction | SubDirection | Amplitude/Length | Width | StartTime | StartPosition | EndTime | Duration | ErrorType | EndPosition | x | y | ax | ay | az | wx | wy | wz | Remark |
|
|
|
|-----------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|---------------|:-------------|:---------------:|
|
... | ... | |