route_analysis/README.md

## Routes for walking to school
This script generates maps to analyze the potential walking routes for students to their school.

- I excluded the addresses of the students from the repository.
- The actual route generation is done with OSRM and brouter, those are run locally in docker containers.
- The basemap is pulled from Stadia Maps. The usage of the script is well within the free tier, you'll need an API key from them.

## Data sources
- School location data is from: https://data-wi-dpi.opendata.arcgis.com/
- Madison Bike Level of Traffic Stress is from: https://data-cityofmadison.opendata.arcgis.com/datasets/cityofmadison::bike-lts/explore
- Student addresses provided by school.

## Example figures
This script will generate a few figures:
### A heatmap of student addresses:
![example address figure](examples/example-addresses.png)

### A map of all the walking routes within the walk boundary:
![example routes figure](examples/example-routes.png)

### A map of those routes colored by the level of traffic stress to bike
![example routes-lts figure](examples/example-routes-lts.png)

## Using make
- `make osrm-data`: downloads the OpenStreetMap data for Wisconsin, and preproccesses it for use with OSRM.
- `make osrm-container`: starts the OSRM containers (backends and frontends) for walking and biking.
- `make brouter-data`: clones the repositories for brouter and brouter-web and downloads the segment data. It also builds the docker images for brouter and brouter-web.
- `make brouter-container`: starts the brouter containers (backend and frontend).
- `make walk` will run *route_analysis.Rmd* which
calculates the walking routes using OSRM.
- `make cycle-osrm` will run *cycling_route_analysis.Rmd* which calculates the biking routes using OSRM.
- `make cycle-brouter` will run *cycling_route_analysis_brouter.Rmd* which calculates the biking routes using brouter.

## Misc.
- [Bike Level of Traffic Stress (LTS)](https://www.dvrpc.org/webmaps/bike-lts/analysis/)

## OpenStreetMap Data
- [wisconsin-latest.osm.pbf](https://download.geofabrik.de/north-america/us/wisconsin-latest.osm.pbf)
remade repo removing student addresses 2024-10-28 17:02:30 -05:00			`## Routes for walking to school`
			`This script generates maps to analyze the potential walking routes for students to their school.`

			`- I excluded the addresses of the students from the repository.`
added brouter to readme intro 2024-11-05 08:27:07 -06:00			`- The actual route generation is done with OSRM and brouter, those are run locally in docker containers.`
remade repo removing student addresses 2024-10-28 17:02:30 -05:00			`- The basemap is pulled from Stadia Maps. The usage of the script is well within the free tier, you'll need an API key from them.`

added data sources to README 2024-10-31 11:22:22 -05:00			`## Data sources`
README formatting 2024-10-31 11:23:17 -05:00			`- School location data is from: https://data-wi-dpi.opendata.arcgis.com/`
			`- Madison Bike Level of Traffic Stress is from: https://data-cityofmadison.opendata.arcgis.com/datasets/cityofmadison::bike-lts/explore`
			`- Student addresses provided by school.`
added data sources to README 2024-10-31 11:22:22 -05:00
remade repo removing student addresses 2024-10-28 17:02:30 -05:00			`## Example figures`
			`This script will generate a few figures:`
edited README again 2024-10-28 17:05:09 -05:00			`### A heatmap of student addresses:`
edited README 2024-10-28 17:04:04 -05:00			`![example address figure](examples/example-addresses.png)`
remade repo removing student addresses 2024-10-28 17:02:30 -05:00
edited README again 2024-10-28 17:05:09 -05:00			`### A map of all the walking routes within the walk boundary:`
edited README 2024-10-28 17:04:04 -05:00			`![example routes figure](examples/example-routes.png)`
remade repo removing student addresses 2024-10-28 17:02:30 -05:00
edited README again 2024-10-28 17:05:09 -05:00			`### A map of those routes colored by the level of traffic stress to bike`
edited README 2024-10-28 17:04:04 -05:00			`![example routes-lts figure](examples/example-routes-lts.png)`
Update to README.md 2024-10-29 10:43:27 -05:00
			`## Using make`
Edited .gitignore, edited README, edited Makefile to include new brouter make commands 2024-11-05 07:52:14 -06:00			- `make osrm-data`: downloads the OpenStreetMap data for Wisconsin, and preproccesses it for use with OSRM.
			- `make osrm-container`: starts the OSRM containers (backends and frontends) for walking and biking.
			- `make brouter-data`: clones the repositories for brouter and brouter-web and downloads the segment data. It also builds the docker images for brouter and brouter-web.
			- `make brouter-container`: starts the brouter containers (backend and frontend).
			- `make walk` will run route_analysis.Rmd which
			`calculates the walking routes using OSRM.`
			- `make cycle-osrm` will run cycling_route_analysis.Rmd which calculates the biking routes using OSRM.
edited typo in Makefile 2024-11-05 07:59:38 -06:00			- `make cycle-brouter` will run cycling_route_analysis_brouter.Rmd which calculates the biking routes using brouter.
Began Organizing Markdown Script Working my way through the code trying to understand it. Added section headers, broke code into chunks, moved a couple of lines, etc. 2024-10-31 17:12:08 -05:00
			`## Misc.`
			`- [Bike Level of Traffic Stress (LTS)](https://www.dvrpc.org/webmaps/bike-lts/analysis/)`
Added link to OSM data to README 2024-11-04 18:50:47 -06:00
			`## OpenStreetMap Data`
			`- [wisconsin-latest.osm.pbf](https://download.geofabrik.de/north-america/us/wisconsin-latest.osm.pbf)`