Use of QAParadigm

  1. System requirements

    1. To run QAParadigm, the computer system must have at least
      Java Runtime Environment 1.5
      installed.
    2. QAParadigm makes effective use of multiple computer screens, or can be used with a single screen.
    3. Separate recording equipment is required. QAParadigm does no audio recording.
  2. Experiment preliminaries

    1. Input text file consisting of numbered displays
      • must have Unix line endings (line feed)
        not Mac (carriage return) and
        not Windows/DOS (carriage return+line feed)
      • must be Unicode (UTF-8) encoded

      For text displays, the first line must read

      number text

      For picture file displays, the first line must read

      number picture

      For text displays, the format of following lines is

      decimal number + tab character + sentence

      For picture displays, the format of following lines is

      decimal number + tab character + picture_file_name

      The picture_file_name must be alphanumeric, and can contain understroke and period characters, but nothing else.

      Other lines are ignored.

    2. Sound files corresponding to each sentence in the input text file.

      The sound files must be WAV files, named

      qn.wav

      where n is the number of the associated sentence. They must be in the same directory as the input text file.

    3. Who operates the program? the experimenter, or does the subject?

      If the experimenter operates the program, a second monitor can be used.

    4. recording equipment must be ready to record the subject’s responses
  3. Operator starts the application

    1. Using the File menu, open the text file containing numbered sentences
    2. Fill in information about subject
    3. Click Go

      (Display window should appear, showing first sentence)

    4. This window has a pop-up menu including settings for the font and font size. (In multiple-screen mode, the same menu appears on the main application dialog.)
    5. There is a Preferences... item under the File menu that brings up a panel of operating preferences. From this, the operator can choose:
      • To randomize sentences (the default)

        In case the input file has been pre-randomized, the user may choose to turn this off.

      • Seconds to delay after playing a sound

        During this delay, a further sound can’t be played, and the displayed sentence can’t be advanced. The idea is to enforce a period of time in which the subject is to answer.

      • Display device

        If there are multiple screens attached to the computer, this number will specify which screen the display is to appear.

      The preferences settings are remembered from one run of the program to the next.

  4. Subject takes control

    (If it is necessary to pause at this point, use the Esc key.)

    1. Space bar plays the associated sound file, as many times as desired.

      There is a configurable delay after the sound finishes during which the Enter and Space keys are disabled.

      A progress bar shows how much time is left.

    2. Enter key goes to next sentence.

      (but the sound must be played at least once before going to the next sentence: otherwise they will get an error dialog)

    3. When the sentences are finished, a thank-you message appears.
    4. A further press of the Enter key closes the display window and brings back the main application window.
  5. Log files

    The log file primarily records which sentences, in what order, were presented to the user.

    Log files are written into a sub-directory logs of the input text file’s directory, with a file name reflecting the subject’s name, followed by a time stamp. (If the subject name field is left blank, the log file name will begin with “anonymous“)

    It also records the user information in the header, as well as a time stamp, and the path of the input sentence file that was used to generate the list of sentences for the experiment.

    The log file columns are

    sequence #	sentence #	millisec	sentence
    

    The sequence # is the index of the sentence among the randomized list of sentences. It will usually just increase. If the order of the sentences is altered (as by using the Previous sentence command), the change in order will be reflected in this column.

    The millisec column is the (approximate) number of milliseconds from the opening of the log file to the time the sentence is displayed. This is meant to aid with synchronization with recordings.

    The sentence # indicates which sentence was displayed and which sound played. The sentence column is a redundant indicator of the displayed sentence.

Problems

When an input text file is opened, it is read, then its directory is scanned for sound files corresponding to the numbered sentences. If any is missing, the operator is warned and the display file is not opened.

Before opening the display window (with the Go button), all the sentences are checked for support with system fonts. If no font on the system supports all characters in all the sentence, an alert window will come up, explaining in which sentence and which character, the problem is first recognized. If fonts are found that support all the sentences, by default, the first such font found by Java will be the one used.

If the text is displayed in nonsense characters, check that the input file has UTF-8 encoding. (It is possible that your text editor displays the characters correctly but doesn’t save the text as UTF-8.)

If a problem occurs with a single sentence, the left-arrow key can be used to go back in the sequence of sentences. All viewings of the sentence are recorded in the log file. The sequence number in the log file will show that the user backed up.

The current sequence number can be displayed from the display window pop-up menu. It can also be changed in this way, but the sense of the experiment may be altered by such action.

If the display window needs to be closed during an experiment, the Go button of the main window will re-start the same sequence from the last sentence whose sound has not played, so long as Open has not been used to open a new sentence file. A new log file will be started, with its sequence number continuing from the last in the previous log file.