Viso with The Observer XT

• Start and stop recording in Viso from The Observer XT
• Import Viso sessions into The Observer XT
• Import sessions directly
• Export sessions in Viso and import them in The Observer XT
• How Viso annotations appear in The Observer XT
• Further analysis 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.
   

   

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):

• RunPostCommand.bat and
• startstoprecording.ps1

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.
   

   

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.
   

   

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.
   

   

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  

• Video recording in Viso does not start immediately when Viso gets the command from The Observer XT. There is a delay. If the delay is less than 10 seconds The Observer XT takes it into account when you import the video. It automatically gives the video an offset relative to the start of the event log. If the delay is more than 10 seconds The Observer XT gives a warning informing you that the delay is, for instance, 10.66 seconds. You need to manually enter this offset in The Observer XT.
• The videos that you record in Viso are not automatically imported in The Observer XT. Please see The Observer XT Help for the procedure (File Management > Import Media Files).
• You can also Import Viso sessions into The Observer XT.

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. This requires communication between The Observer XT computer and the Viso Services computer.
  This option is only available with The Observer XT 13 and higher. If you have an earlier version of The Observer XT, Export sessions in Viso and import them in The Observer XT 

• Export sessions in Viso and import them in The Observer XT. Use this method if:
  - The computer with The Observer XT is not in the same network as the computers with Viso Services and Viso Recorder.
  - You have The Observer XT 12.5 or an older version.

Import sessions directly

aim

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

prerequisites

• You have a license for The Observer XT 13 or a newer version.
• The computers with Viso and The Observer XT are in the same network and set up for communication with N-Linx. The procedure to set this up is present in the Viso Setup Manual.
• You recorded the sessions (Trainer), received session ownership or annotator rights or invitations to view the sessions or your user role is Administrator or Technician.

procedure

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

   

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.
   

   

   
   
10. Select the sessions and click Import.
    

    

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

• You have a license for The Observer XT.
• You recorded the sessions (Trainer), received session ownership or invitations to view the sessions or your user role is Administrator or Technician.

procedure

In Viso:

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

   

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.
   

   

   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.
   

   

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

• Session export to The Observer XT, copies the videos and exports the session as an *.odx file to the specified location.
• If you cannot export the sessions to a location that can be accessed by The Observer XT, you need to copy the files to a location that can. Make sure you copy both the .odx file and the videos to the same location. Do not import the .odx file from, for example, a USB stick, because The Observer XT then will not have access to the videos once the USB stick is removed.
• The videos are automatically linked to the imported observation.
• Subjects and 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 time the session was created added to the filename.   
• It is also possible to import Viso sessions into an existing observation. For example if you already carried out an observation with the Viso videos. To do so, open the observation and click the Import data button on the toolbar.
  

  

  Choose Import observational data, select the .odx file and click Open.

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.

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.   

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:

• Carry out a Behavior analysis to obtain quantitative data about your session, like the frequency or the latency of a scored marker. See Calculate Statistics in The Observer XT Help.
• Add new elements to the Coding Scheme and annotate the Viso videos. See Set up your Project and Carry out an Observation in The Observer XT Help.
• Select time fragments based on behaviors in the Coding Scheme for further analysis. See Select Data for Analysis in The Observer XT Help.