University of Minnesota Drone Transportation Simulation

This is the codebase for the drone simulation for the final project for UMN CSCI 3081W Spring 2022.
See here for the demo video, UML diagram, and final report.

Team Members

• Benjamin Minneci
• Lucas Hoof

Paths to Added and Modified Files

Added

project/libs/transit/include:

• DroneDecorator.h
• BatteryDecorator.h
• hub.h
• HubFactory.h

project/libs/transit/src:

• DroneDecorator.cc
• BatteryDecorator.cc
• hub.cc
• HubFactory.cc

Modified

project/libs/transit/include:

• drone.h
• Beeline.h
• AstarStrategy.h
• DfsStrategy.h
• DijkstraStrategy.h
• CelebrationDecorator.h

project/libs/transit/src:

• drone.cc
• Beeline.cc
• AstarStrategy.cc
• DfsStrategy.cc
• DijkstraStrategy.cc
• CelebrationDecorator.cc

Getting Started

Docker Setup

Docker Pre-requisites

• Windows 10 Home
  • Install wsl2 and Ubuntu and Windows 10 Doc
  • For Windows 11
• Install Docker Desktop from Docker Hub
• Linux
  • Use docker group instead of sudo

Getting Started with Docker (after cloning the repository)

On Windows use the "Git Bash" terminal.

1. Navigate to the root directory of the repository

   cd umn-drone/
   

2. Build docker image

   bin/build-env.sh
   

3. Run docker image

   #Usage bin/run-env.sh <port - optional(default 8081)>
   bin/run-env.sh
   

Build and Run

Here is a quick overview of how to run the simulation in the docker container (these steps are similar in each build environment):

# Go to the project directory
cd /path/to/repo/project

# You may need to run this command before the following ones
git config --global --add safe.directory /home/user/repo

# Clean the project
make clean

# Build the project
make -j

# Run the project (./build/web-app <port> <web folder>)
build/bin/transit_service 8081 apps/transit_service/web/

Navigate to http://127.0.0.1:8081 and you should see a visualization.
Navigate to http://127.0.0.1:8081/schedule.html and you should see a a page to schedule the trips. To view the entities, click on the right top of the visualization page (not the schedule page) and choose the entity to view such as drone or (robot name) that you give in the schedule page.