Skip to content

alavrouk/jic3119-eagleeye

Repository files navigation

Eagle Eye Logo

โœˆ๏ธ Introduction

Eagle Eye is an innovative machine learning solution designed to streamline route planning for the US Air Force. This project leverages advanced predictive models and optimization techniques to enhance operational efficiency and decision-making.

๐Ÿ—๏ธ Key Features

  • ๐Ÿ”ฎ Predictive Analysis: Utilizes SARIMA, LSTMs, and Neuralprophet models to generate accurate airfield utilization predictions.
  • ๐Ÿ“Š Optimization: Implements linear programming optimization for effective route planning.
  • ๐ŸŒŸ Clean, Minimalistic UI: Designed to allow a route planner of any background to use with as little confusion as possible.
  • โš™๏ธ Continuosly Integrated, Continuously Deployed: Docker container with every release lives in the Github. Security and Code analysis runs on every push to the main branch.

๐Ÿ’ป Getting Started

Follow these steps to set up the Eagle Eye environment on your machine:

Prerequisites

  • Python 3.10.8 (for backend setup)
  • Node.js and npm (for frontend setup)

Installation

  1. Create a Conda Environment:
    conda create --name eagle-eye python=3.10.8
    conda activate eagle-eye
  2. Clone and navigate to github repository
    git clone https://github.com/alavrouk/jic3119-eagleeye.git
    cd eagleeye
  3. Install Python Dependencies:
    pip install -r requirements.txt
  4. Run the Backend Server:
    python api_fastapi.py
  5. Open a New Shell and Set Up the Frontend:
    npm install
    npm start
  6. Troubleshooting:
    • In our development, the only source of error was dependencies.
    • All dependencies are are listed in the requirements.txt.
    • If there is an issue, we recommend you contact us, as these errors can be multitudinous and are tough to pin down.
  7. The front and backend should be running!

โœ๏ธ Release Notes

Version 1.0.0

New Features

  • Built full-functioning linear programming optimizer for airfield balancing.
  • User ability to input their own supplies
  • Time matrix for different airfields in order to make optimization factually correct.

Bug Fixes

  • Fixed bug where the route planning map was zoomed into a weird place in California on startup.

Known Issues

  • Arrow formatting is not pleasant to look at in route planning.

Version 0.4.0

New Features

  • Linked up 3 time-series utilization models to front end - now results are graphed through FastAPI
  • Created a better map visualization using more modern tools
  • Linked linear programming based route planning to a table at the bottom of the route planning page.

Bug Fixes

  • Fixed SARIMA bug where the resultant distribution would just be completely random

Known Issues

  • Models are not tuned and thus do not represent final performance (but better tuned than last time)
  • neuralprophet model is trained on a different dataset and thus produces different results.

Version 0.3.0

New Features

  • Created three models for airfield utilization time series prediction
  • Created synthetic data generator to use in airfield utilization
  • Created linear programming instance for fleet route planning

Bug Fixes

  • Fixed up bugs in the route planning visualization

Known Issues

  • Models are not tuned and thus do not represent final performance

Version 0.2.0

New Features

  • Added business plot showing airfield ground clearance trends
  • Added a file drop page for uploading new aifrield data
  • Added flight route planning visualization in map component

Bug Fixes

  • Modularized airfield and business data from their respective components

Known Issues

  • Map view can be buggy rendering between frames

Version 0.1.0

New Features

  • Added Dropdown menu for Airfields
  • Added Map component for route planning
  • Created centralized dashboard for flight stats

Bug Fixes

  • Refactored Artifact code to ensure variables were properly tracked across Dashboard tabs

Known Issues

  • Hardcoded airfield data

๐ŸŽฅ Sprint Demo Videos

In each sprint of the Eagle Eye project, we've captured key developments and features through demo videos. These videos provide a visual overview of our progress and the functionalities implemented in each phase.

Watch Sprint 2 Demo

Sprint 2 Demo

Watch Sprint 3 Demo

Sprint 3 Demo

Watch Sprint 4 Demo

Sprint 4 Demo

Watch Sprint 5 Demo (will be here in a few days)

Sprint 5 Demo

Click on the titles to expand and view each sprint's demo video.


Enjoy watching the journey of Eagle Eye from conception to completion!

๐Ÿ“ซ Contact Us

Developer Headshots

Should the need arise, feel free to contact the developers of this project for any sort of support!

Due to the rise of spam-bots scraping github, we have obfuscated emails. [SCHOOL] = gatech.edu and [AT] = @. Thank you for your understanding!

Anton Lavrouk

Ivan Zapote

Azhan Khan

Eric Vela

David Schmidt

About

Semester 2 of Junior Design Team JD3119

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages