Guide 11, intermediate
Which way do people go? A route-choice study
Import a ready-made scene with an entrance gate, two exit gates and two routes, run it, and read route shares, outcomes and decision times.
- Time
- 20 minutes
- You need
- The corridor sample video and the sample scene file
- Pages of the app
- Scene Builder, Experiments, Analysis
- Topics
- Routes and rules People
What you will be able to do
- Import a scene from a JSON file
- Understand gates, routes and route outcomes
- Read route shares and behavioural measures
- Build a route yourself with the Route tool
A route is a path through gates: a start gate, optional checkpoints and an end gate. When several routes share the same start gate, they form one study. Every person who passes the start is recorded as exactly one of the routes, or as Unknown, Abandoned or Lost track.
The repository has a finished scene for the corridor clip. People pass an entrance gate in the middle of the room and leave by an exit on the left or on the right.
Step 1. Import the sample scene
- Open the Scene Builder of the
Corridorcamera. If it does not exist yet, add it as in guide 02. - Click Import JSON at the bottom of the tool column and choose
samples\scenes\corridor_route_choice.json. - The scene now has three gates,
Entrance,Exit LeftandExit Right, a zone calledCentre floor, and two routes. - Click Save in the top bar, or press
Ctrl+S.
Step 2. Look at a route
- In the inspector, under Routes, click
Route A. - It reads: Starts when the object passes
Entrance, and Completes when the object passesExit Left. - Give up after (seconds) is 30. A person who passes the entrance but reaches no exit within 30 seconds is recorded as Abandoned.
- Click Back to return to the scene overview.
Route Bis the same withExit Right.
Step 3. Run it
- Click New experiment, name it
Corridor route choice, keep Person and click Create experiment. - Click Start. During the run, the bottom bar counts each route.
- When the clip has finished, click Results.
Step 4. Read the routes
The Routes panel starts with the outcomes:
| Value | Meaning | Sample result |
|---|---|---|
| Total observations | People who passed the start gate | 3 |
| Valid (route completed) | People who finished one of the routes | 3 |
| Unknown | Reached an exit without a required checkpoint | 0 |
| Abandoned (timeout) | Reached no exit within the time limit | 0 |
| Lost track | Disappeared from view before an exit, or was still on the way when the run stopped | 0 |
The table below it gives each route’s Count, Share of valid,
Mean duration and Median duration. The sample shows Route A 2 times
(66.7 %) and Route B once (33.3 %).
Under Behavioural measurements you find these values:
- Mean decision time. The time from the start gate to the next line or zone the person passes, usually the first checkpoint or exit. About 1 second in the sample.
- Route switches. People who passed a checkpoint of another route first.
- Same route as the previous observation. Whether people followed the person before them.
Three people are far too few for a conclusion. The sample only shows the method. A real study needs many more observations, and the page reminds you that correlations describe the recorded scene, not the reasons for a choice.
Build a route yourself
- Draw the gates first: press
Gand click the two ends of each gate. Draw each gate across the whole path people take. - Press
Rfor the Route tool. - Click the start gate, then any checkpoints in order, then the end gate.
- Press
Enter, or click Finish route. - Name the route in the inspector and set Give up after (seconds) to a bit more than the slowest normal walk from start to end. Routes that share a start gate all use the longest of their limits.
- Click Save in the top bar, or press
Ctrl+S.
A checkpoint is drawn with C, as a small area. Require every checkpoint
is ticked for new routes, so people who skip a checkpoint are recorded as
Unknown. Untick it to count them for the route anyway, with the missed
checkpoints noted in the event.
Next
Guide 12 compares how much each part of the floor is used. Guide 13 records custom sequences, such as passing the entrance and then entering the centre.
This page is docs/guides/11-route-choice.md from ajm2004/CV-Scope@eaf904a
, committed 30 September 2026. The repository is the source of truth; this site renders
it.