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

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