v1.1.0

NOTICE: This version contains a critical bug that renders the GUI unusable. Please use v1.1.1 instead!

First major update of the PALILA GUI. This version is designed to iron out the kinks of v1.0.0 and to resolve some of its shortcomings. It also builds up to merging the codes that manage the audio and questionnaire questions, since they are very similar under the hood.

Find this software on Zenodo.

Known issues

• When replaying a sound sample, participants can continue to the next screen before the end of the sound sample. The running audio will continue playing while on the next screen.
• When returning to the initial questionnaire from the end screen, participants can only see the first of the questionnaire screens.
• The MultiMultipleChoiceQQuestion (questionnaire multiple choice, multiple answer) question type is not compatible with the system of dynamically unlocking question based on the answers of previous ones.

Planned changes for the next release

• A manual with a visual overview of the different options in the configuration file.
• Simplification of the README, mainly removing the description of the configuration file, since that will be in the manual.
• Fixes for the above-mentioned known issues.
• Bug fixes.

Added

• The number of replays of sound samples is now recorded in the output file:

  • For audio screens with 1 sample: <part name>-<audio name>(_<repetition index>)-replays
  • For audio screens with 2 samples: <part name>-<audio name>(_<repetition index>)-replays-left and
    <part name>-<audio name>(_<repetition index>)-replays-right

• A QuestionManager class to the questionnaire system to get closer to the system of audio questions.

• A ButtonAQuestion superclass for all question types that use buttons to answer (MultipleChoice, IntegerScale, etc.)

• A MultiMultipleChoiceQQuestion class to allow for multiple choice multiple answer questions in Questionnaires.

• Progress bar at the bottom of the screen to show progression through the experiment.

• A script to easily and quickly set up a new experiment.

Changed

• Code restructure to make the audio and questionnaire question systems more uniform.

  • Answers are now stored directly in a QuestionManager.answers, which is the Layout that holds the Question widgets.
  • Changed the multitude of functions to trigger an answer change to one singular change_answer() function.
  • The change_answer() function is now supplemented by a type-specific trigger function per question type.
  • ChoiceButton classes are now functionally the same.
  • questionnaire.py and questionnaire.kv have been split into questionnaire_questions and questionnaire_screen.
  • Logic for splitting the questionnaire over multiple sceens is moved to an external function questionnaire_setup().

• Change in the logic behind the keywords dependant and dependant condition:

  • They are now defined in the conditionally unlocked question and renamed: unlocked by and unlock condition.
  • All question types now allow for conditional locking/unlocking.

• An empty questionnaire block now results in no questionnnaire screen appearing at all.

• Repetition numbering of questions is now 1-indexed instead of 0-indexed.

• Timer now starts when leaving the welcome screen instead of when leaving the startup questionnaire.

Deprecated

• The keywords dependant and dependant condition will be removed in future versions.
  • This version supports the old system where these are defined in the question that conditionally unlocks another.
  • Future versions will only support the new system as described in change 2.

Removed

• N/A

Fixed

• Spinner Audio questions did not record their answer to the output file. This is fixed.

Full Changelog: v1.0.0...v1.1.0