OpenDroneMap-NodeODM/README.md

1.8 KiB

Open Source Drone Aerial Imagery Processing

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

Alt text

Getting Started

The quickest way is to use 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

Test Images

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

Contributing

Make a pull request for small contributions. For big contributions, please open a discussion first.

Roadmap

  • Command line options for OpenDroneMap (in progress)
  • Cluster tasks distribution to multiple servers
  • Documentation
  • Unit Testing

API Docs

Coming soon.