Skip to main content

Documentation Index

Fetch the complete documentation index at: https://imcui.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Matching Algorithms

Image Matching WebUI supports 20+ state-of-the-art algorithms through the vismatch library. Each algorithm is designed for specific use cases and image types.
Recommendation: Start with superpoint-lightglue for general-purpose matching. It’s fast, accurate, and works well on most image types.

Algorithm Categories

Best for: Feature matching, object detection, real-time applications
AlgorithmSpeedAccuracyBest For
superpoint-lightglueFastHighGeneral purpose
sift-lightglueMediumVery HighHigh-quality features
disk-lightglueFastHighEfficient matching
omniglueMediumHighCross-domain images
alikedVery FastMediumReal-time applications

🌊 Dense Matching

Best for: Depth estimation, 3D reconstruction, photogrammetry
AlgorithmSpeedAccuracyMemory
romaSlowVery HighHigh
tiny-romaMediumHighMedium
loftrMediumVery HighHigh
xoftrSlowVery HighVery High
dusterFastMediumLow

⚑ Semi-Dense

Best for: Balance between speed and accuracy
AlgorithmSpeedAccuracyUse Case
aspanformerSlowVery HighLarge baselines
matchformerMediumHighGeneral matching
eloftrFastHighReal-time matching

Algorithm Selection Guide

Speed Priority

aliked or disk-lightglue for fastest results

Accuracy Priority

roma or superpoint-lightglue for best quality

Low Memory

duster or aliked for limited GPU memory

General Purpose

superpoint-lightglue works well on most tasks

SuperPoint + LightGlue

Best for: General-purpose image matching Select superpoint-lightglue from the matcher dropdown in the web interface. Advantages:
  • Fast and accurate
  • Works with various image types
  • Robust to scale and rotation changes

LoFTR

Best for: Wide-baseline matching, texture-poor images Select loftr from the matcher dropdown in the web interface. Advantages:
  • Excellent for large viewpoint changes
  • Works well with low-texture images
  • Dense matching for comprehensive coverage

ROMA

Best for: High-precision geometric tasks Select roma from the matcher dropdown in the web interface. Advantages:
  • Highest accuracy
  • Good for 3D reconstruction
  • Robust to extreme viewpoint changes

Performance Tips

Speed Optimization

  1. Choose faster algorithms: aliked, disk-lightglue
  2. Reduce image resolution: Set lower resize values
  3. Limit keypoints: Decrease max_keypoints
  4. Use CPU for testing: Fallback to CPU when GPU unavailable

Accuracy Optimization

  1. Use state-of-the-art: roma, superpoint-lightglue
  2. Enable RANSAC: Set high confidence levels
  3. Higher thresholds: Adjust setting_threshold
  4. Preprocessing: Grayscale conversion often improves results

Memory Management

  1. Use semi-dense algorithms: loftr, aspanformer
  2. Reduce batch size: Process images sequentially
  3. Lower resolution: Resize images before matching

Algorithm Comparison

Sparse
Fast, memory-efficient, good for feature-based tasks
Dense
Comprehensive matching, high accuracy, memory-intensive
Semi-Dense
Balanced speed and accuracy, good for most applications
Sparse: Feature matching, object detection, real-time
Dense: 3D reconstruction, depth estimation, photogrammetry
Semi-Dense: General matching, medical imaging, document processing

Getting Available Algorithms

List all available algorithms via Python:
from imcui.ui import get_available_model_names
print(get_available_model_names())
New algorithms: All matching algorithms are maintained in the vismatch repository. New algorithms become automatically available when added to the collection.