In englianhu/farsdata: farsdata R Package

library('farsdata')
library('mapdata')
library('lubridate')

This package is primarily built for educational purposes. The package enables one to explore fatal traffic accidents from 2013-2015 using data from the National Highway Traffic Safety Administration (NHTSA) Fatality Analysis Reporting System (FARS).

The Data

The data in this package come from the National Highway Traffic Safety Administration (NHTSA) Fatality Analysis Reporting System (FARS) data.

fars_2013_fn <- make_filename(2013)
fars_2013 <- fars_read(fars_2013_fn) 
dim(fars_2013)
fars_2013

For detailed information about the data, see the NHTSA FARS Manuals & Documentation page.

Loading FARS Data

To load all of the data for a given year, use the make_filename() and fars_read() functions, as shown in the previous section.

About the Filename

Use the make_filename command to find out where data is stored on your machine and/or create a filename to save/load new data.

BEWARE: re-installing the package may cause your data to be overridden

fars_2013_fn <- make_filename(2013)
fars_2013_fn

Single Year

If you wish to just look at fatality data for a a single year, use the fars_read_years() function with a single year as input. The only data columns selected are MONTH and year. This returns a list of length one, and the first element in the list is the as_tibble (the tidyverse data frame) listing the month and year for each fatal accident.

fars_2014 <- fars_read_years(years = 2014)
fars_2014[[1]]

Multiple Years

If you wish to look at fatalities for multiple years, enter a vector of years as the argument for the fars_read_years() function (examples: fars_read_years(years = c(2013, 2015)) or fars_read_years(2013:2015). Again, this returns a list of tbl_dfs, with each element of the list showing the month and year for each fatality.

fars_3yrs <- fars_read_years(years = 2013:2015)
fars_3yrs

Summarizing FARS Data

The fars_summarize_years() function take the same argument as the fars_read_years(), and produces a summary of the simple counts of fatalities by month and year:

fars_summary <- fars_summarize_years(2013:2015)
fars_summary

Mapping Fatal Crashes

Finally, the fars_map_state function takes a state ID number and a year, and maps that state's fatalities with a dot at the fatality location. Note that in order to use this function, you will likely need to load the mapdata package.

For a list of the state ID numbers, see page 26 of the FARS Analytical User's Guide (2015).

fars_map_state(53, 2014)
fars_map_state(36, 2014)

englianhu/farsdata documentation built on Dec. 12, 2021, 12:34 a.m.