SIFT¶
Class: SIFTBlockV1
Source: inference.core.workflows.core_steps.classical_cv.sift.v1.SIFTBlockV1
Detect and describe distinctive visual features in images using SIFT (Scale-Invariant Feature Transform), extracting keypoints (interest points) and computing 128-dimensional feature descriptors that are invariant to scale, rotation, and lighting conditions, enabling feature-based image matching, object recognition, and image similarity detection workflows.
How This Block Works¶
This block detects distinctive visual features in an image using SIFT and computes feature descriptors for each detected keypoint. The block:
- Receives an input image to analyze for feature detection
- Converts the image to grayscale (SIFT operates on grayscale images for efficiency and robustness)
- Creates a SIFT detector using OpenCV's SIFT implementation
- Detects keypoints and computes descriptors simultaneously using detectAndCompute:
- Keypoint Detection: Identifies distinctive interest points (keypoints) in the image that are stable across different viewing conditions
- Keypoints are detected at multiple scales (pyramid of scale-space images) to handle scale variations
- Keypoints are detected with orientation assignment to handle rotation variations
- Each keypoint has properties: position (x, y coordinates), size (scale at which it was detected), angle (orientation), response (strength), octave (scale level), and class_id
- Descriptor Computation: Computes 128-dimensional feature descriptors for each keypoint that describe the local image region around the keypoint
- Descriptors encode gradient information in the local region, making them distinctive and robust to lighting changes
- Descriptors are normalized to be partially invariant to illumination changes
- Draws keypoints on the original image for visualization:
- Uses OpenCV's drawKeypoints to overlay keypoint markers on the image
- Visualizes keypoint locations, orientations, and scales
- Creates a visual representation showing where features were detected
- Converts keypoints to dictionary format:
- Extracts keypoint properties (position, size, angle, response, octave, class_id) into dictionaries
- Makes keypoint data accessible for downstream processing and analysis
- Returns the image with keypoints drawn, the keypoints data (as dictionaries), and the descriptors (as numpy array)
SIFT features are scale-invariant (work at different zoom levels), rotation-invariant (handle rotated images), and partially lighting-invariant (robust to illumination changes). This makes them highly effective for matching the same object or scene across different images taken from different viewpoints, distances, angles, or lighting conditions. The 128-dimensional descriptors provide rich information about local image regions, enabling robust feature matching and comparison.
Common Use Cases¶
- Feature-Based Image Matching: Detect features for matching objects or scenes across different images (e.g., match objects in multiple images, find corresponding features across viewpoints, identify matching regions in image pairs), enabling feature-based matching workflows
- Object Recognition: Use SIFT features for object recognition and identification (e.g., recognize objects using feature matching, identify objects by their distinctive features, match object features for classification), enabling feature-based object recognition workflows
- Image Similarity Detection: Detect similar images by comparing SIFT features (e.g., find similar images in databases, detect duplicate images, identify matching scenes), enabling image similarity workflows
- Feature Extraction for Analysis: Extract distinctive features from images for further analysis (e.g., extract features for processing, analyze image characteristics, identify interesting regions), enabling feature extraction workflows
- Visual Localization: Use SIFT features for visual localization and mapping (e.g., localize objects in scenes, track features across frames, map feature correspondences), enabling visual localization workflows
- Image Registration: Align images using SIFT feature correspondences (e.g., register images for stitching, align images from different viewpoints, match images for alignment), enabling image registration workflows
Connecting to Other Blocks¶
This block receives an image and produces SIFT keypoints and descriptors:
- After image input blocks to extract SIFT features from input images (e.g., detect features in camera feeds, extract features from image inputs, analyze features in images), enabling SIFT feature extraction workflows
- After preprocessing blocks to extract features from preprocessed images (e.g., detect features after filtering, extract features from enhanced images, analyze features after preprocessing), enabling preprocessed feature extraction workflows
- Before SIFT Comparison blocks to provide SIFT descriptors for image comparison (e.g., provide descriptors for matching, prepare features for comparison, supply descriptors for similarity detection), enabling SIFT-based image comparison workflows
- Before filtering or logic blocks that use feature counts or properties for decision-making (e.g., filter based on feature count, make decisions based on detected features, apply logic based on feature properties), enabling feature-based conditional workflows
- Before data storage blocks to store feature data (e.g., store keypoints and descriptors, save feature information, record feature data for analysis), enabling feature data storage workflows
- Before visualization blocks to display detected features (e.g., visualize keypoints, display feature locations, show feature analysis results), enabling feature visualization workflows
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/sift@v1to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | ❌ |
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 SIFT in version v1.
- inputs:
Roboflow Visual Search,Image Preprocessing,Absolute Static Crop,Polygon Zone Visualization,Morphological Transformation,Color Visualization,Trace Visualization,SIFT Comparison,Stability AI Outpainting,Reference Path Visualization,Morphological Transformation,Camera Calibration,Dot Visualization,Stability AI Inpainting,Halo Visualization,Triangle Visualization,Crop Visualization,Image Convert Grayscale,Classification Label Visualization,Model Comparison Visualization,Camera Focus,Bounding Box Visualization,Image Contours,Image Slicer,Camera Focus,Heatmap Visualization,Stitch Images,Keypoint Visualization,Polygon Visualization,Halo Visualization,Dynamic Crop,Stability AI Image Generation,Relative Static Crop,Contrast Equalization,Perspective Correction,Image Slicer,Polygon Visualization,QR Code Generator,Roboflow Visual Search Classifier,Circle Visualization,Contrast Enhancement,Grid Visualization,Text Display,Depth Estimation,Ellipse Visualization,Image Threshold,Icon Visualization,Blur Visualization,Pixelate Visualization,Line Counter Visualization,Corner Visualization,Image Blur,Label Visualization,SIFT,Background Subtraction,Background Color Visualization,Mask Visualization - outputs:
Absolute Static Crop,VLM As Classifier,Qwen-VL,Gaze Detection,Triangle Visualization,EasyOCR,Model Comparison Visualization,OC-SORT Tracker,YOLO-World Model,Track Class Lock,Llama 3.2 Vision,Anthropic Claude,Heatmap Visualization,Stitch Images,Keypoint Visualization,Detections Stabilizer,Google Gemini,Dominant Color,MoonshotAI Kimi,GLM-OCR,Instance Segmentation Model,VLM As Detector,SAM2 Video Tracker,Multi-Label Classification Model,Twilio SMS/MMS Notification,Ellipse Visualization,Single-Label Classification Model,SmolVLM2,Keypoint Detection Model,Pixelate Visualization,Corner Visualization,Buffer,Template Matching,Llama 3.2 Vision,Qwen2.5-VL,Qwen 3.5 API,LMM,Semantic Segmentation Model,Roboflow Visual Search,Morphological Transformation,Color Visualization,Roboflow Dataset Upload,Morphological Transformation,Camera Calibration,Motion Detection,Google Vision OCR,Clip Comparison,Bounding Box Visualization,OpenAI,Halo Visualization,SAM3 Video Tracker,Object Detection Model,Contrast Equalization,Instance Segmentation Model,Multi-Label Classification Model,Image Threshold,Blur Visualization,Line Counter Visualization,Google Gemini,Single-Label Classification Model,Background Subtraction,Object Detection Model,Instance Segmentation Model,SAM 3,QR Code Detection,Polygon Zone Visualization,Google Gemma API,Keypoint Detection Model,Image Stack,Reference Path Visualization,SAM 3 Interactive,Qwen3-VL,Stability AI Inpainting,Multi-Label Classification Model,Perception Encoder Embedding Model,Crop Visualization,Anthropic Claude,Image Convert Grayscale,Camera Focus,Image Slicer,Florence-2 Model,Polygon Visualization,MoonshotAI Kimi,Dynamic Crop,Qwen 3.6 API,Event Writer,Perspective Correction,Segment Anything 2 Model,Polygon Visualization,Clip Comparison,OCR Model,Roboflow Visual Search Classifier,Circle Visualization,CogVLM,Contrast Enhancement,Mask Edge Snap,Barcode Detection,Time in Zone,LMM For Classification,Qwen3.5-VL,Florence-2 Model,OpenAI,SORT Tracker,ByteTrack Tracker,Label Visualization,Image Blur,Seg Preview,Object Detection Model,Anthropic Claude,Pixel Color Count,Roboflow Vision Events,Image Preprocessing,Trace Visualization,Email Notification,SIFT Comparison,Stability AI Outpainting,Keypoint Detection Model,Dot Visualization,Halo Visualization,SAM 3,Classification Label Visualization,Mask Visualization,Image Contours,Camera Focus,Single-Label Classification Model,OpenRouter,Moondream2,Stability AI Image Generation,VLM As Detector,Google Gemma,CLIP Embedding Model,Relative Static Crop,Roboflow Dataset Upload,OpenAI,Image Slicer,Google Gemini,BoT-SORT Tracker,Byte Tracker,SAM 3,Detections Stitch,Semantic Segmentation Model,Text Display,Qwen3.5,Depth Estimation,Icon Visualization,OpenAI,GeoTag Detection,SIFT Comparison,SIFT,Instance Segmentation Model,Background Color Visualization,VLM As Classifier
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
SIFT in version v1 has.
Bindings
-
input
image(image): Input image to analyze for SIFT feature detection. The image will be converted to grayscale internally for SIFT processing. SIFT works best on images with good texture and detail - images with rich visual content (edges, corners, patterns) produce more keypoints than uniform or smooth images. Each detected keypoint will have a 128-dimensional descriptor computed. The output includes an image with keypoints drawn for visualization, keypoint data (position, size, angle, response, octave), and descriptor arrays for matching and comparison. SIFT features are scale and rotation invariant, making them effective for matching across different viewpoints and conditions..
-
output
image(image): Image in workflows.keypoints(image_keypoints): Image keypoints detected by classical Computer Vision method.descriptors(numpy_array): Numpy array.
Example JSON definition of step SIFT in version v1
{
"name": "<your_step_name_here>",
"type": "roboflow_core/sift@v1",
"image": "$inputs.image"
}