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(seepyexamples/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). - Nerfstudio / 3DGS export — use
pyexamples/nerfstudio_export_reconstruction.pyto writetransforms.jsonfrom apt.sfm.Reconstruction; train Splatfacto or other 3D Gaussian splatting pipelines in external projects (e.g. Nerfstudio).
Install optional dependencies:
See examples/README.md for setup, licenses (vismatch wraps many models), and CUDA notes.
Related manual chapters¶
- Building — compile / install pyTheia
- Python API overview — imports and stubs
- Matching —
FeatureCorrespondence,ImagePairMatch, pairing helpers - IO —
WriteNerfStudio,WriteColmapFiles, PLY