Jg branch

.gitignore

@@ -2,13 +2,11 @@
 *.gz
 *.swp
 
-#files to ignore
-
-
 #Folders to ignore
 data/
 test/
 
 #Mac clean-up
+__pycache__
 *.ds_store
 

Makefile

@@ -1,41 +1,24 @@
 # Allows use of make data while having a data folder
-.PHONY: data img
+.PHONY: data
 
-all: clean-data data img speed avg json state block DDI
-# Creates the data folder
+# Creates the data folder and populates it with the necessary files
 data:
 	mkdir -p data
-	cd data; curl -LO https://www2.census.gov/geo/tiger/TIGER2022/TABBLOCK20/tl_2022_23_tabblock20.zip
-	cd data; curl -LO https://www2.census.gov/geo/maps/DC2020/DC20BLK/st23_me/cousub/cs2301945810_millinocket/DC20BLK_CS2301945810_BLK2MS.txt
-	cd data; curl -LO https://github.com/dobnu/fcc-data/raw/main/bdc_23_Cable_fixed_broadband_063022.zip
-	cd data; curl -LO https://github.com/dobnu/fcc-data/raw/main/bdc_23_Copper_fixed_broadband_063022.zip
-	cd data; curl -LO https://github.com/dobnu/fcc-data/raw//main/bdc_23_Fiber-to-the-Premises_fixed_broadband_063022.zip
-	cd data; curl -LO https://github.com/dobnu/fcc-data/raw/main/bdc_23_Licensed-Fixed-Wireless_fixed_broadband_063022.zip
-
-img:
-	mkdir -p img
-
-speed:
-	python3 -B src/speeds.py
-
-avg:
-	python3 -B src/compute_avg.py
-
-json:
-	python3 -B src/create_json.py
-
-state: img
-	python3 -B src/plot_state.py
-
-block: img
-	python3 -B src/plot_block.py
-
-DDI: data/
-	python3 -B src/DDI.py
-
-maps: data/
-	python3 -B src/maps.py
-
-clean-data:
+	cd data; curl -LO https://www2.census.gov/geo/tiger/TIGER2019/TRACT/tl_2019_23_tract.zip
+	cd data; curl -LO https://www2.census.gov/geo/tiger/TIGER2019/COUNTY/tl_2019_us_county.zip
+	cd data; curl -LO https://www2.census.gov/programs-surveys/demo/datasets/community-resilience/county_tract_total_covered_populations.xlsx
+	python -B src/make_dictionary.py
+	python -B src/make_county_dictionary.py
+	python -B src/create_json.py
+	python -B src/create_county_json.py
+
+plots:
+	mkdir -p figs
+	mkdir -p figs/tract
+	mkdir -p figs/county
+	python -B src/make_plots.py
+	python -B src/make_county_plots.py
+
+# Removes the data folder and all of its contents
+clean: 
 	rm -rf data
-

README.md

@@ -1,77 +1,108 @@
-# broadband-3
+# Broadband-4
+This repository takes data about Maine populations and plots them based on census tracts and counties.
 
-## Step 0
-Run following command to download all of the data:
+## Instructions for Use
+### *Step 1: Generating the Data*
+After cloning the repository, the following command will download and clean necessary data, placing them within the required directories
 ```
 make data
 ```
-The data comes from the following sources:
 
