DRONE DATA UPLOAD

This is the codebase for the upload page for drone images to create orthomosaics. The tool aims at attaching metadata to images and sending them to HPC for processing. It is meant specifically for NC State. The targeted deployment is at different research stations.

Tech Stack

• React.js: Frontend app
• Python: API created using Flask
• Material UI: UI library
• MongoDB: NoSQL database

Code Structure

drone-pilot-upload
├── backend  #contains the API code
├── frontend
│   ├── public
│   │   └── images # shared images like favicon
│   └── src # contains the one-page react code
└── ortho_processing # contains codebase to orchestrate and manage HPC-based orthomosaic processing

Production Deployment (on servers)

These steps are specific to stand-alone servers using ubuntu 20.04+. These should be used by teams deploying this tool on servers at research stations

1. Use run.sh to deploy the app on a stand-alone server. Uses gunicorn to manage the api server and nginx to manage the frontend.
2. Get .env file (for the frontend) and the updated config.py file (for the backend) from Jinam.
3. Run systemctl reload drone_upload_api and systemctl reload nginx

Installation for Super Users

Follow the steps mentioned here

Local installation (for development)

1. Installations needed: mongodb, git, nginx, exiftool, nodejs, npm
2. Clone repo: git clone https://github.com/precision-sustainable-ag/drone-pilot-upload.git
3. Frontend:
   1. Install dependencies: cd frontend && npm install
   2. Create .env file in frontend folder with REACT_APP_API_URL='http://localhost:5000/imgproc'
   3. Run npm run start
4. Backend:
   1. Create a python virtual environment: python3.9 -m venv ./backend/venv
   2. Install python dependencies: ./backend/venv/bin/python3 -m pip install -r ./backend/requirements.txt
   3. Run ./backend/venv/bin/python3 ./backend/app.py