WebODM Demo

WebODM Demo is a project intended to demonstrate the capabilities of WebODM for learning and research purposes.

Requirements

• Docker
• WebODM
• NodeODM
• PyODM library
• requests library

Usuage

For Scripts with the prefix WebODM, run WebODM using Docker

Note that WebODM should be available on localhost:8000

For Scripts with the prefix NodeODM, run NodeODM using Docker

Note that NodeODM should be available on localhost:3000

WebODM_main.py

CLI: quickstart.py <args> <project_name> <options_file_name> <image_files_dir>

Additional arguments:

• -opd / --options_dir <string>: Directory path to folder containing options JSON file. If not provided, assumed to be in root directory.
• -od / --output_dir <string>: Directory path to folder where output files will be placed. If not provided, output will be placed in root directory.
• a / --asset <string>: What asset should be downloaded. Default: 'all.zip'
• v / --video <string>: Name of the video file to be uploaded instead of images

Additional notes:

• username and password should be placed in .env file
• Minimum of 5 images must be provided
• Images must be of *.jpg file type
• If processing with GCP, the GCP data must be included IN the same directory as the images. The data must be stored as a *.txt file.
• If processing with SRT, the SRT file must have the SAME name as the video file uploaded and must be in the same directory
• Directory named after the project_name will be created either in the root directory or in the specified output directory, where the output will be stored.

WebODM_delete_project.py

CLI: delete_project.py <name of project>

Additional notes:

• Deletes all projects of a given name, regardless of different IDs, letting one perform mass deletions.

WebODM_processing_nodes.py

CLI: processing_nodes.py <arguments>

Additional arguments:

• hn / --hostname <string>: Hostname of processing node
• p / --port <integer>: Port of processing node
• id / --identification <integer>: ID of processing node
• d / --delete: Set delete to true

Additional notes

• To add a processing node, simply provide the hostname and the port as arguments
• To delete a processing node, provide either the hostname and the port as arguments or provide only the id
• When deleting, id is given priority over hostname and port
• If only hostname and port are provided, all processing nodes with given specifications will be deleted, regardless of differing ids

NodeODM_main.py

CLI: NodeODM_main.py <path to directory containing images>

Additional notes

• Still under development

more pending

Adding Additional Processing Nodes

• Set up Environment (if on Windows)
• Start up NodeODM on new machine
• Add Processing Node with WebODM API or GUI

Adding Distributed Computing

Follow steps provided here and here

Additional Features of WebODM

• SSL
• IPv6
• Run (Docker Version) as Linux Service
• Multispectral image processing

Additional Assets

• Hugin can be used to stitch together Orthophotos. Supports Python Scripts
• Extract stills from video file (I believe WebODM already has the feature)

Datasets

• ODM
• ArcGIS Reality
• UAV-datasets

Documentation

• WebODM Documentation
• ODM Documentation
• NodeODM Documentation
• PyODM Documentation
• ClusterODM Documentation
• Multispectral Data Binner