Viso with The Observer XT

Start and stop recording in Viso from The Observer XT

Combining your Viso recordings with other data may give you a more complete picture of the phenomena that you are studying. For instance, when testing your newly developed website, it may be interesting to record the test participant’s screen and annotate his/her verbal reactions but it may be even more intriguing to know what facial expressions your website evokes or what physiological responses. For the integration of all these data you can use The Observer XT.

You can automatically start and stop recording in Viso from The Observer XT and at the same time start facial expression analysis in, for instance, FaceReader (our tool for automatic analysis of facial expressions) and start the acquisition of physiological data. The data streams and Viso recordings can be imported into The Observer XT. You can then view the test participants’ actions, his/her facial expressions and physiological responses and calculate statistics.

  

NOTE To start and stop recording in Viso from The Observer XT the two programs can be on the same computer or on separate computers that are part of a local network.

prerequisite

If Viso and The Observer XT run on separate PCs - Security certificates need to be set up and trusted on both PCs. See Appendix G ‘Security certificates’ in the Viso Setup Manual for more information.

procedure

  1. Set up Viso to allow remote control from The Observer XT
  2. Edit the batch file
  3. Set up The Observer XT for live observation
  4. Run a test

Set up Viso to allow remote control from The Observer XT

aim

Prepare Viso to receive commands from The Observer XT.

prerequisites

Your user role allows editing locations (Technician).

procedure

  1. Open the Locations tab and click the pencil button of the location of your choice.
  2. Select Remote controlled by and click the Settings button. A window will open with a remote token. You need this token when editing the batch file (see step 3 in Edit the batch file). Click OK. Save the token in a text file in, for instance, Notepad, and press the Copy button to copy the token for use in The Observer XT PC.
  3. Select who can control the location. The drop-down list shows all users and groups of all departments and also the users that have not been assigned to a department. Select the user who will carry out the test with the test participants and click OK.

    Remote Control Token.jpg

  4. Repeat steps 1-3 to control more than one location.

  5. Log out of Viso and ask the user who is going to run the test to log in.

NOTE  You can also control Viso with a programmable button.

Edit the batch file

To start and stop recording in Viso from The Observer XT you need two scripts which you can download using your MyNoldus account. You can find the scripts in the Drivers and Tools Scripts folder, both under Viso and The Observer XT):

Browse to my.noldus.com if you do not have a MyNoldus account yet.

procedure - 1-PC set-up

Follow the steps below if Viso and The Observer XT run on the same PC.

  1. Copy the scripts to the Viso/Observer XT PC.
  2. Open the batch file (RunPostCommand.bat) in Notepad or a similar text editor.
  3. Specify the location of the ps script.

    image.png

  4. Save the batch file.

procedure - 2-PC set-up

Follow the steps below if Viso and The Observer XT run on separate PCs.

  1. Copy the scripts to the Observer XT PC.
  2. Open the batch file (RunPostCommand.bat) in Notepad or a similar text editor.
  3. In the first Set line of the batch file
    - Change ‘http’ into ‘https’.
    - Replace ‘localhost’ with the computer name of the Viso PC.
    - Replace port number ‘5000’ in the third line of the batch file with ‘5001’.
    To find the Viso Services computer name
    Click the Windows icon and type system. Click System Information. You will find the name under System Name.
  4.  In the last line of the batch file specify the location of the ps script.

    image.png

  5. Save the batch file.

Set up The Observer XT for live observation

procedure

  1. Open The Observer XT and create a new project.
  2. Choose Setup >Project Setup and select Live Observation. The Devices window opens. If not, click the Devices button.
  3. Click Add external program. The Add External Program window opens.

    image.png

  4. In the Name field, enter ‘Control Viso’ or a similar name to indicate that these are the settings to control Viso.
    TIP: Add the Viso location name when controlling multiple locations from The Observer XT.
  5. Select the checkbox next to Start Observation.
  6. In the same row, click the ellipsis button next to the Program field and browse to the batch file (RunPostCommand.bat).
  7. Select the file and click Open.
  8. In the Command line options field enter ‘start <token generated in Viso for the location>’. This instructs Viso to start recording when you start an observation.
  9. Select the checkbox next to Stop Observation.
  10. In the same row, click the ellipsis button next to the Program field and browse to the batch file (RunPostCommand.bat).
  11. Select the file and click Open.
  12. In the Command line options field enter ‘stop <token generated in Viso for the location>’. This instructs Viso to stop recording when you stop an observation.
  13. Leave the ms. before fields of the lines Start Observation and Stop Observation empty.
  14. Click OK. The Devices list now shows a new device with the name you gave in step 4. Select the checkbox in front of it.
  15. Repeat steps 3-14 if you want to control more than one location.

