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