Merge pull request #202 from UI-Research/iss159-description-fixes

Fix a few of Claudia and Tina's notes from 4/20

data/00_metrics-summary_county.csv

@@ -22,7 +22,7 @@ Neonatal health,rate_low_birth_weight,rate_low_birth_weight_quality,1,race_ethni
 Environmental quality,index_air_quality,index_air_quality_quality,3,"race_share, poverty",Metric: Air quality index,"US Environmental Protection Agency’s AirToxScreen data, 2018 (based on 2017 National Emissions Inventory data). (Time period: 2017-18)","Environmental Protection Agency’s National Air Toxics Assessment data, 2014 and AirToxScreen data, 2018 (based on 2014 & 2017 National Emissions Inventory data); US Census Bureau’s 2014 & 2018 5-Year American Community Survey. (Time periods: 2010-14 & 2014-18)","The index is a linear combination of standardized EPA estimates of air quality carcinogenic, respiratory, and neurological hazards measured at the census tract level. Values are inverted and percentile ranked nationally and range from 0 to 100. The higher the index value, the less exposure to toxins harmful to human health.",<br><br>'Majority' means that at least 60% of residents in a census tract are members of the specified group. 'High poverty' means that 40% or more of people in a census tract live in families with incomes below the federal poverty line.,,"2014, 2018"
 Safety from trauma,rate_injury_death,rate_injury_death_quality,1,none,"Metric: Deaths due to injury per 100,000 people","National Center for Health Statistics, 2016-20, drawn from the National Vital Statistics System (via County Health Rankings, 2022). (Time period: 2016-20)",,"Injury deaths is the number of deaths from planned (e.g., homicide or suicide) and unplanned (e.g., motor vehicle deaths) injuries per 100,000 people. Deaths are counted in the county of residence for the person who died, rather than the county where the death occurred. A missing value is reported for counties with fewer than 10 injury deaths in the time frame.",,,2020
 Political participation,share_election_turnout,share_election_turnout_quality,3,none,Metric: Share of the voting-age population who turn out to vote,"Massachusetts Institute of Technology Election Data and Science Lab, 2020; US Census Bureau’s 2020 5-Year American Community Survey Citizen Voting Age Population Special Tabulation. (Time period: 2016-20)","Massachusetts Institute of Technology Election Data and Science Lab, 2016 & 2020; US Census Bureau’s 2016 & 2020 5-Year American Community Survey Citizen Voting Age Population Special Tabulation. (Time periods: 2012-16 & 2016-20)",This metric measures the share of the citizen voting-age population that voted in the most recent presidential election.,,,"2016, 2020"
