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

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"
    }
}