Detections Combine

Class: DetectionsCombineBlockV1

Source: inference.core.workflows.core_steps.transformations.detections_combine.v1.DetectionsCombineBlockV1

Combine two sets of detection predictions into a single unified set of detections by merging both detection sets together, preserving all detections from both inputs for multi-source detection aggregation, combining results from multiple models, and consolidating detection sets from different processing stages into one workflow output.

How This Block Works

This block combines two separate sets of detection predictions into a single unified detection set by merging all detections from both inputs. The block:

1. Receives two separate detection prediction sets (prediction_one and prediction_two), each containing multiple detections from object detection or instance segmentation models
2. Processes both detection sets independently (each set maintains its own detections, properties, masks, and metadata)
3. Merges the two detection sets using supervision's Detections.merge() method:
4. Combines all detections from prediction_one with all detections from prediction_two
5. Preserves all detection properties from both sets (bounding boxes, masks, classes, confidence scores, metadata)
6. Maintains detection order (typically prediction_one detections followed by prediction_two detections)
7. Handles all detection attributes including masks (for instance segmentation), keypoints, class IDs, class names, confidence scores, and custom data fields
8. Returns a single unified detection set containing all detections from both inputs

The block simply concatenates the two detection sets together, preserving all detections and their properties from both sources. Unlike the Detections Merge block (which creates a union bounding box from multiple detections), this block maintains all individual detections from both sets in the output. This is useful for combining detections from different models, different processing stages, or different detection sources into a single workflow stream for unified downstream processing.

Common Use Cases

• Multi-Model Detection Aggregation: Combine detections from multiple detection models into a single unified set (e.g., combine detections from different object detection models, merge results from specialized models, aggregate detections from multiple model outputs), enabling multi-model detection workflows
• Multi-Stage Detection Combination: Combine detections from different processing stages or workflow branches (e.g., merge detections from different workflow paths, combine initial detections with refined detections, aggregate detections from multiple processing stages), enabling multi-stage detection aggregation
• Detection Source Consolidation: Consolidate detections from different sources or inputs into one set (e.g., combine detections from multiple images or frames, merge detections from different regions, aggregate detections from various sources), enabling detection source unification
• Classification and Detection Combination: Combine object detection results with classification results or other detection types (e.g., merge object detections with classification outputs, combine different detection types, aggregate complementary detection sets), enabling multi-type detection workflows
• Filtered and Unfiltered Detection Combination: Combine filtered detections with unfiltered detections or combine different filtered subsets (e.g., merge filtered detections by different criteria, combine specific class detections with general detections, aggregate different filtered detection sets), enabling flexible detection combination workflows
• Workflow Branch Merging: Merge detection results from different workflow branches back into a single detection stream (e.g., combine parallel processing branch results, merge conditional workflow paths, aggregate branch detection outputs), enabling workflow branch consolidation

Connecting to Other Blocks

This block receives two detection prediction sets and produces a single combined detection set:

• After multiple detection blocks to combine detections from different models into one unified set (e.g., combine detections from multiple object detection models, merge results from different segmentation models, aggregate detections from various model outputs), enabling multi-model detection aggregation workflows
• After filtering blocks to combine filtered detection subsets (e.g., merge detections filtered by different criteria, combine class-specific filtered detections, aggregate various filtered detection sets), enabling filtered detection combination workflows
• At workflow merge points where different workflow branches need to be combined (e.g., merge parallel processing branch results, combine conditional path outputs, aggregate branch detection streams), enabling workflow branch merging workflows
• Before downstream processing blocks that need unified detection sets (e.g., process combined detections together, visualize unified detection sets, analyze aggregated detections), enabling unified detection processing workflows
• Before crop blocks to process combined detections together (e.g., crop regions from combined detection sets, extract areas from aggregated detections, process unified detection regions), enabling combined detection region extraction
• Before visualization blocks to display unified detection sets (e.g., visualize combined detections from multiple sources, display aggregated detection results, show merged detection outputs), enabling unified detection visualization workflows

