spatialanalysis / geodadata

Data package for accessing GeoDa datasets using R

geodaData

The goal of geodaData is to store sample spatial datasets. These datasets are intended to be used to teach basic spatial analysis concepts. They are used in the weekly R Spatial Workshop at the Center for Spatial Data Science at UChicago, and are based off of the GeoDa workbook and data site developed by Luc Anselin and team. Datasets are stored in the sf spatial object format.

Installation

You can install geodaData from CRAN with:

install.packages("geodaData")

You can install the development version of geodaData from GitHub with:

# install.packages("remotes")
remotes::install_github("spatialanalysis/geodaData")

Usage

To use geodaData in a workshop, first load sf, then load the package:

library(sf) # can use without sf, but datasets will print weirdly in console
library(geodaData)

Find a list of all datasets in geodaData with:

data(package = "geodaData")

You can load a specific dataset into your R environment and show the metadata for it:

head(nyc)
?nyc

Instructions for adding a new dataset to this package can be found in the Wiki of this repository.

Datasets

Current datasets included in this package:

• abandonedcars: Abandoned Vehicles (2016).
• airbnb: Airbnb rentals, socioeconomics, and crime in Chicago.
• atlanta_homicide: Atlanta, GA region homicide counts and rates.
• baltimore_home: Baltimore house sales prices and hedonics.
• bostonhsg: Boston housing and neighborhood data.
• buenosaires: Electoral Data for 1999 Argentinean Elections.
• charleston1: 2000 Census Tract Data for Charleston, SC MSA and counties.
• charleston2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) in Charleston, SC MSA.
• chigroceries: Chicago supermarkets (2015).
• chihealth: Chicago Health and Socio-Economics (2014).
• chilelabor: Labor Markets in Chile (1982-2002).
• chisociohealth: Chicago Health Indicators (2005-11).
• cincinnati: Cincinnati Crime and Socio-Demographics (2008).
• cleveland: Cleveland Home Sales (2015).
• columbus: Columbus neighborhood crime (1980).
• commpop: Chicago Population Change (2000-2010).
• community_pop: Chicago Community Area Population for 2010 (non-spatial, csv).
• denver: Demographics and housing in Denver neighborhoods (2010).
• elections1216: 2012 and 2016 Presidential Elections in the United States.
• grid100: Grids with simulated variables.
• guerry: Guerry "Moral Statistics" (1830s).
• healthplus: Health, Income and Diversity for US counties (2000).
• hickory1: Census Tract Data for Hickory, NC MSA and counties (2000).
• hickory2: Zip Code Business Patterns (Census Bureau) for Hickory, NC MSA (1998 and 2001).
• houstonhom: Houston, TX region homicide counts and rates (1980s-90s).
• juvenile: Cardiff juvenile delinquent residences.
• kchomesale: Home Sales in King County, WA (2014-15).
• lansing1: 2000 Census Tract Data for Lansing, MI MSA and counties.
• lansing2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Lansing, MI MSA.
• laozone: Ozone measures at monitoring stations in Los Angeles basin (1996).
• lasrosas1: Corn yield, fertilizer and field data for precision agriculture, Argentina (1999).
• lasrosas2: Corn yield, fertilizer and field data for precision agriculture, Argentina (1999).
• liquorstore: Chicago Liquor Stores (2015).
• malaria_col_dept: Malaria incidence and population (1973, 95, 93 censuses and projections until 2005).
• malaria_col_munic: Malaria incidence and population (1973, 95, 93 censuses and projections until 2005).
• milwaukee1: 2000 Census Tract Data for Milwaukee, WI MSA..
• milwaukee2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Milwaukee, WI MSA.
• mspolice: Police expenditures Mississippi counties.
• ncovr: Homicides & Socio-Economics (1960-90).
• ndvi: Normalized Difference Vegetation Index grid.
• nepal: Health, poverty and education indicators for Nepal districts (2007-14).
• nyc: Rental Housing and Demographics in NYC (2000s), non-spatial.
• nyc_sf: Rental Housing and Demographics in NYC (2000s).
• nycearnings: Block-level Earnings in NYC (2002-14).
• nyceducation: NYC Education (2000).
• nycneighborhood: Demographics for New York City neighborhoods (2000s).
• nycsociodemo: NYC Education and Socio-Demographics (2000s).
• ohio_lung: Ohio Lung Cancer Mortality (1960s-80s).
• orlando1: 2000 Census Tract Data for Orlando, FL MSA and counties.
• orlando2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Orlando, FL MSA.
• ozone9799: Monthly ozone data, 1997-99.
• phoenixACS: Phoenix American Community Survey Data (2010, 5-year averages).
• pittsburghom: Pittsburgh homicide locations (1993).
• sacramento1: 2000 Census Tract Data for Sacramento MSA.
• sacramento2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Sacramento MSA.
• savannah1: 2000 Census Tract Data for Savannah, GA MSA and counties.
• savannah2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Savannah, GA MSA.
• scotlip: Male lip cancer in Scotland, 1975-80.
• seattle1: 2000 Census Tract Data for Seattle, WA MSA and counties.
• seattle2: 1998 and 2001 Zip Code Business Patterns (Census Bureau) for Seattle, WA MSA.
• Sfcartheft: Car theft incidents in San Francisco (points and area) - for CAST (July-Dec 2012).
• Sfcrime: Crime incidents in San Francisco (points and area) - for CAST (July-Dec 2012).
• Sfdrugs: Drug incidents in San Francisco (points and area) - for CAST (July-Dec 2012).
• Sfrobbery: Robbery incidents in San Francisco (points and area) - for CAST (July-Dec 2012).
• Sfvandalism: Vandalism incidents in San Francisco (points and area) - for CAST (July-Dec 2012).
• SIDS: North Carolina county SIDS death counts (1970s and 1980s).
• snow: John Snow & the 19th Century Cholera Epidemic.
• southom: US Southern county homicides 1960-1990.
• stlouishom: St Louis region county homicide counts and rates (1980s and 1990s).
• tampa: 2000 Census Tract Data for Tampa, FL MSA and counties.
• us_sdoh: US Social Determinants of Health Data (2014).
• vehicle_pts: Point locations of abandoned vehicles in Chicago in September 2016.

