https://github.com/opendronemap/cloudodm
A command line tool to process aerial imagery in the cloud. 🌩
https://github.com/opendronemap/cloudodm
cloud drones golang odm opendronemap photogrammetry processing
Last synced: 4 days ago
JSON representation
A command line tool to process aerial imagery in the cloud. 🌩
- Host: GitHub
- URL: https://github.com/opendronemap/cloudodm
- Owner: OpenDroneMap
- License: gpl-3.0
- Created: 2018-12-19T17:41:07.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-18T22:09:43.000Z (over 1 year ago)
- Last Synced: 2025-06-21T22:30:17.348Z (8 days ago)
- Topics: cloud, drones, golang, odm, opendronemap, photogrammetry, processing
- Language: Go
- Homepage:
- Size: 87.9 KB
- Stars: 69
- Watchers: 8
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CloudODM
A command line tool to process aerial imagery in the cloud via [NodeODM](https://github.com/OpenDroneMap/NodeODM)'s API.
## Getting Started
1. [Download the application](https://github.com/OpenDroneMap/CloudODM/releases) for Windows, Mac or Linux.
2. Extract the application in a folder of your choice (for example, `c:\odm`).
3. Open a command prompt and navigate to the folder (open the "Command Prompt" application, then `cd \odm`).
4. Run `odm c:\path\to\images --dsm`.
This command will process all the images in the directory `c:\path\to\images` and save the results (including an orthophoto, a point cloud, a 3D model and a digital surface model) to `c:\odm\output`. You can pass more options for processing by appending them at the end of the command. To see a list of options, simply issue:
`odm args`
See `odm --help` for more options.
## Using GCPs
To include a GCP for additional georeferencing accuracy, simply create a .txt file according to the [Ground Control Points format specification](https://docs.opendronemap.org/gcp/#gcp-file-format) and place it along with the images.
## Processing Node Management
By default CloudODM will randomly choose a default node from the list of [publicly available nodes](https://github.com/OpenDroneMap/CloudODM/blob/master/public_nodes.json). If you are running your own processing node via [NodeODM](https://github.com/OpenDroneMap/NodeODM) you can add a node by running the following:
`odm node add mynode http://address:port`
Then run odm as following:
`odm -n mynode c:\path\to\images`
If no node is specified, the `default` node is selected. To see a list of nodes you can run:
`odm node -v`
For more information run `odm node --help`.
If you are interested in adding your node to the list of [public nodes](https://github.com/OpenDroneMap/CloudODM/blob/master/public_nodes.json) please open an [issue](https://github.com/OpenDroneMap/CloudODM/issues).
## Running From Sources
```bash
go get -u github.com/OpenDroneMap/CloudODM
go run github.com/OpenDroneMap/CloudODM/cmd/odm --help
```
## Building From Sources
We use [Goreleaser](https://goreleaser.com/) to build and deploy CloudODM. See Goreleaser's [documentation](https://goreleaser.com/) for installation and deployment instructions. You should just need to install the `goreleaser` application and then run:
`goreleaser release --skip-publish --snapshot`
## Reporting Issues / Feature Requests / Feedback
Please open an [issue](https://github.com/OpenDroneMap/CloudODM).
## Support the Project
There are many ways to contribute back to the project:
- ⭐️ us on GitHub.
- Help us test the application.
- Spread the word about OpenDroneMap on social media.
- Help answer questions on the community [forum](https://community.opendronemap.org)
- Become a contributor!