python source code for an open source plotly dash app, used for examining results of CMS' Overall Hospital Quality Star Ratings.
-
After downloading or cloning this repository, open a terminal window or command prompt in the root folder.
-
Create a virtual environment for running this app with Python (>=3.8)
In MacOS or Linux:
python3 -m virtualenv venvIn Unix:
source venv/bin/activateIn Windows:
venv\Scripts\activate -
Install required packages using pip:
pip install -r requirements.txt -
Run this app locally with:
python3.8 app.pyThe output of the terminal window will look like:
Dash is running on http://0.0.0.0:8050/ -
Paste the url into your web browser and voila!
These are automatically installed when following the instructions above.
- werkzeug==2.0.3
- dash==2.0.0
- gunicorn==20.1.0
- numpy==1.22.1
- pandas==1.4.0
- scipy>=1.7.3
- flask>=1.1.2
- plotly==5.5.0
- datetime==4.3
- pathlib==1.0.1
- statsmodels==0.13.1
- scikit-learn==1.0.2
- dash_bootstrap_components==1.0.2
- lxml==4.8.0
app.py
The primary file for running the application. This file contains the entirety of source code for the app as well as many comments to explain the application's functionality.assets
Files in this directory are used by the application to format its interface or are used as images in this README file. All files except `RUSH_full_color.jpg` were obtained from another open source Plotly Dash app (https://github.com/plotly/dash-sample-apps/tree/main/apps/dash-clinical-analytics/assets.): `Acumin-BdPro.otf`, `base.css`, `clinical-analytics.css`, - `plotly_logo.png`- `resizing.js`Acumin-BdPro.otf: An OpenType font file used by the application.base.cssA cascading style sheets (CSS) used by the application. CSS is a stylesheet language used to describe the presentation of a document written in HTML or XML.clinical-analytics.cssAn additional css file.plotly_logo.pngRUSH_full_color.jpgimages_for_README: A directory containing png files used in this README document.
Procfile
This extensionless file is necessary for deployment on Heroku, and essentially tells Heroku how to handle web processes using the gunicorn server. The file contains a single line with the following: `web: gunicorn app:server`requirements.txt
This file lists all of the software libraries needed for the app to run. When deploying the app on Heroku, this file is used to set up the server with the libraries necessary for running the application. When used locally, this file tells pip which libraries need to be installed (i.e., `pip install -r requirements.txt`).runtime.txt
This file is used when setting up the app to run on an online Heroku server. It contains a single line: `python-3.8.12, indicating the version of python to use.Kenneth J. Locey, PhD. Senior Clinical Data Scientist. Center for Quality, Safety & Value Analytics. Rush University Medical Center.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent