Field guide
Find out what the railway’s words mean in Britain and the Bay Area, and how Trainiac knows where every train is.
Start hereHow Trainiac gets its dataTrainiac reads the timetables and live updates that each railway publishes, and keeps a copy of everything it gets.Read it →
How Trainiac works
Where Trainiac gets its trains and times, and what it does with them
- How Trainiac finds your trainTo log a journey, you tell Trainiac where you got on and off and on which day, then pick your train from a list.
- Frozen journeysA frozen journey is the copy of a train’s details that Trainiac saves to your account when you log a journey.
- Older tripsTrainiac can only find an older trip in Britain if it has a copy of that day’s timetable.
- Imported ticketsYou can bring your past Trainline bookings into Trainiac. Each one becomes a journey linked to the real train.
- On this trainThe “On this train” card shows who else logged the same train as you and was on board at the same time.
- “Likely” train classFor a train in Britain, Trainiac guesses its class from two codes in the timetable.
- Which time Trainiac showsA stop can have a planned time, an expected time and a real time. Trainiac shows you the best one it has.
- How the live map places trainsTrainiac’s live map places each train in Britain using signalling messages, then moves it along the track between them.
- How journey routes are drawnIn Britain, Trainiac draws each journey along the real track and measures its distance the same way.
The Bay Area
What Trainiac knows about Caltrain and BART, and where it comes from
- Caltrain and BART in TrainiacTrainiac covers Caltrain and BART in California, using files they publish through 511.org.
- CaltrainCaltrain runs from San Francisco to San Jose, and a few trains go on to Gilroy.
- BARTBART is an electric railway that runs under San Francisco Bay to Oakland, Berkeley and beyond.
- Guessing the train in the Bay AreaIn the Bay Area, Trainiac guesses the type of train from the route it ran on.
- Local timesTrainiac shows every journey in the local time of its stations, wherever you are when you look at it.
- 511.org511.org is the Bay Area’s travel information service, and it publishes every local operator’s data.
- GTFSGTFS is the timetable format Caltrain, BART and most of the world’s buses, trams and trains publish in.
- Trip updatesA trip update gives a Caltrain or BART train’s expected times at the stops it hasn’t reached yet.
Trains & services
What trains are called, how they’re numbered and what kinds there are
- HeadcodeA headcode is the four-character name, like 1A23, that signallers see for a train on Britain’s railway.
- Train UIDA train UID is a code made of a letter and five digits, like C12345, that Britain’s timetable gives each schedule.
- Train runA train run is one train on one day, with that day’s own delays, platform changes and cancellations.
- TRUST train IDTRUST, Network Rail’s train reporting system, gives each train a ten-character ID for the day, called its TRUST train ID.
- OperatorThe operator is the company that runs a train in Britain, such as Great Western Railway or Northern.
- Train classIn Britain, a train class is the model number of a train, so a Class 390 is a Pendolino.
- Multiple unitMost passenger trains in Britain are multiple units. A multiple unit is a set of carriages with motors underneath and a cab at each end.
- FormationA train’s formation is the set of units or carriages it’s made up of on a particular day.
- Carriage numberEvery carriage in Britain has its own number, usually five digits long, and it keeps that number for life.
- Empty coaching stockEmpty coaching stock is a passenger train running without any passengers, often to or from a depot.
- Freight trainA freight train carries goods such as containers, stone or steel. In Britain, freight trains share the tracks with passenger trains.
- VSTPA VSTP schedule is a train planned too late for Britain’s daily timetable, so it’s sent out on its own.
- STP and overlaysSTP, short for short term planning, is how Britain’s timetable changes a train’s regular schedule on particular dates.
Places
The codes the railway uses for stations, junctions and other places
- CRS codeA CRS code is the three-letter code for a station in Britain, like PAD for London Paddington.
- TIPLOCA TIPLOC is the code Britain’s railway timetable uses for a place, like PADTON for London Paddington.
- STANOXA STANOX is the five-digit number that TRUST, Network Rail’s train reporting system, uses for a place on Britain’s railway.
- CORPUSCORPUS is Network Rail’s list of places on the railway, with each place’s name and all its codes.
- Timing pointA timing point is any place where a train has a time in Britain’s timetable, even if it doesn’t stop there.
- JunctionA junction is where railway lines meet or split.
- BerthA berth is a section of track on a signaller’s screen, usually the stretch leading up to a signal.
- Signalling areaA signalling area is the part of Britain’s railway controlled from one signal box or control centre.
- SMARTSMART is Network Rail’s list of which berth moves mean a train has arrived at, left or passed a place.
The timetable
How the railway writes down when trains should run
- CIF timetableCIF, the Common Interface File, is the format Network Rail uses to publish Britain’s timetable each day.
- Timetable changeBritain’s railway starts a new timetable twice a year, on a Sunday in May and a Sunday in December.
- Working timetableThe working timetable is the detailed timetable Britain’s railway runs to, with more in it than the one passengers see.
- Half-minute timesBritain’s working timetable marks half-minute times with an H, so 1435H means 30 seconds after 14:35.
- Days runBritain’s timetable says which days a train runs with seven digits, one for each day of the week from Monday.
- PlatformA train’s platform is planned in its schedule, but in Britain it can change on the day.
Live data
The systems that report where trains are and when they’ll arrive
- TRUSTTRUST is Network Rail’s system for recording when each train reaches the places in its schedule.
- ActivationAn activation is the message Network Rail’s TRUST system sends when it starts tracking a train for the day.
- Movement reportA movement report is a message from Network Rail’s TRUST system saying when a train arrived at, left or passed a place.
- CancellationA cancellation is a message from Network Rail’s TRUST system saying a train won’t run, or won’t run all the way.
- Train DescriberThe Train Describer is the system that moves each train’s headcode along a signaller’s screen in Britain.
- Berth stepA berth step is a Train Describer message saying a train’s headcode has moved into the next berth.
- DarwinDarwin is National Rail’s system for predicting train times in Britain. Station departure boards get their times from it.
- ForecastA forecast is Darwin’s prediction of when a train will arrive at or leave a stop.
- Delayed, no estimate“Delayed, no estimate” means Darwin knows a train is late but can’t yet say by how much.
- On timeBritain’s railway has more than one rule for whether a train counts as on time.
Open data feeds
The free data Trainiac and other apps are built on
- Open data feedsNetwork Rail and National Rail publish Britain’s train data as open data feeds, free to anyone who signs up.
- STOMPSTOMP is the set of rules, or protocol, that Britain’s live rail data feeds use to send messages to anyone connected.
- Temporary speed restrictionA temporary speed restriction is a lower speed limit put on a stretch of Britain’s track for a while.