knitr::opts_chunk$set( collapse = TRUE, comment = "#>" )
The FARSfunctions
package works with data from the Fatalities Analysis Reporting System. FARS is a nationwide census of fatal injuries suffered during motor vehicle crashes. The data includes all 50 states, the District of Columbia and Puerto Rico.
The principle function in FARSfunctions
is fars_map_state
, which takes produces a simple geographic plot of the given state with all traffic fatalities for the given year plotted as points. Below is an sample plot from the call fars_map_state(1, 2015)
where 1 is the state code for Alabama.
# get functions source("../R/fars_functions.R") # example plot fars_map_state(1, 2015)
The core function of FARSfunctions
is fars_map_state
. The function takes two arguments, the state number, which is an integer code assigned to states in an order roughly corresponding to the alphabetical order of the state names, and an integer, four-digit year marking the dataset to get.
fars_map_state
includes several internal calls to functions for formating a file name using the given argument values, reading in the dataset for the given year, formating the data, and plotting it.
# example call to mapping function state <- 48 ## state number for Texas year <- 2015 fars_map_state(state.num = state, year = year)
A call to fars_map_state
includes a call to a formating helper function that returns a character vector with the dataset file name to be read. The file name format is "accident_[year].csv.bz2". The substring year is supplied by the user as the year argument in the call to fars_map_state
. As can be seen from the example, the dataset file type is bz2 zipped comma separated values file. Another helper function uses the constructed character vector to search for the file in the working directory. An exception is raised if the file is not found or is not of the correct file type.
The package also includes fars_summarize_years
, a function for summarizing fatalities by state and year in tabular format.
# example output of summarize function fars_summarize_years(2015)
More information on FARS and the datasets used with this package can be found at the FARS Encyclopedia website.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.