• Upload multiple images.
• Process images using OpenDroneMap (ODM) via Docker.
• View and download processed results:
  • All results as a ZIP archive.
• Automatically clean up processed files after download.

• Python 3.9 or later.
• Flask and required Python packages (see requirements.txt).
• Docker and Docker Compose installed and configured.
• ODM Docker image available (e.g., opendronemap/odm).

git clone <repository-url>
cd <repository-name>

Install dependencies:

pip install -r requirements.txt

Ensure the uploads directory exists:

mkdir -p app/uploads

On the parent dir create a .env file setting LOCAL_PROJECT_DIR to the absolute path to this repo's directory.

i.e

LOCAL_PROJECT_DIR=/Users/emar/university/senior/Classify3D

OPTOINAL If you have issues with the port inuse you can change it by adding a PORT env var like so:

PORT=5500

If there isn't a PORT env var build will just default to 5000

This is needed for docker to be able to find the local project directory in /app/odm_handler.py

Run the included setup script:

./run.sh

Open your browser and go to:

http://localhost:5000

Note: unless you change it on your env file

1. Upload Images:

   • Navigate to /upload and select your images.

2. Process Images:

   • After uploading, the app processes the images using OpenDroneMap (ODM). Just wait for the page to load, and if you want to check the progress, open docker and go to the logs for the new ODM container made. Do not exit out of the page while it is running. Once ODM is done, you will automatically be taken to a results page.

3. Results:

   • Once you have been taken to the results page, just click on download as a zip, and just wait for it to download. This will effectively clear out the directory of the docker container so that you can run another task safely in the future, and also download all of the files including the pointcloud and textures.

.
├── app/
│   ├── static/
│   │   └── styles.css
│   ├── templates/
│   │   ├── index.html
│   │   ├── upload.html
│   │   ├── processing.html
│   │   └── results.html
│   ├── uploads/
│   ├── __init__.py
│   ├── routes.py
│   └── odm_handler.py
├── Dockerfile
├── docker-compose.yml
├── setup_and_run.sh
├── requirements.txt
└── README.md

• Ensure Docker is running and configured properly.
• Adjust MAX_CONTENT_LENGTH in __init__.py for larger uploads.
• Use FLASK_ENV=development for debugging during development.

• Permission Errors:

  • Ensure uploads directory has the correct permissions.

• Docker Issues:

  • Verify Docker is installed and running.
  • Confirm Docker Compose is configured.

• ODM Errors:

  • Check logs for specific errors during processing.

This project is licensed under the MIT License. See the LICENSE file for details.

---