Run a test

procedure

  1. Invite the participants to enter the test room and check that the cameras are well positioned.
  2. Create a new observation in The Observer XT.
  3. Start the observation in The Observer XT. Depending on the settings, the Independent Variable List appears.
  4. Enter the values of the independent variables and click OK.
  5. Video recording in Viso starts. Please note that video recording does not start immediately, there is a delay.
  6. Optionally - Manually annotate events in The Observer XT or in Viso. For more information about manually annotating in Viso see Chapter 6 of this Reference (Annotations). To be able to annotate events in Viso you will need the Annotation module.
  7. Stop the observation in The Observer XT. Video recording in Viso stops.
  8. In Viso enter a name for your session. If you specified a default session name, the session automatically gets a name.

notes  

Import Viso sessions into The Observer XT


The videos created by Viso can be opened in the manual annotation program The Observer XT and, optionally, the annotations can be imported into an observation. All codes from the selected Codes list are imported into The Observer XT, independent of whether they were scored or not. Viso subjects are added to the coding scheme as subjects. Markers are added to the coding scheme as point events. Remarks are imported into The Observer XT as comments in the event log. You can create extra codes in The Observer XT and annotate sessions for further analysis.

There are two ways to import Viso sessions into The Observer XT:

Import sessions directly

aim

To import Viso sessions in The Observer XT. This makes use of the Noldus network communication protocol N-Linx.

prerequisites

procedure

  1. In The Observer XT, choose File > Preferences.
  2. Open the tab Viso settings.

    image.png

  3. Select Use Viso services to connect with Viso.
  4. In the Services address field, enter the computer name or IP address of the Viso Services computer. Ask your colleague who manages the Viso set-up for the details.
  5. In the Services port field, leave the default port number 5672.
  6. Click Test connection. If The Observer XT computer finds the Viso Services computer, the text Connected appears. Click OK.
  7. Create a new project or open an existing one (File> New/Open Project).
  8. Choose File > Import > Viso Sessions.
  9. Enter your Viso login details.
    NOTE  If you are logged in in Viso, log out first. You can only import the sessions that you are allowed to view.

    image.png


  10. Select the sessions and click Import.

    image.png

NOTE Each session is imported as a separate observation. The videos are copied to the Video Files folder of The Observer XT. Markers are added to the coding scheme and remarks appear as comments in the Event log (see also How Viso annotations appear in The Observer XT). The observation is named after the imported session, with the location name and the date and time the session was created added to the filename.

NOTE If you have a license for The Observer XT 12.5 or earlier, you cannot import sessions directly into Viso. You must Export sessions in Viso and import them in The Observer XT.

Export sessions in Viso and import them in The Observer XT

aim

To import Viso sessions in The Observer XT if the computers with Viso and The Observer XT are not in the same network, or you have an older version of The Observer XT (see Prerequisites to Import sessions directly).

prerequisites

procedure

In Viso:

  1. Open the Sessions tab.
  2. Right-click a session and select Export to The Observer XT.

    image.png

  3. Specify the destination folder that can be accessed by The Observer XT, for example its Video Files folder.

  4. 4.Select if you want to export the separate videos, or combine all videos into one picture-by-picture video per location.

  5. Click Export.

    image.png

    You will find the exported videos and the .odx file containing scored markers and comments in the destination folder.

    In The Observer XT:

  6. Create a new project or open an existing one (File> New/Open Project).
  7. Import the .odx file as a new observation. Choose File > Import > Observational data.

    image.png

  8. Select the .odx file and click Open.
  9. In the Import Observational Data window that appears, select Yes, import new coding scheme elements.
  10. A message appears whether import is successful. Click Close.

Notes

How Viso annotations appear in The Observer XT

In the Coding Scheme

In The Observer XT, choose Setup > Open Coding Scheme, to open the Coding Scheme. Viso subjects appear in the Subjects panel. Viso markers are added as Point events in a Start-Stop group. Remarks are not added to the Coding Scheme.

image.png

In the observation

Choose Observe > Observation > Open > [session name and time] to view the annotations in the Event Log. Viso Subjects are also Subjects in The Observer XT. Markers are point events and are indicated with blue dots. Remarks are imported as comments in the Event Log.   

image.png

To jump to the video frame at which a certain marker or remark was scored, click its row in the Event Log.   

Further analysis with The Observer XT

In The Observer XT you can further analyze your sessions. For example: