In akbarpunjwani/msdr-rpkgexample: FARS Accident Data & Plots

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)

fars

The goal of fars is to provide summary counts of accidents that occurred at different states during the years 2013, 2014 & 2015. Also, it provide the scatter plots to visualize the same data for each state.

Installation

You can install the released version of fars from CRAN with:

library(devtools)
install_github("akbarpunjwani/msdr-rpkgexample")
library(fars)

The FARS, which stands for Fatality Analysis Reporting System, provided a sample data set for public access to analyze the accidents held in 2013, 2014 & 2015.

This package includes this data for internal use only. However, this package uses that data and provides a year wise summarized counts (fars_summarize_years) and the state wise visualization plots (fars_map_state) for specified year.

Data Summary

The FARS Accidents data has a time series information of MONTH and YEAR of the accidents. In order to load & view the counts of accidents for each of the 12 months for the specified years, below method can be used:

fars_summarize_years(years_range) Since the package includes the dataset of FARS for the years 2013 to 2015, the output would display the counts having months at row level and years at the column level. In case any of the year specified in the range is not found than it will show the result for the years found and mention the warning for those that were not found.

Examples: fars::fars_summarize_years(2013)

fars::fars_summarize_years(2013)

fars::fars_summarize_years(2014:2015)

fars::fars_summarize_years(2014:2015)

fars::fars_summarize_years(2012:2016) (Warnings expected for 2012 & 2016)

fars::fars_summarize_years(2012:2016)

sample <- 1:10

Data Visualization

The FARS Accidents data contains US STATE number where the accident occured at the given MONTH and YEAR. The package uses this data to visualize it into a scatter plot for each state, using the below mentioned method:

fars_map_state(state,year)

Since the package includes the dataset of FARS accidents having state (1 to 13), month & year (not all years have data for each of the state), this method helps the user to visualize the data for the specified state and year. In case any of the state or the year specified is not found than it will prompt an error accordingly.

Examples:

fars::fars_map_state(1,2013)