Trouble Shooting

Here is a collection of problems that might occur and how to potentially solve them. Please add new insights ;-)

• In HMD mode the screen stays black every now and then without showing the experimenter view:

This is a known bug, you need to always close the application using Esc or the End Study-Button. If you use the ❌ of the window, this will happen every second time. There is an issue collecting forther information on this: #60

• On one of my maps the study experimentor overlay is not shown:

Maybe the map overwrites the gamemode, open the World Settings on that map an check:

This should be None

• There are weird characters in my csv Phase log files, e.g.:
  

These are Byte-Order-Marks (BOM) which appeared in data logged by some previous versions of the plugin. This has been fixed. If your logged data has been generated by an older version and contains BOMs, you can place and execute the following python code in the folder (``StudyFramework/StudyLogs``) where the phase csv files are, to get rid of them:

RemoveBOMs

import os

def ConvertCoding(full_filename):
    #remove all the byte order marks that Unreal puts in there
    with open(full_filename, mode='r', encoding='utf-8-sig') as file:
        lines = file.readlines()
        modified_lines = [line.lstrip('\ufeff') for line in lines]
    with open(full_filename, mode='w', encoding='utf-8') as file:
        file.writelines(modified_lines)

for filename in os.listdir("./"):
    if filename.endswith(".csv"): 
        print("Convert " + filename)
        ConvertCoding(filename)

• I accidentally restarted the study or restarted a condition

Whenever a condition or the entire study is restarted, a backup of the changed/deleted files can be found under StudyFramework/RecyclingBin. To recover the files, stop running the study, then choose the appropriate timestamps, copy/paste the files 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.

• I lost some data in the phase data tables due to whatever reasons during study execution.

If you lost data because of selecting "Restart Study" or accidentally restarted a condition, for which data has already been collected, see above.
If you lost data another way: Fortunately everything is logged redundantely also per participant, so your data can most probably be recovered. Here is a script that, when placed in the StudyFramework folder should do the trick. Maybe you need to adapt parts, since it was developed and tested for one specific study setup. SO CHECK YOUR DATA CAREFULLY! ReconstructPhaseTablesFromParticipantLogs.py