Type identifier

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

Properties

Name	Type	Description	Refs
name	str	Enter a unique identifier for this step..	❌

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

Available Connections

Compatible Blocks

Check what blocks you can connect to Detections Combine in version v1.

• inputs: OCR Model, Detections Filter, Detection Offset, Line Counter, Object Detection Model, Detection Event Log, Detections Stabilizer, Detections List Roll-Up, Path Deviation, YOLO-World Model, Object Detection Model, Detections Merge, SAM 3, Time in Zone, Detections Classes Replacement, Template Matching, Bounding Rectangle, Byte Tracker, Instance Segmentation Model, Dynamic Zone, Google Vision OCR, VLM as Detector, Detections Consensus, Detections Combine, SAM 3, Byte Tracker, PTZ Tracking (ONVIF).md), Time in Zone, Seg Preview, Dynamic Crop, Detections Transformation, SAM 3, Time in Zone, Detections Stitch, Segment Anything 2 Model, Byte Tracker, Moondream2, Overlap Filter, Instance Segmentation Model, Perspective Correction, Motion Detection, Path Deviation, EasyOCR, Velocity, VLM as Detector
• outputs: Corner Visualization, Label Visualization, Stitch OCR Detections, Blur Visualization, Roboflow Custom Metadata, Triangle Visualization, Detections Consensus, Florence-2 Model, Camera Focus, Detections Combine, Ellipse Visualization, Halo Visualization, Byte Tracker, PTZ Tracking (ONVIF).md), Dot Visualization, Time in Zone, Background Color Visualization, Stitch OCR Detections, Model Comparison Visualization, Detections Filter, Detection Offset, Line Counter, Distance Measurement, Polygon Visualization, Detection Event Log, Detections Stabilizer, Stability AI Inpainting, Dynamic Crop, Trace Visualization, Detections List Roll-Up, Detections Transformation, Circle Visualization, Path Deviation, Roboflow Dataset Upload, Crop Visualization, Icon Visualization, Florence-2 Model, Time in Zone, Detections Stitch, Segment Anything 2 Model, Byte Tracker, Overlap Filter, Model Monitoring Inference Aggregator, Color Visualization, Detections Merge, Perspective Correction, Mask Visualization, Roboflow Dataset Upload, Halo Visualization, Time in Zone, Detections Classes Replacement, Path Deviation, Line Counter, Pixelate Visualization, Bounding Rectangle, Byte Tracker, Polygon Visualization, Velocity, Dynamic Zone, Bounding Box Visualization, Size Measurement

Input and Output Bindings

The available connections depend on its binding kinds. Check what binding kinds Detections Combine in version v1 has.

Bindings

• input

  • prediction_one (Union[instance_segmentation_prediction, object_detection_prediction]): First set of detection predictions to combine. Supports object detection or instance segmentation predictions. All detections from this set will be included in the output. Detection properties (bounding boxes, masks, classes, confidence scores, metadata) are preserved as-is. This set is combined with prediction_two to create the unified output. Detections from this set typically appear first in the merged output..
  • prediction_two (Union[instance_segmentation_prediction, object_detection_prediction]): Second set of detection predictions to combine. Supports object detection or instance segmentation predictions. All detections from this set will be included in the output. Detection properties (bounding boxes, masks, classes, confidence scores, metadata) are preserved as-is. This set is combined with prediction_one to create the unified output. Detections from this set are merged with detections from prediction_one to form a single combined detection set..

• output

  • predictions (Union[object_detection_prediction, instance_segmentation_prediction]): Prediction with detected bounding boxes in form of sv.Detections(...) object if object_detection_prediction or Prediction with detected bounding boxes and segmentation masks in form of sv.Detections(...) object if instance_segmentation_prediction.

Example JSON definition of step Detections Combine in version v1

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/detections_combine@v1",
    "prediction_one": "$steps.my_object_detection_model.predictions",
    "prediction_two": "$steps.my_object_detection_model.predictions"
}