NodeODM is a standard API specification for processing aerial images with engines such as ODM
 
 
 
 
 
 
Go to file
Dennis Baldwin 27411b36f6 Adding node server command line options 2016-08-01 11:04:49 -05:00
data
helpers
libs
public
screenshots
tmp
.gitignore
Dockerfile
LICENSE
README.md
config.js
index.js
package.json

README.md

Open Source Drone Aerial Imagery Processing

node-OpenDroneMap is a Node.js App and REST API to access OpenDroneMap

http://nodeodm.masseranolabs.com

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:
git clone https://github.com/pierotofy/node-OpenDroneMap
cd node-OpenDroneMap
docker build -t nodeodm:latest .
docker run -p 3000:3000 nodeodm:latest
  • 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 :)

Run it Natively

If you are already running OpenDroneMap on Ubuntu natively, you can simply type:

sudo curl --silent --location https://deb.nodesource.com/setup_6.x | sudo bash -
sudo apt-get install -y nodejs
git clone https://github.com/pierotofy/node-OpenDroneMap
cd node-OpenDroneMap
npm install
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

Test Images

You can find some test drone images from OpenDroneMap's Test Data Folder.

Contributing

Make a pull request to the dev branch 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
  • Autoremove Abandoned Tasks
  • Continuous Integration Setup
  • Documentation
  • Unit Testing

API Docs

Coming soon.