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

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[instance_segmentation_prediction, object_detection_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"
    }
}