NodeODM is a standard API specification for processing aerial images with engines such as ODM
 
 
 
 
 
 
Go to file
Piero Toffanin 909365aafd Added system-v service file 2017-09-15 07:14:38 -04:00
data Modified gitignore 2016-07-05 13:07:47 -05:00
docs Updated docs 2017-04-08 20:21:28 -04:00
helpers Upgraded code to be compatible with latest OpenDroneMap changes, added preliminary support for enum options 2017-03-29 14:50:57 -04:00
libs Added tree-kill 2017-09-15 05:22:10 -04:00
patches gdal2tiles.py patch, updated readme, dockerfile 2016-11-08 14:43:10 -05:00
public Fix: Task Serialization 2017-04-12 20:31:57 -06:00
screenshots GPC files support, cleanups, options support, testing 2016-07-30 13:30:56 -05:00
scripts Added alpha transparency in DTM/DSM derivatives 2017-06-30 16:00:49 -04:00
services Added system-v service file 2017-09-15 07:14:38 -04:00
tests Added DEM derivatives generation 2017-06-30 15:17:44 -04:00
tmp Modified gitignore 2016-07-05 13:07:47 -05:00
.dockerignore ZIP Uploads 2017-04-07 22:05:20 -06:00
.gitignore Back up merge 2017-04-07 22:09:05 -06:00
.jshintrc Support to load configuration from .json file 2016-08-02 11:07:54 -05:00
.travis.yml Removed unused language declaration in travis.yml 2017-03-30 13:55:30 -04:00
Dockerfile Update Dockerfile 2017-04-26 20:17:52 -04:00
Gruntfile.js Test mode, bug fixing, automatic linting 2016-09-25 18:35:44 -04:00
LICENSE Initial commit 2016-07-02 14:20:17 -05:00
README.md README: Run ldconfig with sudo (native install) 2017-06-26 10:05:56 +05:30
config-default.json Added DEM derivatives generation 2017-06-30 15:17:44 -04:00
config.js Added DEM derivatives generation 2017-06-30 15:17:44 -04:00
index.js Update index.js 2017-04-12 08:53:55 -04:00
package.json Added tree-kill 2017-09-15 05:22:10 -04:00
processes.json Support to load configuration from .json file 2016-08-02 11:07:54 -05:00

README.md

Node-OpenDroneMap

Build Status

node-OpenDroneMap is a Node.js App and REST API to access OpenDroneMap. It exposes an API which is used by WebODM.

Alt text

Getting Started

For a quick taste of the application, we have setup a test environment at http://nodeodm.masseranolabs.com. Please note that this is not a production environment, and that processing on this server will be slow (you are sharing the server's resources with everyone else in the world).

If you want to do your own imagery processing, we recommend that you setup your own instance via Docker.

  • From the Docker Quickstart Terminal (Windows / OSX) or from the command line (Linux) type:
docker run -p 3000:3000 opendronemap/node-opendronemap
  • 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 :)

API Docs

See the API documentation page.

Run it Natively

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

  1. Install PotreeConverter and LASzip dependency
apt-get install -y libboost-dev libboost-program-options-dev

mkdir /staging
git clone https://github.com/pierotofy/LAStools /staging/LAStools
cd LAStools/LASzip
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
sudo make && sudo make install
sudo ldconfig

git clone https://github.com/pierotofy/PotreeConverter /staging/PotreeConverter
cd /staging/PotreeConverter
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DLASZIP_INCLUDE_DIRS=/staging/LAStools/LASzip/dll -DLASZIP_LIBRARY=/staging/LAStools/LASzip/build/src/liblaszip.so ..
sudo make && sudo make install
  1. Install gdal2tiles.py script, node.js and npm dependencies
sudo curl --silent --location https://deb.nodesource.com/setup_6.x | sudo bash -
sudo apt-get install -y nodejs python-gdal
git clone https://github.com/pierotofy/node-OpenDroneMap
cd node-OpenDroneMap
npm install
  1. Start node-OpenDroneMap
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?

node-OpenDroneMap is meant to be a lightweight API. If you are looking for a more comprehensive solution to drone mapping, check out WebODM, which uses node-OpenDroneMap 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

  • Command line options for OpenDroneMap
  • GPC List support
  • Video support when the SLAM module becomes available
  • Continuous Integration Setup
  • Documentation
  • Unit Testing