Read in STATS19 road safety data from .csv files downloaded.
Usage
read_accidents(
year = NULL,
filename = "",
data_dir = get_data_directory(),
format = TRUE,
silent = FALSE
)Arguments
- year
Single year for which data are to be read
- filename
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.
- data_dir
Where sets of downloaded data would be found.
- format
Switch to return raw read from file, default is
TRUE.- silent
Boolean. If
FALSE(default value), display useful progress messages on the screen.
Details
This is a wrapper function to access and load stats 19 data in a user-friendly way. The function returns a data frame, in which each record is a reported incident in the STATS19 data.
Examples
# \donttest{
if(curl::has_internet()) {
dl_stats19(year = 2019, type = "accident")
ac = read_accidents(year = 2019)
dl_stats19(year = 2019, type = "accident")
ac_2019 = read_accidents(year = 2019)
}
#> Files identified: dft-road-casualty-statistics-accident-2019.csv
#> https://data.dft.gov.uk/road-accidents-safety-data/dft-road-casualty-statistics-accident-2019.csv
#> Data already exists in data_dir, not downloading
#> Data saved at /tmp/Rtmps4qdQg/dft-road-casualty-statistics-accident-2019.csv
#> Reading in:
#> /tmp/Rtmps4qdQg/dft-road-casualty-statistics-accident-2019.csv
#> Rows: 117536 Columns: 36
#> ── Column specification ────────────────────────────────────────────────────────
#> Delimiter: ","
#> chr (6): accident_index, accident_reference, date, local_authority_ons_dis...
#> dbl (29): accident_year, location_easting_osgr, location_northing_osgr, lon...
#> time (1): time
#>
#> ℹ Use `spec()` to retrieve the full column specification for this data.
#> ℹ Specify the column types or set `show_col_types = FALSE` to quiet this message.
#> date and time columns present, creating formatted datetime column
#> Files identified: dft-road-casualty-statistics-accident-2019.csv
#> https://data.dft.gov.uk/road-accidents-safety-data/dft-road-casualty-statistics-accident-2019.csv
#> Data already exists in data_dir, not downloading
#> Data saved at /tmp/Rtmps4qdQg/dft-road-casualty-statistics-accident-2019.csv
#> Reading in:
#> /tmp/Rtmps4qdQg/dft-road-casualty-statistics-accident-2019.csv
#> Rows: 117536 Columns: 36
#> ── Column specification ────────────────────────────────────────────────────────
#> Delimiter: ","
#> chr (6): accident_index, accident_reference, date, local_authority_ons_dis...
#> dbl (29): accident_year, location_easting_osgr, location_northing_osgr, lon...
#> time (1): time
#>
#> ℹ Use `spec()` to retrieve the full column specification for this data.
#> ℹ Specify the column types or set `show_col_types = FALSE` to quiet this message.
#> date and time columns present, creating formatted datetime column
# }