Skip to content

Examples showcase

The repository ships two levels of Python examples: lightweight scripts under pyexamples/, and optional showcase workflows under examples/ that pull in larger third-party stacks (Torch, vismatch, Rerun).

pyexamples/ (fewer dependencies)

  • Classic OpenCV features (SIFT / AKAZE) and BFMatcher, wired to pyTheia two-view estimation and incremental / global / hybrid reconstruction (e.g. fountain scene scripts).
  • Utilities: NeRFStudio / SDFStudio export, MVS / Open3D stubs, video frame extraction.
  • Typical extras: opencv-python, kornia (see pyexamples/requirements.txt).

Use these when you want a quick sanity check without installing Torch-based matchers.

examples/ (showcase)

  • vismatch + SfM — Strecha scene root (images/ + K.txt, gt_dense_cameras/*.camera), Sim3 alignment, average camera-center error vs GT, optional Rerun, PLY/recon exports. Sources: examples/vismatch_sfm/ (vismatch, optional Rerun).
  • Gaussian splatting export — export to Nerfstudio transforms.json and notes for Splatfacto / other 3DGS trainers (training happens in external projects).

Install optional dependencies:

pip install ".[examples]"

See examples/README.md for setup, licenses (vismatch wraps many models), and CUDA notes.

  • Building — compile / install pyTheia
  • Python API overview — imports and stubs
  • Matching — FeatureCorrespondence, ImagePairMatch, pairing helpers
  • IO — WriteNerfStudio, WriteColmapFiles, PLY