Skip to content

visualization

Visualization settings (CLI override).

These control the annotated-video output from 'geotrax visualize'. Override any key via its CLI flag.

Generated from geotrax/cfg/default.yaml; every row below is a key of that file with its shipped default and its inline comment.

Key Default CLI Description
save true --save, --no-save Save annotated output video to file
show false --show, --no-show Open a live preview window during processing
tail_length 30 --tail-length Track tail length [frames]; number of past positions drawn as a fading trail; [1, inf)
line_width 2 --line-width Bounding-box and track stroke width [px]; [1, inf)
viz_mode 0 --viz-mode Frame source for annotation: 0=original, 1=stabilized, 2=reference frame, 3=rotated boxes on the original frame, 4=rotated boxes on the stabilized frame; use a list (e.g. [0, 1, 4]) to render one video per mode
heading_smoothing 15 --heading-smoothing (modes 3, 4) Gaussian smoothing window [frames] for the per-frame heading; larger = steadier, slower to follow turns; [1, inf)
heading_min_speed 0.5 --heading-min-speed (modes 3, 4) Min smoothed pixel speed [px/frame] for a reliable heading; below this the heading is held from the last reliable frame; [0, inf)
edge_clip_margin 3 --edge-clip-margin (modes 3, 4) Distance [px] within which a detection box is treated as touching a frame edge, triggering clipping of the oriented box to the visible part (absorbs HBB inaccuracy); [0, inf)
edge_clip_smoothing 5 --edge-clip-smoothing (modes 3, 4) Gaussian window [frames] for smoothing the clip rectangle of edge-touching boxes so the box shape stays steady as the vehicle exits; 0 disables; [0, inf)
plot_trajectories false --plot-trajectories, --no-plot-trajectories Overlay all trajectory positions on the first frame before the main pass
plot_delay 30 --plot-delay Frames to hold the trajectory overlay before starting the main pass; [1, inf)
show_conf false --show-conf, --no-show-conf Include detection confidence score in the bounding-box label
show_lanes false --show-lanes, --no-show-lanes Include lane ID in the bounding-box label (requires georeferencing)
show_class_names false --show-class-names, --no-show-class-names Include vehicle class name in the bounding-box label
hide_labels false --hide-labels, --no-hide-labels Suppress all label text overlays
hide_tracks false --hide-tracks, --no-hide-tracks Suppress track tail lines
hide_speed false --hide-speed, --no-hide-speed Suppress speed values in labels (requires georeferencing)
speed_unit "km/h" --speed-unit Speed display unit; choices: [km/h, mi/h]
speed_deadzone 1 --speed-deadzone Floor displayed speeds <= this value (in speed_unit) to 0, hiding stationary-vehicle jitter; 0 disables; [0, inf)
class_filter [] --class-filter Vehicle class IDs to exclude from visualization (e.g. [1, 2] hides bus and truck)