| ... | @@ -11,10 +11,14 @@ |
... | @@ -11,10 +11,14 @@ |
|
|
* In `StudyFramework/DebuggingLogs/SFLog.txt` all logs generated by the study framework in the last run of Unreal are gathered (mainly for debugging).
|
|
* In `StudyFramework/DebuggingLogs/SFLog.txt` all logs generated by the study framework in the last run of Unreal are gathered (mainly for debugging).
|
|
|
|
|
|
|
|
### Back-Ups & Redundancy:
|
|
### Back-Ups & Redundancy:
|
|
|
* Whenever any data contained in the Phase Tables (csv-files, "Phase_...") is overwritten or deleted (e.g. when a condition for one participant or the entire study is restarted), the files are not actually deleted, they are moved to the `StudyFramework/RecyclingBin` folder. To recover the files, stop running the study, then choose the appropriate version in the recycling bin, copy/paste the folders from the recycling bin back into the `StudyFramework`-folder, replacing the edited files, if necessary. You can then start the study again. Make sure to check that all data is there and backup the files before replacing them. Potentially, you could also only copy over lines of the files individually to maintain full control.
|
|
* There are two cases in which the Study Framework Plugin overwrites/deletes logged data, in both cases the data can be recovered:
|
|
|
* As for per-execution logs, i.e. GazeTrackingLogs, ParticipantLogs and PositionLogs: When restarting a condition, these files will not be overwritten, instead unique names are chosen. When restarting the entire study, the folders are moved to the RecyclingBin folder like the .csv-files.
|
|
1. Restart Condition:\
|
|
|
* Theoretically, it is also possible to recover the contents of the Phase Tables from the ParticipantLogs (in case something happened to the RecyclingBin...), but this is quite involved, a last resort. For more info on that see the [FAQ-Section](/Trouble Shooting)
|
|
-> When a single condition is restarted, the relevant data in the appropriate Phase Table (csv-files, "Phase_...") is overwritten. To avoid accidental data loss, a backup copy of all edited files is stored in the `StudyFramework/RecyclingBin` folder. To restore the previous version, stop running the study, then simply copy/paste the files back into the `StudyFramework/StudyLogs` folder, replacing the edited files. You can then start the study again. Make sure to check that all data is there and backup the files before replacing them. Potentially, you could also only copy over individual files or lines of files to maintain full control.
|
|
|
* Generally, it is recommended to back-up the `StudyFramework`-folder regularly during study execution, as this folder contains all study data _and_ all of the backups...
|
|
2. Restart Study:\
|
|
|
|
-> When restarting the entire study, all data in the `StudyFramework/StudyLogs` and `StudyFramework/StudyRuns` folders is cleared, i.e. it is moved to the `StudyFramework/RecyclingBin` folder. To restore the study to the previous state, simply stop running the study, and replace the `StudyFramework/StudyLogs` and `StudyFramework/StudyRuns` with their respective back-ups. You can then start the study again. Make sure to check that all data is there and backup the files before replacing them. Potentially, you could also only copy over individual files or lines of files to maintain full control.
|
|
|
|
Furthermore:
|
|
|
|
* Theoretically, it is also possible to recover the contents of the Phase Tables from the ParticipantLogs (in case something happened only to the Phase Tables...), but this is quite involved, a last resort. For more info on that see the [FAQ-Section](/Trouble Shooting)
|
|
|
|
* :bulb: Generally, it is recommended to back-up the `StudyFramework`-folder regularly during study execution, as this folder contains all study data _and_ all of the backups...
|
|
|
|
|
|
|
|
# Recording Data
|
|
# Recording Data
|
|
|
|
|
|
| ... | | ... | |
