mirror of https://github.com/DOI-DO/j40-cejst-2.git synced 2025-02-23 10:04:18 -08:00

Add translations for repo documents (#281 )

* WIP README improvements

* Add translations for some core open source process files

This addresses #37. Note that these translations were requested from the
State Dept a few weeks ago, so they don't have some of the latest
updates to content from recent PRs. We will need to come up with a good
proces for keeping both sets of docs up to date as we make changes.

Co-authored-by: Shelby Switzer <shelby.switzer@cms.hhs.gov>

2021-07-01 13:48:03 -04:00

3.5 KiB

Raw Blame History

Justice 40 Score application

Running using Docker

We use Docker to install the necessary libraries in a container that can be run in any operating system.

To build the docker container the first time, make sure you have Docker running on your machine and that you're in the root directory of the repository. Then run docker-compose build.

You can then run the following commands. You probably want to run these in a new terminal tab or window, because they may take a long time to run, especially the last one that generates the census data.

Get help: docker run --rm -it j40_score /bin/sh -c "python3 application.py" python3 application.py --help"
Clean up the data directories: docker run --rm -it j40_score /bin/sh -c "python3 application.py data-cleanup"
Generate census data (this may take 2-3 hours): docker run --rm -it j40_score /bin/sh -c "python3 application.py census-data-download"

Log visualization

If you want to visualize logs while running a command, the following temporary workaround can be used:

Run docker-compose up on the root of the repo
Open a new tab on your terminal
Then run any command for the application using this format: docker exec j40_score_1 python3 application.py [command]

Local development

You can run the Python code locally without Docker to develop, using Poetry. However, to generate the census data you will need the GDAL library installed locally. Also to generate tiles for a local map, you will need Mapbox tippeanoe

Start a terminal
Make sure you have Python 3.9 installed: python -V or python3 -V
We use Poetry for managing dependencies and building the application. Please follow the instructions on their site to download.
Install Poetry requirements with poetry install

Downloading Census Block Groups GeoJSON and Generating CBG CSVs

Make sure you have Docker running in your machine
Start a terminal
Change to this directory (i.e. cd score)
If you want to clear out all data and tiles from all directories, you can run: poetry run python application.py data-cleanup.
Then run poetry run python application.py census-data-download Note: Census files are not kept in the repository and the download directories are ignored by Git

Generating mbtiles

Serve the map locally

Start a terminal
Change to this directory (i.e. cd score)
Run: docker run --rm -it -v ${PWD}/data/tiles:/data -p 8080:80 maptiler/tileserver-gl

Running Jupyter notebooks

Start a terminal
Change to this directory (i.e. cd score)
Run poetry run jupyter notebook. Your browser should open with a Jupyter Notebook tab

Activating variable-enabled Markdown for Jupyter notebooks

Change to this directory (i.e. cd score)
Activate a Poetry Shell (see above)
Run jupyter contrib nbextension install --user
Run jupyter nbextension enable python-markdown/main
Make sure you've loaded the Jupyter notebook in a "Trusted" state. (See button near top right of Notebook screen.)

For more information, see nbextensions docs and see python-markdown docs.

Miscellaneous

To export packages from Poetry to requirements.txt run poetry export --without-hashes > requirements.txt

3.5 KiB Raw Blame History