NodeODM is a standard API specification for processing aerial images with engines such as ODM
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Piero Toffanin eb2ea1bbab
Merge pull request #198 from pierotofy/gltf
2 weeks ago
.github Update glob 4 weeks ago
contrib Update config-default.json 12 months ago
data Modified gitignore 7 years ago
docs Fix alignment file search 4 weeks ago
helpers Start on Windows, post-process logic 2 years ago
libs Automatically set --gltf when processing with WebODM 2 weeks ago
public Accept srt 2 weeks ago
scripts Add tests folder to bundle 2 years ago
services Added system-v service file 5 years ago
tests Add gltf test files 2 weeks ago
tmp Modified gitignore 7 years ago
.dockerignore Winbundle script/command 2 years ago
.gitignore Winbundle script/command 2 years ago
.jshintrc Support to load configuration from .json file 7 years ago
CONDUCT.md Create CONDUCT.md 3 years ago
CONTRIBUTING.md Create CONTRIBUTING.md 3 years ago
Dockerfile Update nodejs, production npm deps 1 year ago
Dockerfile.gpu Update Dockerfile.gpu 12 months ago
Dockerfile.gpu.intel Add run script that sets the render group and runs as user odm. 1 year ago
Gruntfile.js Test mode, bug fixing, automatic linting 6 years ago
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md 4 years ago
LICENSE Changed license to AGPL, added support for engine override 2 years ago
MIGRATION.md i10n changes 2 years ago
README.md Add precautions when building apptainer container 2 weeks ago
SOURCE Winbundle script/command 2 years ago
apptainer.def Rename singularity.def to apptainer.def 2 weeks ago
config-default.json Auto port selection 1 year ago
config.js Add --s3_ignore_ssl, better S3 error messages 6 months ago
index.js Fix alignment file search 4 weeks ago
package.json Automatically set --gltf when processing with WebODM 2 weeks ago
processes.json Support to load configuration from .json file 7 years ago
run_gpu_intel.sh Exclude the HOME env variable. 1 year ago

README.md

NodeODM

Build Status

NodeODM is a standard API specification for processing aerial images with engines such as ODM. The API is used by clients such as WebODM, CloudODM and PyODM. This repository contains a performant, production-ready reference implementation written in NodeJS.

image

Getting Started

We recommend that you setup NodeODM using Docker.

  • From the Docker Quickstart Terminal (Windows / OSX) or from the command line (Linux) type:
docker run -p 3000:3000 opendronemap/nodeodm
  • If you're on Windows/OSX, find the IP of your Docker machine by running this command from your Docker Quickstart Terminal:
docker-machine ip

Linux users can connect to 127.0.0.1.

  • Open a Web Browser to http://<yourDockerMachineIp>:3000
  • Load some images
  • Press "Start Task"
  • Go for a walk :)

If the computer running NodeODM is using an old or 32bit CPU, you need to compile OpenDroneMap from sources and setup NodeODM natively. You cannot use docker. Docker images work with CPUs with 64-bit extensions, MMX, SSE, SSE2, SSE3 and SSSE3 instruction set support or higher. Seeing a Illegal instruction error while processing images is an indication that your CPU is too old.

Running rootless

  • A rootless alternative to Docker is using Apptainer. In order to run NodeODM together with ClusterODM in rootless environments, for example on HPC, we need a rootless alternative to Docker, and that's where Apptainer comes in to play. From the Linux command line, cd into the NodeODM folder and run the following commands to host a NodeODM instance:
apptainer build --sandbox node/ apptainer.def
apptainer run --writable node/ 

apptainer build --sandbox requires you to have root permission to build this apptainer container. Make sure someone with root permission build this for you. You will need to build this apptainer container if you want to work with ClusterODM on the HPC. Check for ClusterODM for more instructions on using SLURM to set it up.

An apptainer.def file can be built directly from the dockerfile as needed:

pip3 install spython
spython recipe Dockerfile &> apptainer.def

