by Nikhil Anand (@nanand33
) William Lam (@wlam39
), and Shrea Shyam (@sshyam3
)
Team Repository for the Applied Practicum at Georgia Tech's Analytics Program 🐝
👉 Note: If you have any problems whatsoever with running things in this repository, please email Nikhil.
Please see our Midterm Presentation for an overview and the Final Report for our details on our implementation.
The results of our analysis and modeling are expressed via a Web Application (an SPA built with React) and an API server (a Flask application in Python). We will describe how to run these locally but if you don't want to bother, both are publicly available at https://icd10.ninja.
You will need:
bash
v4+. If you're on Windows, you can use WSL.- Node v18+ with
yarn
v1.10+ installed globally (npm i -g yarn
) - Python v3.10+ with
poetry
installed globally (pip install poetry
)
We like nvm
and pyenv
to manage our environments but you can use whatever you'd like. Here's some copypasta to get our app running on your machine:
# Let's start with the Client. This will run `yarn` to install dependencies,
# copy some required static assets into place and run a local server at
#
# http://localhost:3000
#
yarn start:client
# Same deal with the Server. This will run `poetry` to install dependencies,
# copy some required static assets into place and run a local server at
#
# http://localhost:5000
#
yarn start:server
That's it! Now navigate to http://localhost:3000 to use our spiffy app 🥳
All the notebooks and scripts we used to generate data for our analysis, conduct analysis, and evaluate our approches are in the ./analysis
. Please see ./analysis/README.md
for further information.
The ./data
folder contains all the data we used and generated for this project. Please see ./data/README.md
for further information.
The ./client
folder contains a React-based SPA. You can see ./client/README.md
for some commands. You are encouraged to run yarn start:client
from this folder, however.
The ./server
folder contains a Flask-based server that implements our modeling approach via a few REST endpoints. See ./server/README.md
for a listing of these endpoints and more information.
You will also find our Final Report, Midterm Presentation, and other assorted references in their appropriately named folders. The ./scripts
folder contains many conveniences that help you start the client and server, deploy the web app, and so on.