-Descriptive representation among local officials,"share_desc_rep_asian_other, share_desc_rep_black_nonhispanic, share_desc_rep_hispanic, share_desc_rep_white_nonhispanic","share_desc_rep_asian_other_quality, share_desc_rep_black_nonhispanic_quality, share_desc_rep_hispanic_quality, share_desc_rep_white_nonhispanic_quality",3,none,Metric: Ratio of the share of local elected officials of a racial or ethnic group to the share of residents of the same racial or ethnic group.<em>Part of this metric is shown. See the notes for information on finalizing this metric.</em>,US Census Bureau’s 2021 5-Year American Community Survey. (Time period: 2017-21),,"Shown are the share of that racial or ethnic group in your community. The community will need to calculate the missing percentages in order to complete the descriptive representation metric. See the [Planning Guide](https://upward-mobility.urban.org/boosting-upward-mobility-planning-guide-local-action) (pg. 27) on how to calculate the missing percentage.
+Descriptive representation among local officials,"share_desc_rep_asian_other, share_desc_rep_black_nonhispanic, share_desc_rep_hispanic, share_desc_rep_white_nonhispanic","share_desc_rep_asian_other_quality, share_desc_rep_black_nonhispanic_quality, share_desc_rep_hispanic_quality, share_desc_rep_white_nonhispanic_quality",3,none,Metric: Ratio of the share of local elected officials of a racial or ethnic group to the share of residents of the same racial or ethnic group. <em>Part of this metric is shown. See the notes for information on finalizing this metric.</em>,US Census Bureau’s 2021 5-Year American Community Survey. (Time period: 2017-21),,"Shown are the share of that racial or ethnic group in your community. The community will need to calculate the missing percentages in order to complete the descriptive representation metric. See the [Planning Guide](https://upward-mobility.urban.org/boosting-upward-mobility-planning-guide-local-action) (pg. 27) on how to calculate the missing percentage.
  Say that of your 10 elected officials, nine are White, non-Hispanic and your community’s population is half White, non-Hispanic, the metric will read as “90.0%:50.0%.” If the share of local officials is higher than the share of people in the community, then this group is over-represented. If the share of local officials is lower than the share of people in the community, then this group is under-represented. We are presenting this as a ratio of percentages because it provides important context.<br><br>The quality index reflects the data quality only of the given value.",,,"2018, 2021"
 Safety from crime,"rate_violent_crime, rate_property_crime",rate_crime_quality,3,none,"Metric: Reported property crimes per 100,000 people and reported violent crimes per 100,000 people",Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),"Federal Bureau of Investigations (FBI) Uniform Crime Statistic (UCR) Crime in the United States data series (via ICPSR), 2017 & 2015; American Community Survey, 2017 (1-yr) & 2015 (1-yr); New York State Division of Criminal Justice Services County Index Crime Rates, 2017 & 2015","Rates are calculated as the number of reported crimes against property or people per 100,000 people. Although these are the best national data source, communities should use their local data if they are available. The FBI cautions against using NIBRS data to rank or compare locales because there are many factors that cause the nature and type of crime to vary from place to place.",,,2021
 Just policing,rate_juv_arrest,rate_juv_arrest_quality,3,race,"Metric: Juvenile arrests per 100,000 juveniles",Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),"The number of arrests of people aged 10 to 17, for any crime or status offense, per 100,000 people of that age. Because people can be arrested multiple times, the data reports the number of arrests and not people. Although these are the best national data source, communities should use their local data if it is available. The FBI cautions against using NIBRS data to rank or compare locales because there are many factors that cause the nature and type of crime to vary from place to place.",<br><br>Ethnicity is inconsistently collected and often missing in the data. Those of multiple races are only included in 'Other Races.' ,,2021

data/00_metrics-summary_place.csv

@@ -16,6 +16,6 @@ Financial security,share_debt_col,share_debt_col_quality,3,race_share,Metric: Sh
 Wealth-building opportunities,"ratio_black_nh_house_value_households, ratio_hispanic_house_value_households, ratio_other_nh_house_value_households, ratio_white_nh_house_value_households","ratio_black_nh_house_value_households_quality, ratio_hispanic_house_value_households_quality, ratio_other_nh_house_value_households_quality, ratio_white_nh_house_value_households_quality",3,none,Metric: Ratio of the share of a community’s housing wealth held by a racial or ethnic group to the share of households of the same group,US Census Bureau’s 2021 1-Year American Community Survey Public Use Microdata Sample (via IPUMS); Missouri Census Data Center Geocorr 2022: Geographic Correspondence Engine. (Time period: 2021),US Census Bureau’s 2018 & 2021 1-Year American Community Survey Public Use Microdata Sample (via IPUMS); Missouri Census Data Center Geocorr 2022: Geographic Correspondence Engine. (Time periods: 2018 & 2021),"The percentage to the left of the colon for a given racial group reflects their share of primary-residence housing wealth in a community, and the percentage to the right of the colon reflects the number of households who are headed by a member of that racial group as a share of the community’s total number of households. If the percentage on the left side of the colon is smaller than the percentage on the right side, then that group has less proportionate housing wealth compared to their presence in the community. The greater the gap between these percentages, the more inequality in housing wealth in the community. This metric is based on self-reported housing value, does not account for the extent of mortgage debt, and does not account for other important demographic variations such as differences in age composition across race and ethnic groups, and as such this metric may not fully reflect the size of the actual housing wealth gap.",,,"2018, 2021"
 Environmental quality,index_air_quality,index_air_quality_quality,3,"race_share, poverty",Metric: Air quality index,"US Environmental Protection Agency’s AirToxScreen data, 2018 (based on 2017 National Emissions Inventory data); Missouri Census Data Center Geocorr 2022: Geographic Correspondence Engine. (Time period: 2017-18)","Environmental Protection Agency’s National Air Toxics Assessment data, 2014 and AirToxScreen data, 2018 (based on 2014 & 2017 National Emissions Inventory data); US Census Bureau’s 2014 & 2018 5-Year American Community Survey; Missouri Census Data Center Geocorr 2022: Geographic Correspondence Engine. (Time periods: 2010-14 & 2014-18)","The index is a linear combination of standardized EPA estimates of air quality carcinogenic, respiratory, and neurological hazards measured at the census tract level. Values are inverted and percentile ranked nationally and range from 0 to 100. The higher the index value, the less exposure to toxins harmful to human health.",<br><br>'Majority' means that at least 60% of residents in a census tract are members of the specified group. 'High poverty' means that 40% or more of people in a census tract live in families with incomes below the federal poverty line.,,"2014, 2018"
 Political participation,share_election_turnout,share_election_turnout_quality,3,none,Metric: Share of the voting-age population who turn out to vote,"Voting and Election Science Team, Precinct-Level Election Results 2020 (via Harvard Dataverse); US Census Bureau’s 2020 5-Year American Community Survey Citizen Voting Age Population Special Tabulation; Missouri Census Data Center Geocorr 2022: Geographic Correspondence Engine. (Time period: 2016-20)",,This metric measures the share of the citizen voting-age population that voted in the most recent presidential election.,,,2020
