https://github.com/pythoninthegrass/cooling_centers
Python project to aggregate US Cooling centers
https://github.com/pythoninthegrass/cooling_centers
edgedb folium graphql python
Last synced: 3 months ago
JSON representation
Python project to aggregate US Cooling centers
- Host: GitHub
- URL: https://github.com/pythoninthegrass/cooling_centers
- Owner: pythoninthegrass
- License: mit
- Created: 2024-07-05T22:16:36.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-02-07T23:31:15.000Z (4 months ago)
- Last Synced: 2025-02-21T21:49:54.841Z (3 months ago)
- Topics: edgedb, folium, graphql, python
- Language: Python
- Homepage: http://coolingcenters.us/
- Size: 964 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Oklahoma Cooling Centers
Originally a fork of [Oklahoma Cooling Centers](https://github.com/alex-code4okc/oklahoma_cooling_centers_python), now it's a standalone repo that aims to aggregate all public cooling centers in the United States.
Shoutout to [Alex Ayon](https://github.com/alex-code4okc) for the original local implementation and general idea! 🎉
## Minimum Requirements
* [python3.11+](https://www.python.org/downloads/)
## Recommended Requirements
* [devbox](https://www.jetify.com/devbox/docs/quickstart/)
## Quickstart
This is just for the map portion. The backend is still in development.
```bash
# create virtual environment
python3 -m venv .venv
# activate virtual environment
source .venv/bin/activate
# install dependencies
python3 -m pip install -r requirements.txt
# run script
./make_map.py
# open map in browser
open ./docs/index.html
# deactivate virtual environment
deactivate
```
## Development
### Read PDF
* ImageMagick is a problem child for `pdftotree` on macOS. Run the following to use `gen_csv.py`:
```bash
# install imagemagick v6
brew uninstall imagemagick
brew install imagemagick@6
brew unlink imagemagick
brew link imagemagick@6 --force
# ~/.bashrc
export BREW_PREFIX=$(brew --prefix)
export MAGICK_HOME="$BREW_PREFIX/opt/imagemagick@6"
```
* Run `./bin/gen_csv.py` to generate `./csv/cooling_centers_2024.csv`
### Geocoding
* Open a free Google Cloud Platform account and [setup the Geocoding API](https://developers.google.com/maps/documentation/geocoding/overview)
* Fill out `.env` with your API key
* Run `./bin/geocode.py` to append `latitude_longitude` and prepend `city_county` to a CSV file
* Needs to be in the `csv` directory
* Named with state abbreviation and year (e.g., `ok_cooling_centers_2024.csv`)
* Can be set in `.env` as `CSV_FILE`
## TODO
* [Issues](https://github.com/pythoninthegrass/cooling_centers/issues)
* ~~Transform [NY state CSV](csv/ny_cooling_centers_2024.csv) to match [OK state CSV](csv/ok_cooling_centers_2024.csv)~~
* Load all CSVs into a database
* First `sqlite`, then `edgedb`
* Embed as an [iframe](https://python-visualization.github.io/folium/latest/advanced_guide/flask.html)
* Sub FastAPI for Flask
* Transform
* Fix NaN values
* Missing cells (e.g., `city_county`, `latitude_longitude`)
* `506 Williams St.` being geocoded as NaN / Georgia
* Normalize
* phone numbers
* hours of operation
* Remove OG&E's Arkansas locations
* Maybe keep Fort Smith as that's close to the border at least
* Open locations on map in [new tab](https://www.freecodecamp.org/news/how-to-open-a-link-in-a-new-tab/)