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.
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
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.
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.
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.
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.
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.
- Generate North permits to know where the north is.
- Generate Map is all about getting the 2d map you want, with the layers desired.
- Generate Weather H D R I is also a simple node with an HDRI downloaded for the weather during the dataset.
- Generate_3D Map is a longer pipeline to obtain a detailed 3d map (only available in France for now).
- Generate Elevation Map is available almost everywhere, based on SRTM data and generate a 3d mesh.
Do not hesitate to contact us or to give us some feedback.