Auto Rotate on Edges¶

Automatically deskew an image by finding the rotation angle that best aligns the image's dominant straight edges (e.g. the sides of a document, package, panel, or shelf) to the vertical axis, the horizontal axis, or whichever of the two is closest, then rotating the full-resolution image by that angle with an automatically expanded canvas so nothing is cropped.

How This Block Works¶

This block estimates the rotation angle from the image's dominant gradient orientation, then applies that rotation to the image. The block:

1. Converts the image to grayscale (color images are converted with BGR2GRAY)
2. Downscales a working copy so its largest dimension is at most internal_resolution pixels (default 1000, for speed; the detected angle is scale-invariant and is later applied to the full-resolution original)
3. Checks for a flat/low-texture image (very low pixel standard deviation) and, if found, skips processing and returns the image unchanged with angle = 0.0
4. Enhances local contrast with CLAHE and applies a light Gaussian blur to reduce noise sensitivity, producing a float32 image used only for scoring candidate angles
5. Computes Sobel gradients once and builds a magnitude-weighted histogram of gradient orientations (mod 180 degrees): gradients of the dominant lines point perpendicular to the lines themselves, so vertical lines concentrate the histogram around 0 degrees and horizontal lines around 90 degrees
6. Rejects indistinct histograms (no clearly dominant orientation) and returns the image unchanged
7. Refines the histogram's dominant mode with a doubled-angle weighted circular mean over nearby orientations for sub-degree precision, and normalizes the correction into (-90, 90] degrees for vertical/horizontal or (-45, 45] degrees for either
8. If the final angle is smaller in magnitude than skip_below_degrees, returns the image unchanged with angle = 0.0 (avoids unnecessary re-encoding/resampling for already-straight images). Likewise, if the final angle is larger in magnitude than max_correction_degrees, the image is returned unchanged with angle = 0.0 - a correction beyond the plausible skew range usually means the search aligned to a different dominant structure (e.g. a long object silhouette) rather than the lines of interest
9. Otherwise rotates the full-resolution original image by the final angle around its center, automatically expanding the output canvas so the entire rotated image is preserved (matching the canvas-expansion behavior of roboflow_core/image_preprocessing@v1's rotate task)

The block outputs both the deskewed image (with expanded canvas) and the applied rotation angle in degrees. Angles follow OpenCV's convention: positive angles rotate counter-clockwise.

Common Use Cases¶

• Document and Label Scanning: Straighten photographed documents, labels, or packaging before OCR or downstream detection, improving text and barcode reading accuracy
• Fixed-Camera Inspection: Correct small mounting-induced tilts in fixed-position industrial cameras so downstream measurement blocks (e.g. size or distance measurement) operate on axis-aligned imagery
• Conveyor and Shelf Alignment: Align images of conveyors, shelving, or panels whose edges should be vertical or horizontal, improving the reliability of downstream line/edge-based analysis
• Pre-processing for Detection Models: Straighten input images before running object detection or classification models that are sensitive to rotation

Connecting to Other Blocks¶

This block receives an image and produces a deskewed image plus the applied angle:

• Before detection or classification models to straighten images prior to inference, enabling more reliable model outputs on tilted source imagery
• Before measurement blocks (e.g. distance or size measurement) that assume an axis-aligned scene
• With downstream coordinate mapping - the angle output (together with the original image's dimensions) fully determines the applied transform, so detections made on the rotated image can be mapped back into the original image's coordinate space by inverting the rotation matrix built by build_auto_rotate_matrix

Type identifier¶

Use the following identifier in step "type" field: roboflow_core/auto_rotate_on_edges@v1to add the block as as step in your workflow.

Properties¶

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Available Connections¶

Input and Output Bindings¶

The available connections depend on its binding kinds. Check what binding kinds Auto Rotate on Edges in version v1 has.

{
    "name": "<your_step_name_here>",
    "type": "roboflow_core/auto_rotate_on_edges@v1",
    "image": "$inputs.image",
    "target_orientation": "vertical",
    "skip_below_degrees": 0.4,
    "max_correction_degrees": 45.0,
    "internal_resolution": 1000
}