Detections Transformation

Class: DetectionsTransformationBlockV1

Source: inference.core.workflows.core_steps.transformations.detections_transformation.v1.DetectionsTransformationBlockV1

Block changes detected Bounding Boxes in a way specified in configuration.

It supports such operations as changing the size of Bounding Boxes.

Type identifier

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

Properties

Name	Type	Description	Refs
name	str	Enter a unique identifier for this step..	❌
operations	List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]	Transformations to be applied on the predictions..	❌

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 Transformation in version v1.

• inputs: Crop Visualization, SIFT, Stitch OCR Detections, Blur Visualization, PTZ Tracking (ONVIF).md), Cache Set, Property Definition, Camera Focus, Mask Visualization, VLM as Classifier, Object Detection Model, Keypoint Detection Model, Image Preprocessing, Qwen2.5-VL, Object Detection Model, Bounding Rectangle, Cache Get, JSON Parser, SmolVLM2, LMM, Polygon Zone Visualization, QR Code Generator, Size Measurement, Florence-2 Model, Moondream2, Template Matching, Label Visualization, Pixel Color Count, Segment Anything 2 Model, Stability AI Image Generation, Keypoint Detection Model, Relative Static Crop, Slack Notification, Corner Visualization, Multi-Label Classification Model, Overlap Filter, Image Blur, Gaze Detection, Model Comparison Visualization, VLM as Detector, Time in Zone, Image Threshold, Roboflow Dataset Upload, CogVLM, Byte Tracker, Barcode Detection, Single-Label Classification Model, First Non Empty Or Default, Polygon Visualization, Stability AI Outpainting, Keypoint Visualization, Time in Zone, Grid Visualization, Delta Filter, OpenAI, Florence-2 Model, Image Slicer, Instance Segmentation Model, Twilio SMS Notification, Detections Stitch, Identify Changes, Continue If, Dynamic Crop, Anthropic Claude, QR Code Detection, Line Counter, Line Counter, Rate Limiter, LMM For Classification, Line Counter Visualization, Color Visualization, Image Contours, Image Convert Grayscale, Circle Visualization, Google Gemini, Data Aggregator, Cosine Similarity, Absolute Static Crop, Expression, Dynamic Zone, Multi-Label Classification Model, Environment Secrets Store, Byte Tracker, Detections Consensus, Stitch Images, Detections Filter, Trace Visualization, Roboflow Custom Metadata, OCR Model, Detections Transformation, Clip Comparison, YOLO-World Model, CLIP Embedding Model, Halo Visualization, Perspective Correction, Buffer, Stability AI Inpainting, Velocity, Webhook Sink, Distance Measurement, VLM as Detector, Perception Encoder Embedding Model, Triangle Visualization, Background Color Visualization, Detections Stabilizer, Byte Tracker, Path Deviation, Icon Visualization, SIFT Comparison, Pixelate Visualization, CSV Formatter, Instance Segmentation Model, Llama 3.2 Vision, Google Vision OCR, Reference Path Visualization, VLM as Classifier, Image Slicer, Identify Outliers, Depth Estimation, Roboflow Dataset Upload, Detection Offset, OpenAI, Classification Label Visualization, Dot Visualization, Email Notification, Local File Sink, OpenAI, Single-Label Classification Model, Bounding Box Visualization, Camera Calibration, Detections Classes Replacement, Ellipse Visualization, Detections Merge, Path Deviation, Model Monitoring Inference Aggregator, Dimension Collapse, SIFT Comparison, Dominant Color, Clip Comparison
• outputs: Crop Visualization, Stitch OCR Detections, Line Counter, Segment Anything 2 Model, Line Counter, Triangle Visualization, Blur Visualization, PTZ Tracking (ONVIF).md), Background Color Visualization, Color Visualization, Detections Stabilizer, Corner Visualization, Byte Tracker, Path Deviation, Mask Visualization, Icon Visualization, Overlap Filter, Circle Visualization, Pixelate Visualization, Model Comparison Visualization, Time in Zone, Dynamic Zone, Byte Tracker, Detections Consensus, Roboflow Dataset Upload, Byte Tracker, Roboflow Dataset Upload, Detection Offset, Detections Filter, Trace Visualization, Roboflow Custom Metadata, Polygon Visualization, Keypoint Visualization, Dot Visualization, Time in Zone, Bounding Rectangle, Detections Transformation, Bounding Box Visualization, Detections Classes Replacement, Ellipse Visualization, Size Measurement, Halo Visualization, Detections Merge, Perspective Correction, Florence-2 Model, Stability AI Inpainting, Florence-2 Model, Path Deviation, Model Monitoring Inference Aggregator, Velocity, Detections Stitch, Label Visualization, Distance Measurement, Dynamic Crop

Input and Output Bindings

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

Bindings

• input

  • predictions (Union[object_detection_prediction, instance_segmentation_prediction, keypoint_detection_prediction]): Model predictions to transform..
  • operations_parameters (*): References to additional parameters that may be provided in runtime to parameterize operations.

• output

  • predictions (Union[object_detection_prediction, instance_segmentation_prediction, keypoint_detection_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 or Prediction with detected bounding boxes and detected keypoints in form of sv.Detections(...) object if keypoint_detection_prediction.

Example JSON definition of step Detections Transformation in version v1

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/detections_transformation@v1",
    "predictions": "$steps.object_detection_model.predictions",
    "operations": [
        {
            "filter_operation": {
                "statements": [
                    {
                        "comparator": {
                            "type": "in (Sequence)"
                        },
                        "left_operand": {
                            "operations": [
                                {
                                    "property_name": "class_name",
                                    "type": "ExtractDetectionProperty"
                                }
                            ],
                            "type": "DynamicOperand"
                        },
                        "right_operand": {
                            "operand_name": "classes",
                            "type": "DynamicOperand"
                        },
                        "type": "BinaryStatement"
                    }
                ],
                "type": "StatementGroup"
            },
            "type": "DetectionsFilter"
        }
    ],
    "operations_parameters": {
        "classes": "$inputs.classes"
    }
}