read_casualties

Read in STATS19 road safety data from .csv files downloaded.

Work with and download road traffic casualty data from Great
Britain. Enables access to the UK's official road safety statistics,
'STATS19'. Enables users to specify a download directory for the data,
which can be set permanently by adding `STATS19_DOWNLOAD_DIRECTORY=/path/to/a/dir`
to your `.Renviron` file, which can be opened with `usethis::edit_r_environ()`.
The data is provided as a series of `.csv` files.
This package downloads, reads-in and formats the data, making it suitable
for analysis. See the stats19 vignette for details. Data available from
1979 to 2025. See the official data series at
<https://www.data.gov.uk/dataset/cb7ae6f0-4be6-4935-9277-47e5ce24a11f/road-accidents-safety-data>.
The package is described in a paper in the Journal of Open Source Software
(Lovelace et al. 2019) <doi:10.21105/joss.01181>.
See Gilardi et al. (2022) <doi:10.1111/rssa.12823>,
Vidal-Tortosa et al. (2021) <doi:10.1016/j.jth.2021.101291>,
Tait et al. (2023) <doi:10.1016/j.aap.2022.106895>, and
León et al. (2025) <doi:10.18637/jss.v114.i09>
for examples of how the data can be used for
methodological and empirical research.

Robin Lovelace

stats19

Work with Open Road Traffic Casualty Data from Great Britain

Malcolm Morgan

Layik Hama

Mark Padgham

David Ranzolin

Adam Sparks

Ivo Wengraf

RAC Foundation 

Blaise Kelly

Roger Beecham

read_casualties function

<dl><dt>year</dt>
<dd>Single year, or vector of years, for which data are to be
read. Use <code>"all"</code> (or any year before 2021) to read the full 1979-latest
dataset in one file; see <code>find_file_name()</code> for details.</dd>
<dt>filename</dt>
<dd>Character string of the filename of the .csv to read, if this is given, type and
years determine whether there is a target to read, otherwise disk scan would be needed.</dd>
<dt>data_dir</dt>
<dd>Where sets of downloaded data would be found.</dd>
<dt>format</dt>
<dd>Switch to return raw read from file, default is <code>TRUE</code>.</dd></dl>

Arguments

Read in STATS19 road safety data from .csv files downloaded. — read_casualties

<dl>

<dt>year</dt>
<dd>Single year, or vector of years, for which data are to be
read. Use <code>"all"</code> (or any year before 2021) to read the full 1979-latest
dataset in one file; see <code>find_file_name()</code> for details.</dd>


<dt>filename</dt>
<dd>Character string of the filename of the .csv to read, if this is given, type and
years determine whether there is a target to read, otherwise disk scan would be needed.</dd>


<dt>data_dir</dt>
<dd>Where sets of downloaded data would be found.</dd>


<dt>format</dt>
<dd>Switch to return raw read from file, default is <code>TRUE</code>.</dd>

</dl>

Read in STATS19 road safety data from .csv files downloaded.

read_casualties: Read in STATS19 road safety data from .csv files downloaded.

Description

Usage

Arguments