https://github.com/tacc/pandemicexercisetool
https://github.com/tacc/pandemicexercisetool
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tacc/pandemicexercisetool
- Owner: TACC
- License: mit
- Created: 2024-04-04T15:14:01.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-20T19:19:20.000Z (over 1 year ago)
- Last Synced: 2025-04-04T06:16:41.623Z (over 1 year ago)
- Language: JavaScript
- Size: 22 MB
- Stars: 5
- Watchers: 10
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Interactive Outbreak Simulator
A Python Dash-based pandemic and epidemic simulation application that integrates with the
[Pandemic Exercise Simulator](https://github.com/TACC/PandemicExerciseSimulator/) backend engine
to model epidemics within all 50 US states + DC.
## Features
- Multiple Models
- Deterministic and stochastic compartmental, mechanistic models (SEIR, SEIRS, and SEATIRD)
- Interactive Controls
- Configure disease parameters and initial cases for every county and age group
- Interventions
- Model non-pharmaceutical interventions and vaccination across age groups
- US Counties
- Interactive maps with county-level visualizations
- Realistic Subgroups
- Population data from 2023 census stratified by age and high & low risk of severe outcome
- Real-time Simulation
- Live epidemic progression visualized on map and in time series
- Docker Ready
- Complete containerized deployment
## Quick Start
### Prerequisites
- Docker and Docker Compose
- 8GB+ RAM recommended
- Ports 8000, 8050, 6379, 27017 available
### One-Command Startup
Ensure the Docker application is running in the background.
```bash
git clone https://github.com/saroshaprasla/PandemicExerciseTool-Dash.git
cd /your/path/to/PandemicExerciseTool-Dash
docker-compose -f docker-compose-dash.yml up --build -d
```
or using the Makefile
```bash
make start
```
### Access the Application
- **Main Application**: http://localhost:8050
- **Backend API**: http://localhost:8000
- click `api/pet` to see parameters sent to backend engine each run
To check logs of containers find the container name or id, then print logs to your terminal window.
The `-f` flag will allow you to watch a log live. `Ctrl+C` will exit the log.
```bash
docker ps
docker logs
docker logs -f
```
### End Application
```bash
make stop
```
which is equivalent to running
```bash
docker compose -f docker-compose.yml down
```
## Architecture
### Services
- **dash-frontend** (Port 8050): Python Dash web application
- **django-backend** (Port 8000): REST API and data management
- **celery-worker**: Background simulation processing with backend engine
- **mongo-db** (Port 27017): Simulation data storage
- **redis** (Port 6379): Celery message broker and caching