Skip to content

Latest commit

 

History

History
50 lines (43 loc) · 3.14 KB

paper.md

File metadata and controls

50 lines (43 loc) · 3.14 KB
title tags authors affiliations date bibliography
stats19: A package for working with open road crash data
stats19
crashes
dft
road safety
name orcid affiliation
R Lovelace
0000-0001-5679-6536
1
name affiliation
M Morgan
1
name orcid affiliations
L Hama
0000-0003-1912-4890
1
name orcid affiliations
M Padgham
0000-0003-2172-5265
2
name index
Institute for Transport Studies (ITS) and Leeds Institute for Data Analytics (LIDA), University of Leeds
1
name index
ATFutures GmbH.
2
19 December 2018
paper.bib

Summary

stats19 provides functions for downloading and formatting road crash data. Specifically, it enables access to the UK's official road traffic casualty database, STATS19 (the name comes from the form used by the police to record car crashes and other incidents resulting in casualties on the roads). Finding, reading-in and formatting the data for research can be a time consuming process subject to human error, leading to previous (incomplete) attempts to facilitate the processes with open source software [@lovelace_stplanr_Inpress]. stats19 speeds-up these data access and cleaning stages by streamlining the work into 3 stages:

  1. Download the data, by year, type and/or filename. An interactive menu of options is provided if there are multiple matches for a particular year.
  2. Read the data in and with appropriate formatting of columns.
  3. Format the data so that labels are added to the raw integer values for each column.

Functions for each stage are named dl_stats19(), read_*() and format_*(), with * representing the type of data to be read-in: STATS19 data consists of accidents, casualties and vehicles tables, which correspond to incident records, people injured or killed, and vehicles involved, respectively.

The package is needed because currently downloading and formatting STATS19 data is a time-consuming and error-prone process. By abstracting the process to its fundamental steps (download, read, format), the package makes it easy to get the data into appropriate formats (of classes tbl, data.frame and sf), ready for for further processing and analysis steps. We developed the package for road safety research, building on a clear need for reproducibility in the field [@lovelace_who_2016] and the importance of the geo-location in STATS19 data for assessing the effectiveness of interventions aimed to make roads safer and save lives [@sarkar_street_2018]. A useful feature of the package is that it enables creation of geographic representations of the data, geo-referenced to the correct coordinate reference system, in a single function call (format_sf()). The package will be of use and interest to road safety data analysts working at local authority and national levels in the UK. The datasets generated will also be of interest to academics and educators as an open, reproducible basis for analysing large point pattern data on an underlying route network, and for teaching on geography, transport and road safety courses.

References