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

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, keypoint_detection_prediction, object_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"
    }
}