Merge pull request #411 from knaaptime/lodesfips

epa codebook

docs/api.rst

@@ -32,12 +32,15 @@ available quickly with no configuration by accessing methods on the class.
     DataStore.codebook
     DataStore.counties
     DataStore.ejscreen
+    DataStore.ejscreen_codebook
     DataStore.lodes_codebook
     DataStore.ltdb
     DataStore.msa_definitions
     DataStore.msas
     DataStore.ncdb
     DataStore.nces
+    DataStore.nlcd_definitions
+    DataStore.seda
     DataStore.show_data_dir
     DataStore.states
     DataStore.tracts_1990

geosnap/_data.py

@@ -79,6 +79,7 @@ def __dir__(self):
             "codebook",
             "counties",
             "ejscreen",
+            "ejscreen_codebook"
             "lodes_codebook",
             "ltdb",
             "msa_definitions",
@@ -319,6 +320,21 @@ def ejscreen(self, year=2018, states=None):
         t["year"] = year
         return t
 
+    def ejscreen_codebook(self):
+        """Table of variable definitions used in the EPE Environmental Justice Screening dataset
+
+        Returns
+        -------
+        pandas.DataFrame
+            table that stores variable names and definitions.
+
+        """
+        return pd.read_csv(
+            os.path.join(
+                os.path.dirname(os.path.abspath(__file__)), "io/ejscreen_codebook.csv"
+            )
+        )
+
     def blocks_2000(self, states=None, fips=None):
         """Census blocks for 2000.
 
@@ -667,3 +683,5 @@ def nlcd_definitions(self):
                 os.path.dirname(os.path.abspath(__file__)), "io/nlcd_definitions.csv"
             )
         )
+
+

geosnap/io/ejscreen_codebook.csv

@@ -0,0 +1,143 @@
+GDB Fieldname,Description
+OBJECTID,unique ID for block group in geodatabase
+Shape,coordinates defining the features
+ID,Census FIPS code for block group
+ACSTOTPOP,Total population
+ACSIPOVBAS,Population for whom poverty status is determined
+ACSEDUCBAS,Population 25 years and over
+ACSTOTHH,Households (for linguistic isolation)
+ACSTOTHU,Housing units (for % built pre-1960)
+MINORPOP,count of people of color individuals
+MINORPCT,% people of color
+LOWINCOME,count of low-income individuals
+LOWINCPCT,% low-income
+LESSHS,count of individuals age 25 or over with less than high school degree
+LESSHSPCT,% less than high school
+LINGISO,count of households in linguistic isolation
+LINGISOPCT,% of households (interpreted as individuals) in linguistic isolation
+UNDER5,count of individuals under age 5
+UNDER5PCT,% under age 5
+OVER64,count of individuals over age 64
+OVER64PCT,% over age 64
+PRE1960,count of housing units built before 1960
+PRE1960PCT,% pre-1960 housing (lead paint indicator)
+VULEOPCT,"""Demographic Index (based on 2 factors, % low-income and % people of color)"""
+VULEO,intermediate variable used for the Demograpic Index
+DISPEO,intermediate variable used for the Demographic Index
+DSLPM,Diesel particulate matter level in air
+CANCER,Air toxics cancer risk
+RESP,Air toxics respiratory hazard index
+PTRAF,Traffic proximity and volume
+PWDIS,Indicator for major direct dischargers to water
+PNPL,Proximity to National Priorities List (NPL) sites
+PRMP,Proximity to Risk Management Plan (RMP) facilities
+PTSDF,Proximity to Treatment Storage and Disposal (TSDF) facilities
+OZONE,Ozone level in air
+PM25,PM2.5 level in air
+D_LDPNT_2,EJ Index for % pre-1960 housing (lead paint indicator)
+D_DSLPM_2,EJ Index for Diesel particulate matter level in air
+D_CANCR_2,EJ Index for Air toxics cancer risk
+D_RESP_2,EJ Index for Air toxics respiratory hazard index
+D_PTRAF_2,EJ Index for Traffic proximity and volume
+D_PWDIS_2,EJ Index for Indicator for major direct dischargers to water
+D_PNPL_2,EJ Index for Proximity to National Priorities List (NPL) sites
+D_PRMP_2,EJ Index for Proximity to Risk Management Plan (RMP) facilities
+D_PTSDF_2,EJ Index for Proximity to Treatment Storage and Disposal (TSDF) facilities
+D_OZONE_2,EJ Index for Ozone level in air
+D_PM25_2,EJ Index for PM2.5 level in air
+STATE_NAME,Name of State
+ST_ABBREV,Two-letter abbreviation for State
+REGION,US EPA Region number
+P_MINORPCT,Percentile for % people of color
+P_LWINCPCT,Percentile for % low-income
+P_LESHSPCT,Percentile for % less than high school
+P_LNGISPCT,Percentile for % of households (interpreted as individuals) in linguistic isolation
+P_UNDR5PCT,Percentile for % under age 5
+P_OVR64PCT,Percentile for % over age 64
+P_LDPNT,Percentile for % pre-1960 housing (lead paint indicator)
+P_VULEOPCT,"""Percentile for Demographic Index (based on 2 factors, % low-income and % people of color)"""
+P_DSLPM,Percentile for Diesel particulate matter level in air
+P_CANCR,Percentile for Air toxics cancer risk
+P_RESP,Percentile for Air toxics respiratory hazard index
+P_PTRAF,Percentile for Traffic proximity and volume
+P_PWDIS,Percentile for Indicator for major direct dischargers to water
+P_PNPL,Percentile for Proximity to National Priorities List (NPL) sites
+P_PRMP,Percentile for Proximity to Risk Management Plan (RMP) facilities
+P_PTSDF,Percentile for Proximity to Treatment Storage and Disposal (TSDF) facilities
+P_OZONE,Percentile for Ozone level in air
+P_PM25,Percentile for PM2.5 level in air
+P_LDPNT_D2,Percentile for EJ Index for % pre-1960 housing (lead paint indicator)
+P_DSLPM_D2,Percentile for EJ Index for Diesel particulate matter level in air
+P_CANCR_D2,Percentile for EJ Index for Air toxics cancer risk
+P_RESP_D2,Percentile for EJ Index for Air toxics respiratory hazard index
+P_PTRAF_D2,Percentile for EJ Index for Traffic proximity and volume
+P_PWDIS_D2,Percentile for EJ Index for Indicator for major direct dischargers to water
+P_PNPL_D2,Percentile for EJ Index for Proximity to National Priorities List (NPL) sites
+P_PRMP_D2,Percentile for EJ Index for Proximity to Risk Management Plan (RMP) facilities
+P_PTSDF_D2,Percentile for EJ Index for Proximity to Treatment Storage and Disposal (TSDF) facilities
+P_OZONE_D2,Percentile for EJ Index for Ozone level in air
+P_PM25_D2,Percentile for EJ Index for PM2.5 level in air
+B_MINORPCT,Map color bin for % people of color
+B_LWINCPCT,Map color bin for % low-income
+B_LESHSPCT,Map color bin for % less than high school
+B_LNGISPCT,Map color bin for % of households (interpreted as individuals) in linguistic isolation
+B_UNDR5PCT,Map color bin for % under age 5
+B_OVR64PCT,Map color bin for % over age 64
+B_LDPNT,Map color bin for % pre-1960 housing (lead paint indicator)
+B_VULEOPCT,"""Map color bin for Demographic Index (based on 2 factors, % low-income and % people of color)"""
+B_DSLPM,Map color bin for Diesel particulate matter level in air
+B_CANCR,Map color bin for Air toxics cancer risk
+B_RESP,Map color bin for Air toxics respiratory hazard index
+B_PTRAF,Map color bin for Traffic proximity and volume
+B_PWDIS,Map color bin for Indicator for major direct dischargers to water
+B_PNPL,Map color bin for Proximity to National Priorities List (NPL) sites
+B_PRMP,Map color bin for Proximity to Risk Management Plan (RMP) facilities
+B_PTSDF,Map color bin for Proximity to Treatment Storage and Disposal (TSDF) facilities
+B_OZONE,Map color bin for Ozone level in air
+B_PM25,Map color bin for PM2.5 level in air
+B_LDPNT_D2,Map color bin for EJ Index for % pre-1960 housing (lead paint indicator)
+B_DSLPM_D2,Map color bin for EJ Index for Diesel particulate matter level in air
+B_CANCR_D2,Map color bin for EJ Index for Air toxics cancer risk
+B_RESP_D2,Map color bin for EJ Index for Air toxics respiratory hazard index
+B_PTRAF_D2,Map color bin for EJ Index for Traffic proximity and volume
+B_PWDIS_D2,Map color bin for EJ Index for Indicator for major direct dischargers to water
+B_PNPL_D2,Map color bin for EJ Index for Proximity to National Priorities List (NPL) sites
+B_PRMP_D2,Map color bin for EJ Index for Proximity to Risk Management Plan (RMP) facilities
+B_PTSDF_D2,Map color bin for EJ Index for Proximity to Treatment Storage and Disposal (TSDF) facilities
+B_OZONE_D2,Map color bin for EJ Index for Ozone level in air
+B_PM25_D2,Map color bin for EJ Index for PM2.5 level in air
+T_MINORPCT,Map popup text for % people of color
+T_LWINCPCT,Map popup text for % low-income
+T_LESHSPCT,Map popup text for % less than high school
+T_LNGISPCT,Map popup text for % of households (interpreted as individuals) in linguistic isolation
+T_UNDR5PCT,Map popup text for % under age 5
+T_OVR64PCT,Map popup text for % over age 64
+T_VULEOPCT,"""Map popup text for Demographic Index (based on 2 factors, % low-income and % people of color)"""
+T_LDPNT,Map popup text for % pre-1960 housing (lead paint indicator)
+T_LDPNT_D2,Map popup text for EJ Index for % pre-1960 housing (lead paint indicator)
+T_DSLPM,Map popup text for Diesel particulate matter level in air
+T_DSLPM_D2,Map popup text for EJ Index for Diesel particulate matter level in air
+T_CANCR,Map popup text for Air toxics cancer risk
+T_CANCR_D2,Map popup text for EJ Index for Air toxics cancer risk
+T_RESP,Map popup text for Air toxics respiratory hazard index
+T_RESP_D2,Map popup text for EJ Index for Air toxics respiratory hazard index
+T_PTRAF,Map popup text for Traffic proximity and volume
+T_PTRAF_D2,Map popup text for EJ Index for Traffic proximity and volume
+T_PWDIS,Map popup text for Indicator for major direct dischargers to water
+T_PWDIS_D2,Map popup text for EJ Index for Indicator for major direct dischargers to water
+T_PNPL,Map popup text for Proximity to National Priorities List (NPL) sites
+T_PNPL_D2,Map popup text for EJ Index for Proximity to National Priorities List (NPL) sites
+T_PRMP,Map popup text for Proximity to Risk Management Plan (RMP) facilities
+T_PRMP_D2,Map popup text for EJ Index for Proximity to Risk Management Plan (RMP) facilities
+T_PTSDF,Map popup text for Proximity to Treatment Storage and Disposal (TSDF) facilities
+T_PTSDF_D2,Map popup text for EJ Index for Proximity to Treatment Storage and Disposal (TSDF) facilities
+T_OZONE,Map popup text for Ozone level in air
+T_OZONE_D2,Map popup text for EJ Index for Ozone level in air
+T_PM25,Map popup text for PM2.5 level in air
+T_PM25_D2,Map popup text for EJ Index for PM2.5 level in air
+AREALAND,Land area in square meters
+AREAWATER,Water area in square meters
+NPL_CNT,Number of NPL facilities in the block group
+TSDF_CNT,Number of TSDF facilities in the block group
+Shape_Length,Shape length
+Shape_Area,Shape area

geosnap/tests/test_datastore.py

@@ -79,3 +79,7 @@ def test_blocks_2020():
 def test_lodes_codebook():
     df = datasets.lodes_codebook()
     assert df.shape == (42, 4)
+
+def test_ej_codebook():
+    df = datasets.ejscreen_codebook()
+    assert df.shape == (142, 2)