API Docs

See the API documentation page.

Some minor breaking changes exist from version 1.x to 2.x of the API. See migration notes.

Run Tasks from the Command Line

You can use CloudODM to run tasks with NodeODM from the command line.

Using an External Hard Drive

If you want to store results on a separate drive, map the /var/www/data folder to the location of your drive:

docker run -p 3000:3000 -v /mnt/external_hd:/var/www/data opendronemap/nodeodm

This can be also used to access the computation results directly from the file system.

Using GPU Acceleration

Since ODM has support for GPU acceleration you can use another base image for GPU processing. You need to use the opendronemap/nodeodm:gpu docker image instead of opendronemap/nodeodm and you need to pass the --gpus all flag:

docker run -p 3000:3000 --gpus all opendronemap/nodeodm:gpu

The GPU implementation is CUDA-based, so will only work on NVIDIA GPUs.

If you have an NVIDIA card, you can test that docker is recognizing the GPU by running:

docker run --rm --gpus all nvidia/cuda:10.0-base nvidia-smi

If you see an output that looks like this:

Fri Jul 24 18:51:55 2020       
+-----------------------------------------------------------------------------+
| NVIDIA-SMI 440.82       Driver Version: 440.82       CUDA Version: 10.2     |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |

You're in good shape!

See https://github.com/NVIDIA/nvidia-docker and https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker for information on docker/NVIDIA setup.

Windows Bundle

NodeODM can run as a self-contained executable on Windows without the need for additional dependencies (except for ODM which needs to be installed separately). You can download the latest nodeodm-windows-x64.zip bundle from the releases page. Extract the contents in a folder and run:

nodeodm.exe --odm_path c:\path\to\ODM

Run it Natively

If you are already running ODM on Ubuntu natively you can follow these steps:

  1. Install Entwine: https://entwine.io/quickstart.html#installation

  2. Install node.js, npm dependencies, 7zip and unzip:

sudo curl --silent --location https://deb.nodesource.com/setup_6.x | sudo bash -
sudo apt-get install -y nodejs python-gdal p7zip-full unzip
git clone https://github.com/OpenDroneMap/NodeODM
cd NodeODM
npm install
  1. Start NodeODM
node index.js

You may need to specify your ODM project path to start the server:

node index.js --odm_path /home/username/OpenDroneMap

If you want to start node ODM on a different port you can do the following:

node index.js --port 8000 --odm_path /home/username/OpenDroneMap

For other command line options you can run:

node index.js --help

You can also specify configuration values via a JSON file:

node index.js --config config.default.json

Command line arguments always take precedence over the configuration file.

Run it using PM2

The app can also be run as a background process using the pm2 process manager, which can also assist you with system startup scripts and process monitoring.

To install pm2, run (using sudo if required):

npm install pm2 -g

The app can then be started using

pm2 start processes.json

To have pm2 started on OS startup run

pm2 save
pm2 startup

and then run the command as per the instructions that prints out. If that command errors then you may have to specify the system (note that systemd should be used on CentOS 7). Note that if the process is not running as root (recommended) you will need to change /etc/init.d/pm2-init.sh to set export PM2_HOME="/path/to/user/home/.pm2", as per these instructions

You can monitor the process using pm2 status.

Test Mode

If you want to make a contribution, but don't want to setup OpenDroneMap, or perhaps you are working on a Windows machine, or if you want to run automated tests, you can turn test mode on:

node index.js --test

While in test mode all calls to OpenDroneMap's code will be simulated (see the /tests directory for the mock data that is returned).

Test Images

You can find some test drone images here.

What if I need more functionality?

NodeODM is meant to be a lightweight API. If you are looking for a more comprehensive solution to drone mapping, check out WebODM, which uses NodeODM for processing.

Contributing

Make a pull request for small contributions. For big contributions, please open a discussion first. Please use ES6 syntax while writing new Javascript code so that we can keep the code base uniform.

Roadmap

See the list of wanted features.