trainR: An Interface to the National Rail Enquiries Systems
· 6 min read
The goal of trainR is to provide a simple interface to the
National Rail Enquiries (NRE) systems. There are few data feeds
available, the simplest of them is Darwin, which provides real-time
arrival and departure predictions, platform numbers, delay estimates,
schedule changes and cancellations. Other data feeds provide historical
data, Historic Service Performance (HSP), and much more. trainR
simplifies the data retrieval, so that the users can focus on their
analyses. For more details visit
https://www.nationalrail.co.uk/46391.aspx.
Installation
You can install the released version of trainR from CRAN with:
install.packages("trainR")
And the development version from GitHub with:
# install.packages("devtools")
devtools::install_github("villegar/trainR", "dev")
Setup
Before starting to retrieve data from the NRE data feeds, you must obtain an access token. Visit the following website for details: http://realtime.nationalrail.co.uk/OpenLDBWSRegistration/
Once you have received your access token, you have to store it in the .Renviron file; this can be
done by executing the following command:
trainR::set_token()
This will open a text file, .Renviron, add a new line at the end (as follows):
NRE="<token>"
<token> should be replaced by the access token obtained from the NRE. Save the changes and restart
your R session.
You only need to perform this configuration once.
Example (Last rendered on 2022-05-18 10:04)
Load trainR to your working environment:
library(trainR)
Arrivals board at Reading Station (RDG)
rdg_arr <- trainR::GetArrBoardRequest("RDG")
print(rdg_arr)
## Reading (RDG) Station Board on 2022-05-18 10:04:19
## Time From Plat Expected
## 10:55 London Paddington 8 11:14
## 10:58 Didcot Parkway 15 On time
## 10:58 Penzance 11 11:01
## 10:59 London Paddington 7 11:05
## 11:05 Bournemouth 8 On time
## 11:09 Bristol Temple Meads 10 11:20
## 11:11 London Paddington 9 11:21
## 11:11 London Waterloo 4 On time
## 11:12 London Paddington 14 On time
## 11:16 London Paddington 12 On time
## 11:16 London Paddington 9B 11:23
## 11:18 Cardiff Central 10 11:23
## 11:19 Basingstoke 2 On time
## 11:22 Newbury 11A On time
## 11:24 Oxford 10 On time
## 11:25 London Paddington 9 On time
## 11:27 London Paddington 7 11:29
## 11:29 Cheltenham Spa 11A On time
## 11:32 Didcot Parkway 15 On time
## 11:33 London Paddington 7A On time
## 11:33 Redhill 5 On time
## 11:36 Newbury 3 On time
## 11:38 Plymouth 11A 11:40
## 11:40 Bristol Temple Meads 10 On time
## 11:40 London Paddington 14 On time
## 11:41 London Paddington 9 On time
## 11:41 London Waterloo 6 On time
## 11:41 Manchester Piccadilly 8 On time
## 11:45 Swansea 11 11:48
## 11:46 London Paddington 12 Delayed
## 11:46 London Paddington 9 On time
## 11:50 Basingstoke 2 On time
## 11:51 Gatwick Airport 5 On time
## 11:51 London Paddington 7B On time
## 11:55 Great Malvern 10A On time
## 11:55 London Paddington 9 On time
## 11:59 Didcot Parkway 15 On time
## 12:01 Penzance 11 On time
## 12:09 Bristol Temple Meads 10 On time
## 12:10 London Paddington 14 On time
## 12:11 London Paddington 9B On time
## 12:11 London Waterloo 4 On time
## 12:14 Cardiff Central 11 On time
## 12:16 London Paddington 12 On time
## 12:16 London Paddington 9B On time
## 12:18 Basingstoke 2 On time
## 12:22 Newbury 11 On time
## 12:24 Oxford 10A On time
## 12:25 London Paddington 9 On time
## 12:27 London Paddington 7 On time
## 12:29 Cheltenham Spa 11A On time
## 12:33 Didcot Parkway 15 On time
## 12:33 London Paddington 7B On time
## 12:33 Redhill 5 On time
## 12:40 Bristol Temple Meads 10 On time
## 12:40 London Paddington 14 On time
## 12:41 London Paddington 9B On time
## 12:41 London Waterloo 6 On time
## 12:42 Manchester Piccadilly 7 On time
## 12:42 Newbury 1 On time
## 12:45 Newbury 3 On time
## 12:45 Swansea 10 On time
## 12:46 London Paddington 9B On time
## 12:48 London Paddington 12 On time
## 12:49 Basingstoke 2 On time
## 12:51 Gatwick Airport 4 On time
## 12:51 London Paddington 8B On time
## 12:54 Great Malvern 10A On time
## 12:54 London Paddington 9 On time
## 12:57 London Paddington 7B On time
## 11:26 Heathrow Central Bus Stn BUS On time
## 12:01 Heathrow Central Bus Stn BUS On time
## 12:36 Heathrow Central Bus Stn BUS On time
Departures board at Reading Station (RDG)
rdg_dep <- trainR::GetDepBoardRequest("RDG")
print(rdg_dep)
## Reading (RDG) Station Board on 2022-05-18 10:04:24
## Time To Plat Expected
## 10:58 Bristol Temple Meads 8 11:15
## 11:01 Exeter St Davids 7 11:06
## 11:04 London Paddington 11 On time
## 11:07 Basingstoke 2 On time
## 11:11 Ealing Broadway 15 On time
## 11:12 London Paddington 10 11:21
## 11:12 London Waterloo 6 On time
## 11:12 Newbury 7B On time
## 11:13 Swansea 9 11:22
## 11:15 Manchester Piccadilly 8 On time
## via Coventry & Stoke-on-Trent
## 11:19 Worcester Shrub Hill 9B 11:24
## 11:20 London Paddington 10 11:24
## 11:20 Redhill 5 On time
## 11:24 London Paddington 11A On time
## 11:26 Didcot Parkway 12 On time
## 11:26 London Paddington 10 On time
## 11:27 Bristol Temple Meads 9 On time
## 11:27 Ealing Broadway 14 On time
## 11:29 Plymouth 7 On time
## 11:32 Basingstoke 2 On time
## 11:34 London Paddington 11A On time
## 11:37 Newbury 7A On time
## 11:40 Ealing Broadway 15 On time
## 11:40 London Paddington 11A 11:40
## 11:42 London Paddington 10 On time
## 11:42 London Waterloo 4 On time
## 11:43 Cardiff Central 9 On time
## 11:48 London Paddington 11 11:48
## 11:49 Oxford 9 On time
## 11:53 Cheltenham Spa 7B On time
## 11:53 Didcot Parkway 12 Delayed
## 11:56 Newbury - On time
## 11:57 Bristol Temple Meads 9 On time
## 11:57 Ealing Broadway 14 On time
## 11:58 London Paddington 10A On time
## 12:01 Gatwick Airport 5 On time
## via Guildford
## 12:04 London Paddington 11 On time
## 12:07 Basingstoke 2 On time
## 12:09 Ealing Broadway 15 On time
## 12:12 London Paddington 10 On time
## 12:12 London Waterloo 6 On time
## 12:12 Newbury 3 On time
## 12:13 Manchester Piccadilly 8 On time
## via Coventry & Stoke-on-Trent
## 12:13 Swansea 9B On time
## 12:16 London Paddington 11 On time
## 12:18 Hereford 9B On time
## 12:20 Redhill 5 On time
## 12:23 Didcot Parkway 12 On time
## 12:24 London Paddington 11 On time
## 12:26 London Paddington 10A On time
## 12:27 Bristol Temple Meads 9 On time
## 12:27 Ealing Broadway 14 On time
## 12:29 Penzance 7 On time
## 12:32 Basingstoke 2 On time
## 12:34 London Paddington 11A On time
## 12:37 Newbury 7B On time
## 12:40 Ealing Broadway 15 On time
## 12:42 London Paddington 10 On time
## 12:42 London Waterloo 4 On time
## 12:43 Cardiff Central 9B On time
## 12:47 London Paddington 10 On time
## 12:49 Oxford 9B On time
## 12:52 Bournemouth 7 On time
## 12:53 Cheltenham Spa 8B On time
## 12:53 Didcot Parkway 12 On time
## 12:57 Bristol Temple Meads 9 On time
## 12:57 Ealing Broadway 14 On time
## 12:57 London Paddington 10A On time
## 13:01 Exeter St Davids 7B On time
## 13:01 Gatwick Airport 4 On time
## via Guildford
## 11:15 Heathrow Central Bus Stn BUS On time
## 11:50 Heathrow Central Bus Stn BUS On time
## 12:25 Heathrow Central Bus Stn BUS On time
## 13:00 Heathrow Central Bus Stn BUS On time