Sacramento Homeless Services Dashboard
A project to provide a user friendly and interactive dashboard with data from Sacramento County's Homeless Management Information System
- Dashboard now live at https://hmis-dashboard.herokuapp.com/
- Source database API: https://hmis-dashboard.herokuapp.com/api/source
- Data source here.
Readme contents:
- Context
- Execution Instructions
- Assumptions Used to Produce Charts
Context
A homeless management information system (HMIS) is a database used to aggregate data on homeless populations served across the United States. This repository contains the source Sacramento County HMIS data (*plus a locally-created exit_destinations csv file), a Jupyter Notebook that loads the data into a PostgreSQL database, a flask API that then serves the data from the database, and finally a web based dashboard using HTML, CSS, and JavaScript. The dashboard includes interactive charts that allows users to explore homeless services program volumes, outcomes, and participant demographics. An explanation of assumptions made for chart plotting is also included at the bottom of this readme.
Execution Instructions
- Create a local PostgreSQL database named "sac_hmis_db".
- Create a local .env file with your PostgreSQL
usernameandpassword. See sample-env.txt file in repo for format. - Run all cells in DB_Load Jupyter notebook, which is found in the "data" folder.
- Use a terminal to navigate to the main folder and run app.py by typing:
python app.py. - Open your browser and go to the url
http://localhost:5000/.
Assumptions Used for Producing Charts
Data included from January 1, 2015 through August 31, 2019
- There is a large data dump that happened in 2014 which impacts the data.
- While there are some dates in the dataset after August 2019, it appears to be incomplete.
Volume/Program Participation
- In and out are straightforward counts of activity within the time period.
- Active includes those enrolled in a program who do not have an exit date prior to the end of the time period, plus those with an exit date during the time period.
- Each enrollment counted – clients included more than once if actively enrolled in more than one program
- For yearly chart, included rudimentary projection for full year for sake of comparison. In and out for final 4 months are added in as means of previous months for 2019. Active is trickier to estimate and shows an assumed 5% growth from 2018.
Outcomes/Program enrollees with permanent housing upon program exit
- For those who exited a program in the period, shows the number who exited to permanent housing divided by the total number of exits. Permanent housing is defined as Category 1 as defined in “Variables included in County Data” spreadsheet’s “Exit Destination” worksheet.
- Clients are only counted once. If client happens to have an exit to permanent housing and an exit in the same period to something other than permanent housing, they are counted as an exit to permanent housing.
Outcomes/Average time to permanent housing
- Time calculated for those who started from street outreach, transitional housing, or day/emergency shelter and exited to permanent housing Category 1.
Demographics
- Grouped unknown categories together. For example, in Race chart, unknown includes categories ‘Client Refused', 'Data Not Collected', 'Client doesn't Know', and ‘NULL’.