-Descriptive representation among local officials,"share_desc_rep_asian_other, share_desc_rep_black_nonhispanic, share_desc_rep_hispanic, share_desc_rep_white_nonhispanic","share_desc_rep_asian_other_quality, share_desc_rep_black_nonhispanic_quality, share_desc_rep_hispanic_quality, share_desc_rep_white_nonhispanic_quality",3,none,Metric: Ratio of the share of local elected officials of a racial or ethnic group to the share of residents of the same racial or ethnic group.<em>Part of this metric is shown. See the notes for information on finalizing this metric.</em>,US Census Bureau’s 2021 5-Year American Community Survey. (Time period: 2017-21),,"Shown are the share of that racial or ethnic group in your community. The community will need to calculate the missing percentages in order to complete the descriptive representation metric. See the [Planning Guide](https://upward-mobility.urban.org/boosting-upward-mobility-planning-guide-local-action) (pg. 27) on how to calculate the missing percentage. Say that of your 10 elected officials, nine are White, non-Hispanic and your community’s population is half White, non-Hispanic, the metric will read as “90.0%:50.0%.” If the share of local officials is higher than the share of people in the community, then this group is over-represented. If the share of local officials is lower than the share of people in the community, then this group is under-represented. We are presenting this as a ratio of percentages because it provides important context.<br><br>The quality index reflects the data quality only of the given value.",,,2021
+Descriptive representation among local officials,"share_desc_rep_asian_other, share_desc_rep_black_nonhispanic, share_desc_rep_hispanic, share_desc_rep_white_nonhispanic","share_desc_rep_asian_other_quality, share_desc_rep_black_nonhispanic_quality, share_desc_rep_hispanic_quality, share_desc_rep_white_nonhispanic_quality",3,none,Metric: Ratio of the share of local elected officials of a racial or ethnic group to the share of residents of the same racial or ethnic group. <em>Part of this metric is shown. See the notes for information on finalizing this metric.</em>,US Census Bureau’s 2021 5-Year American Community Survey. (Time period: 2017-21),,"Shown are the share of that racial or ethnic group in your community. The community will need to calculate the missing percentages in order to complete the descriptive representation metric. See the [Planning Guide](https://upward-mobility.urban.org/boosting-upward-mobility-planning-guide-local-action) (pg. 27) on how to calculate the missing percentage. Say that of your 10 elected officials, nine are White, non-Hispanic and your community’s population is half White, non-Hispanic, the metric will read as “90.0%:50.0%.” If the share of local officials is higher than the share of people in the community, then this group is over-represented. If the share of local officials is lower than the share of people in the community, then this group is under-represented. We are presenting this as a ratio of percentages because it provides important context.<br><br>The quality index reflects the data quality only of the given value.",,,2021
 Safety from crime,"rate_violent_crime, rate_property_crime",rate_crime_quality,3,none,"Metric: Reported property crimes per 100,000 people and reported violent crimes per 100,000 people",Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),,"Rates are calculated as the number of reported crimes against proprty or people per 100,000 people. Although these are the best national data source, communities should use their local data if they are available. The FBI cautions against using NIBRS data to rank or compare locales because there are many factors that cause the nature and type of crime to vary from place to place.",,,2021
 Just policing,rate_juv_arrest,rate_juv_arrest_quality,3,race,"Metric: Juvenile arrests per 100,000 juveniles",Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),Federal Bureau of Investigations (FBI) National Incident Based Reporting System (via Kaplan J (2021). National Incident-Based Reporting System (NIBRS) Data. https://nibrsbook.com/); US Census Bureau’s 2021 1-Year American Community Survey. (Time period: 2021),"The number of arrests of people aged 10 to 17, for any crime or status offense, per 100,000 people of that age. Because people can be arrested multiple times, the data reports the number of arrests and not people. Although these are the best national data source, communities should use their local data if it is available. The FBI cautions against using NIBRS data to rank or compare locales because there are many factors that cause the nature and type of crime to vary from place to place.",<br><br>Ethnicity is inconsistently collected and often missing in the data. Those of multiple races are only included in 'Other Races.',,2021

description.html

@@ -4251,12 +4251,12 @@ <h5 class="anchored" data-anchor-id="predictor-transportation-access"><a href="h
 <p><strong>Geography:</strong> This can be measured at the census tract or neighborhood level. Values can be averaged at higher levels of geography. For example, one can calculate a population-weighted average value among all census tracts in a county to determine a county-level value.</p>
 <p><strong>Consistency:</strong> This metric can be calculated the same way over time.</p>
 <p><strong>Subgroups:</strong> This metric is based on a lower-income population, notably single-parent families with two children earning half the local AMI among renters.</p>
-<p><strong>Limitations:</strong> This metric cannot alone capture the concept of transportation access. This must be used in partnership with the low transportation cost index to cover geographies that may not have an extensive public transportation system, such as rural areas.</p>
+<p><strong>Limitations:</strong> This metric cannot alone capture the concept of transportation access. This must be used in partnership with the transportation cost index to cover geographies that may not have an extensive public transportation system, such as rural areas.</p>
 <p><br></p>
 </section>
 <section id="predictor-transportation-access-1" class="level5">
 <h5 class="anchored" data-anchor-id="predictor-transportation-access-1"><a href="https://upward-mobility.urban.org/transportation-access">PREDICTOR: TRANSPORTATION ACCESS</a></h5>
-<p><strong>Metric: Low transportation cost index</strong></p>
+<p><strong>Metric: Transportation cost index</strong></p>
 <p>This index reflects local transportation costs as a share of renters’ incomes. It accounts for both transit and cars. This index is based on estimates of transportation costs for a three-person, single-parent family with income at 50 percent of the median income for renters for the region (i.e., a core-based statistical area). Although other arrangements of family composition, income, and housing status are possible in constructing this index, these characteristics were intended to more closely characterize a lower-income household in the community. Values are inverted and percentile ranked nationally, with values ranging from 0 to 100. The higher the value, the lower the cost of transportation in that neighborhood.</p>
 <p><strong>Validity:</strong> This metric was designed in partnership with the US Department of Transportation and has been used by the US Department of Housing and Urban Development in community efforts to affirmatively further fair housing. Several scholars have also used this metric and data in articles in peer-reviewed journals.</p>
 <p><strong>Availability:</strong> The estimates come from the location affordability index, which are publicly available.</p>