Skip to content

alicevision/MeshroomGeolocation

Repository files navigation

Meshroom Geolocation

Meshroom Geoloc

Meshroom is a 3D Reconstruction Software using Photogrammetry.

Meshroom Geoloc is a group of nodes using the GPS data of the pictures to geolocate and replace the object in its geographical context. From the GPS data of your camera you can create and export 2D Map, elevation and 3D map.

{Worldwide} The 2D map uses Open Street Map and Worldwide data.

{Worldwide} The elevation map comes from NASA Data with a resolution of 30 meters.

{France} The 3D map comes from IGN (The french geographical institute) with a resolution of 30 centimeters for the Lidar HD program.

Install

It is a module for Meshroom.

You can download pre-compiled binaries for the latest release.

Get the source code and install runtime requirements:

git clone --recursive https://github.com/alicevision/MeshroomGeolocation.git
cd MeshroomGeolocation
pip install -r requirements.txt

Environment variables

Custom nodes can be added to Meshroom by setting the environment variable MESHROOM_NODES_PATH.

Here MESHROOM_NODES_PATH = path/to/MeshroomGeolocation.

All the nodes will be in Geolocation category in Meshroom UI.

Custom pipelines can be added to Meshroom by setting the environment variable MESHROOM_PIPELINE_TEMPLATES_PATH.

Here MESHROOM_PIPELINE_TEMPLATES_PATH = path/to/MeshroomGeolocation/pipelines.

All the pipelines will be available in Pipelines category in Meshroom UI. You can learn more about them here.

Plugin System

Since recently a plugin system has been added to Meshroom.

You can add your plugin from the local cloned folder or from the URL. Just by going in File > Advanced > Install Plugin...

If you are using the local installation you'll need a init.py file and a meshroomPlugin.json file. It is really important to mention the "pluginName" and the "nodesFolder" to be sure everything will be found.

Nota Bene

LIDAR Data are from the IGN LIDAR HD project and it is still in progress. The CSV file with all the links of the tiles is unstable for now but you can update it by yourself. You can download the archive here and then download the "TA_yyyy_mm_dd.zip" and convert the "TA_diff_pkk_lidarhd.dbf" in CSV file (through Excel for example) in the folder external_files of the project.

Features

All nodes created by our team enable the following features :

  • GetGPSData : It permits to get average GPS data of the dataset. It's useful for all the other features.
  • Map2D : With this node, you can obtain a 2D map based on Open Street Map data. It has several layers of information and a minimal radius precision of 30m.
  • TopographyMap3D : As we have 2D, this node is good for a worldwide 3D map. It is based on data from NASA.
  • Map3D : With this node, a 3D map can be generated, based on IGN data so it's only available for France for a 30 centimeters resolution. Data are downloaded but needs a treatment (Mesh3D).
  • Merge : A folder that contains .copc.laz files are merged into a single file to then generate a mesh.
  • Mesh3D : After treatment, lidar file generates a 3D mesh.
  • North : As north is not indicated on the maps generated, this node places it as a cone.
  • WeatherHDRI : As sometimes weather information is needed, HDRI of the current weather of the dataset is downloaded.
  • Sun : The position of the sun according when the dataset was taken is calculated with this node and represented as a big yellow sphere.

Pipelines

Some pipelines are already existing to make the use of them easier. Here are screenshots of them :

  • Named Generate Sun, this pipeline can calculate the position of the sun and create a sphere representing it.

Sun pipeline

  • Generate North permits to know where the north is.

North pipeline

  • Generate Map is all about getting the 2d map you want, with the layers desired.

Map 2d pipeline

  • Generate Weather H D R I is also a simple node with an HDRI downloaded for the weather during the dataset.

Weather pipeline

  • Generate_3D Map is a longer pipeline to obtain a detailed 3d map (only available in France for now).

Map 3d pipeline

  • Generate Elevation Map is available almost everywhere, based on SRTM data and generate a 3d mesh.

Elevation map pipeline

Feedback

Do not hesitate to contact us or to give us some feedback.

About

Geolocation nodes for Meshroom

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published