-The FCC National Broadband Map [here](https://broadbandmap.fcc.gov/data-download/nationwide-data).  
-Download the data for Cable, Copper, and Fiber to the Premises, then save those to your data folder.
+### *Step 2: Reproducing the Map Figures*
+The following command will plot the figures of covered populations of Maine tracts/counties based on numerous factors and save the PNGs in the `figs` directory. The covered population factors include *Total Covered Households, Low Income/Poverty, Ages 60+, Incarcerated, Disability, Veterans, Language Barrier, Those w/o Broadband or Computers, Minorities, Rural Living, ESL, Low Literacy (county only), and Those w/o Fixed Broadband (county only)*.
+```
+make plots
+```
+### Tract Plots
+<p align="center">
+    <img src="figs/tract/covered_population.png" width="700">
+</p><br>
 
-The US Census Bureau shapefiles [here](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html).
-The specific file is found [here](https://www2.census.gov/geo/tiger/TIGER2022/TABBLOCK20/tl_2022_23_tabblock20.zip).
+<p align="center">
+    <img src="figs/tract/near_poverty.png" width="700">
+</p><br>
 
-US Census Bureau county subdivision information [here](https://www2.census.gov/geo/maps/DC2020/DC20BLK/st23_me/cousub/cs2301945810_millinocket/DC20BLK_CS2301945810_BLK2MS.txt).
+<p align="center">
+    <img src="figs/tract/Age 60+.png" width="700">
+</p><br>
 
+<p align="center">
+    <img src="figs/tract/Incarcerated.png" width="700">
+</p><br>
 
-## Step 1
-Run the following command to a csv file with the maximum download speeds for Cable, Copper, and Fiber for each census block in Maine:
+<p align="center">
+    <img src="figs/tract/Disabled.png" width="700">
+</p><br>
 
-```
-make speed
-```
+<p align="center">
+    <img src="figs/tract/Veterans.png" width="700">
+</p><br>
 
-## Step 2
-Calculate the average download speeed for Millinocket, which will be printed to the terminal.
+<p align="center">
+    <img src="figs/tract/Language Barrier.png" width="700">
+</p><br>
 
-```
-make avg
-```
+<p align="center">
+    <img src="figs/tract/Lack Broadband or Computers.png" width="700">
+</p><br>
 
-The output you recieve should be "Millinocket average download speed: 516.423"
+<p align="center">
+    <img src="figs/tract/Minorities.png" width="700">
+</p><br>
 
-## Step 3
-Merge the maximum download speeds information with the Census block data for Maine.
+<p align="center">
+    <img src="figs/tract/People in Rural Areas.png" width="700">
+</p><br>
 
-```
-make json
-```
+<p align="center">
+    <img src="figs/tract/Non-native English Speakers.png" width="700">
+</p><br>
 
-## Step 4
-Create a plot for maximum broadband speeds available throughout Maine
+### County Plots
+<p align="center">
+    <img src="figs/county/covered_population.png" width="700">
+</p><br>
 
-```
-make state
-```
-![](img/Maine_speeds.png)
-## Step 5
-Create a plot for maximum broadband speeds available in the individual Census blocks of Millinocket, Maine
+<p align="center">
+    <img src="figs/county/near_poverty.png" width="700">
+</p><br>
 
-```
-make block
-```
-![](img/Millinocket_speeds.png)
+<p align="center">
+    <img src="figs/county/Age 60+.png" width="700">
+</p><br>
 
+<p align="center">
+    <img src="figs/county/Incarcerated.png" width="700">
+</p><br>
 
-## Step 6 
+<p align="center">
+    <img src="figs/county/Disabled.png" width="700">
+</p><br>
 
-```
-make DDI
-```
-DDI Data of different speeds will be saved as a CSV in data folder
+<p align="center">
+    <img src="figs/county/Veterans.png" width="700">
+</p><br>
 
+<p align="center">
+    <img src="figs/county/Language Barrier.png" width="700">
+</p><br>
 
-## Step 7
-Create plots and GeoJSON files for DDI, SE, and INFA scores by running the following command:
-```
-make maps
-```
+<p align="center">
+    <img src="figs/county/Lack Broadband or Computers.png" width="700">
+</p><br>
+
+<p align="center">
+    <img src="figs/county/Minorities.png" width="700">
+</p><br>
 
-The plots should look like this:
-![](img/DDI_tract.png)
+<p align="center">
+    <img src="figs/county/People in Rural Areas.png" width="700">
+</p><br>
 
-![](img/SE_tract.png)
+<p align="center">
+    <img src="figs/county/Non-native English Speakers.png" width="700">
+</p><br>
 
-![](img/INFA_tract.png)
+<p align="center">
+    <img src="figs/county/County-level Only Columns.png" width="700">
+</p><br>