Reference Path Visualization¶

Draw a static reference path on an image to visualize an expected or ideal route, displaying a predefined polyline path that can be compared against actual object trajectories for path deviation analysis and route compliance monitoring.

How This Block Works¶

This block takes an image and reference path coordinates (a list of points defining a path) and draws a static polyline path representing an expected route or ideal trajectory. The block:

1. Takes an image and reference path coordinates (a list of points: [(x1, y1), (x2, y2), (x3, y3), ...]) as input
2. Converts the coordinate list into a polyline path connecting the points in sequence
3. Draws the reference path as a polyline using the specified color and thickness
4. Returns an annotated image with the reference path overlaid on the original image

The block visualizes a static, predefined reference path that represents where objects should ideally move or what route they should follow. Unlike Trace Visualization (which draws dynamic paths based on actual tracked object movement), Reference Path Visualization draws a fixed path that remains constant. This reference path serves as a baseline for comparison, allowing you to visualize the expected route alongside actual object trajectories. The path is drawn as a continuous line connecting all the specified points, creating a visual guide for route compliance, path deviation analysis, or navigation workflows. This block is commonly used with Path Deviation analytics blocks to visually display the reference path that actual object trajectories will be compared against.

Common Use Cases¶

• Path Deviation Visualization: Visualize a reference path alongside actual object trajectories to compare expected routes against actual movement for path deviation detection, route compliance monitoring, or navigation validation workflows
• Route Planning and Navigation: Display predefined routes, navigation paths, or expected travel routes that objects should follow for route planning, navigation systems, or waypoint visualization applications
• Compliance and Safety Monitoring: Visualize expected paths for safety monitoring, compliance workflows, or route validation where objects need to follow specific paths (e.g., vehicles on designated lanes, robots on expected routes)
• Industrial and Logistics Applications: Display reference paths for conveyor systems, automated guided vehicles (AGVs), or manufacturing workflows where objects must follow predefined routes for process control or quality assurance
• Security and Access Control: Visualize expected movement paths for security monitoring, access control, or surveillance workflows where deviations from expected routes need to be identified
• Training and Documentation: Display reference paths in training materials, documentation, or demonstrations to show expected object behavior, routes, or movement patterns for educational or reference purposes

Connecting to Other Blocks¶

The annotated image from this block can be connected to:

• Path Deviation analytics blocks to compare tracked object trajectories against the visualized reference path for deviation analysis
• Other visualization blocks (e.g., Trace Visualization, Bounding Box Visualization, Label Visualization) to combine reference path visualization with actual object tracking visualizations for comprehensive path comparison
• Tracking blocks (e.g., Byte Tracker) where the reference path can serve as a visual baseline for comparing actual tracked object trajectories
• Data storage blocks (e.g., Local File Sink, CSV Formatter, Roboflow Dataset Upload) to save images with reference paths for documentation, reporting, or analysis
• Webhook blocks to send visualized results with reference paths to external systems, APIs, or web applications for display in dashboards or monitoring tools
• Notification blocks (e.g., Email Notification, Slack Notification) to send annotated images with reference paths as visual evidence in alerts or reports
• Video output blocks to create annotated video streams or recordings with reference paths for live monitoring, path visualization, or post-processing analysis

Type identifier¶

Use the following identifier in step "type" field: roboflow_core/reference_path_visualization@v1to add the block as as step in your workflow.

Properties¶

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Available Connections¶

Input and Output Bindings¶

The available connections depend on its binding kinds. Check what binding kinds Reference Path Visualization in version v1 has.

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/reference_path_visualization@v1",
    "image": "$inputs.image",
    "copy_image": true,
    "reference_path": "$inputs.expected_path",
    "color": "WHITE",
    "thickness": 2
}