Movements Classification¶
Movements are connections between two gates that define allowed travel paths in a measurement point.
What is a movement?¶
A movement:
- always connects an entry gate to an exit gate,
- represents a specific travel direction (for example AB, AC, BA),
- cannot exist without gates.
This means movements are the logical layer on top of gates: first you create gates, then you connect them with movements.
How a movement works¶
- Movement ID: Automatically generated from gate pairs (e.g., AB, AC, BA)
- Direction: Derived from gate types
- Entry Gate → Exit Gate: Directional movement (shown with arrows)
- Color: Automatically assigned from color palette
- Dependency on gates: Each movement stores
EntryGateandExitGate; if a referenced gate is removed or its type changes, related movements must be recreated - Gate anchor points: Movement start/end are anchored at the exact clicked position on each gate line (not forced to gate midpoint)
Creating movements¶
Step 1: Create movements¶
- Make sure you already have at least 2 gates.
- Navigate to Design → Movements tab.
- Click "Add Movement" button.

- Select source gate on image (entry point).

- Click the exact position on the source gate line where movement should start.

- Select target gate on image (exit point).
- Click the exact position on the target gate line where movement should end.

- The movement ID is automatically generated (e.g., "AB" for gate A → gate B).
- If no valid gates exist, movement creation is not possible.
Movement drawing preview¶
- During movement creation, after selecting the source gate, a straight preview line follows the mouse cursor.

- During movement creation, after selecting the source gate, the preview line bends into a straight line while you move the mouse.

- Movement anchors are stored as normalized position along each gate polyline, so after gate reshaping or moving, movement endpoints stay attached proportionally to the same place on the gate.
When to use movements?¶
Use movements when:
- you analyze routes at intersections (straight, left, right),
- you need to count only selected travel directions,
- you want to report flows between specific entry and exit checkpoints.
