Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add hloc_glomap example and update manifest #8352

Merged
merged 2 commits into from
Dec 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions examples/manifest.toml
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,7 @@ examples = [
"differentiable_blocks_world",
"stereo_vision_slam",
"glomap",
"hloc_glomap",
"instant_splat",
"signed_distance_fields",
"raw_mesh",
Expand Down
24 changes: 24 additions & 0 deletions examples/python/hloc_glomap/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
<!--[metadata]
title = "Hierarchical-Localization and GLOMAP"
tags = ["2D", "3D", "COLMAP", "Pinhole camera", "Time series", "GLOMAP", ]
source = "https://github.com/pablovela5620/hloc-glomap"
thumbnail = "https://static.rerun.io/thumbnail/6a5b887927834a6ea3db9474ce1e843ecd28b3cf/480w.png"
thumbnail_dimensions = [480, 300]
-->

https://vimeo.com/1037241347?autoplay=1&loop=1&autopause=0&background=1&muted=1&ratio=2802:1790
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you wrap that in whatever html video tag is necessary for the video to be embedded in the readme please? (assuming that's even possible, but surely...)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this so that it will render in the github? as I understand it, this is how Ive been doing it thus far for all other examples so that they would render on rerun.io example site.

For example
https://github.com/rerun-io/rerun/tree/main/examples/python/depth_compare
https://rerun.io/examples/generative-vision/depth_compare

I don't totally understand whats going on in the background on the rerun site, but from what I've tried before, if I put it in an iframe tag it still won't render on github

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You know better than me 👍


## Background

This examples allows use of the Hierarchical-Localization (hloc) repo and GLOMAP for easy and fast Structure-from-Motion with deep learned features and matchers. The Hierarchical-Localization repo (hloc for short) is a modular toolbox for state-of-the-art 6-DoF visual localization. It implements Hierarchical Localization, leveraging image retrieval and feature matching, and is fast, accurate, and scalable. This codebase combines and makes easily accessible years of research on image matching and Structure-from-Motion. GLOMAP is a general purpose global structure-from-motion pipeline for image-based sparse reconstruction. As compared to COLMAP it provides a much more efficient and scalable reconstruction process, typically 1-2 orders of magnitude faster, with on-par or superior reconstruction quality.

## Run the code

This is an external example. Check the [repository](https://github.com/pablovela5620/hloc-glomap) for more information on how to run the code.

TLDR: make sure you have the [Pixi package manager](https://pixi.sh/latest/#installation) installed and run
```
git clone https://github.com/pablovela5620/hloc-glomap.git
cd hloc-glomap
pixi run app
```
Loading