Similar Packages

Interested in finding more R packages with spatial data included? Check out:

• spData: package with large variety of spatial datasets, accompanies the Geocomputation with R book.
• tidycensus / tigris: API package for US Census data

geodadata's Issues

Fix nyc dataset documentation

Variable names don't match up to documentation, discovered in devtools::check(). Mentioned by Jakub in #8:

One other thing that need to be solved is the documentation of nyc:

 checking for code/documentation mismatches ... WARNING
  Data codoc mismatches from documentation object 'nyc':
  Variables in data frame 'nyc'
    Code: CODE FORHIS06 FORHIS07 FORHIS08 FORHIS09 FORWH06 FORWH07
          FORWH08 FORWH09 HHSIZ00 HHSIZ02 HHSIZ05 HHSIZ08 HHSIZ1990
          KIDS2000 KIDS2005 KIDS2006 KIDS2007 KIDS2008 KIDS2009 NAME
          PUBAST00 PUBAST90 RENT2002 RENT2005 RENT2008 RENTPCT02
          RENTPCT05 RENTPCT08 SUBBOROUGH YRHOM02 YRHOM05 YRHOM08 bor_subb
    Docs: FORHIS06 FORWH06 HHSIZ00 HHSIZ02 HHSIZ1990 KIDS2000 PUBAST90
          RENT2002 RENTPCT02 YRHOMO02

I do not know what is the best solution here: (a) list all of the variables in the documentation, (b) remove this list entirely, (c) something else?...

Add LICENSE

Add checks for sf, or move sf to Imports

Otherwise datasets print weirdly in console and users may get confused

Double check CRS on datasets

Ohio lung dataset is projected, but no CRS is set

Add pkgdown site

Include list of datasets included in pkg, and documentation

Use Github Actions to test pkg

See instructions for how to do so with usethis!

Add plots to documentation

Mentioned by Robin (#7 (comment)), Jakub agreed in #8:

I agree with @Robinlovelace's comment related to adding plots to the documentation.
You just need to add the if (requireNamespace("sf", quietly = TRUE)) bit in examples - see it here - https://nowosad.github.io/spData/reference/alaska.html.

Nice example of how to use datasets in workshops / teaching

Just one dataset, structured around a vignette: https://github.com/nhs-r-community/NHSRdatasets

Check types of datasets

chicago_comm has factors for community! Double check that sample data will work with tutorials (I think they should), and that types are right, and the same as those included in the tutorials.

Update README

• Edit Wiki link
• Include CRAN installation instructions (wow!!!)
• Add some swanky badges
• Reference {rnaturalearth}, other spatial data pkgs

Get package to CRAN

I'd love some support reviewing this geospatial data package before trying to submit it to CRAN! I plan to go through and check it according to the rOpenSci packaging guide, but would love some input from those who have submitted geospatial data packages to CRAN before.

@Nowosad @Robinlovelace I love what you did with spData, do you have any advice (general or specific) for making this package better for CRAN?