Skip to content

Glossary

MaartenHilferink edited this page Nov 9, 2026 · 21 revisions

This page lists the terms that the model, its configuration and this wiki use, with the item where each term lives in the configuration. The terms of a journey go back to the definitions agreed in #4; the timetable terms follow GTFS.

Contents


A journey and its parts

Term Meaning In the configuration
Journey The travel from an origin to a destination that leaves at one departure moment.
Option One journey in the Pareto front of an OD pair at a departure moment, with its travel time, price and other criteria. The output has one row per option. tt_<moment>_<block> in the output folder
Part A piece of a journey in the order of travel: the pre-transport leg, each ride, each transfer and the post-transport leg; a direct trip is one part. Walking to the first stop, a ride by bus, a transfer, a ride by tram and walking from the last stop are five parts. Parts in the output of an OD pair (OD_Output), with its kind in PartKind
Leg The walking or cycling part of a public transport journey between a place and a stop: the pre-transport leg from the origin to the first boarding stop, or the post-transport leg from the last alighting stop to the destination. Walking between two stops at a transfer belongs to the transfer, not to a leg. PublicTransport_Prep/Legs/<type>
Pre-transport The leg from the origin to the first stop: walking or cycling. Its type is W, C, Crm, Crmt or Cr. ModelParameters/PreTransport (a switch per type)
Post-transport The leg from the last stop to the destination: walking, cycling or the OV-fiets. Its type is W, C, rmC, rmtC, ovfC or rC. ModelParameters/PostTransport (a switch per type)
Connection A pair of neighbourhood and stop that is reachable within the maximum walking or cycling time, with its network travel time and distance. A connection is a candidate for the pre- or post-transport leg of a journey. PublicTransport_Prep/PrePostTransport/<base set>/Connections
Connection link The link that ties an origin, a destination or a stop to the road or cycling network, so that a search can start or end there. connect_ne in Templates/CreateNetwork_Efficient_T; Templates/CreateNetwork_TomTom_T
Manual connection A link that OSM lacks and that the model adds to the network from a file digitised by hand, such as a ferry. ExtraConnections in SourceData/Infrastructure/OSM/NetworkPreperation
Base set One of the sets of connections that the model calculates once per analysis date and neighbourhood set: Org2Stops_Walking, Org2Stops_Cycling, Stops2Dest_Cycling and, when origins and destinations differ, Stops2Dest_Walking. The pre- and post-transport types are selections from them. PublicTransport_Prep/BaseSets
Ride (Dutch: rit) The part of a public transport journey in one vehicle, from the stop where the traveller boards to the stop where the traveller alights. A change of vehicle ends a ride and starts a transfer. A ride follows one route, so it lies within one fare group: regional transport outside the NS fare network (OD_R) or the NS fare network (OD_L). PublicTransport_Prep/Impl/OD_R, OD_L; item names such as ParetoLegs_R and ParetoLegs_L call a ride a leg
Transfer The change between two rides, at the same stop or by walking to a nearby one, with a minimum transfer time. PublicTransport_Prep/CreateTransfers_T
Chain The public transport part of a journey, from the first boarding stop to the last alighting stop: one or more rides with the transfers between them, with departure, arrival and price. PublicTransport_Prep/PT; the chain joiner ChainJoiner_T
Event A stop at a moment at which a ride boards or alights. The chain joiner joins rides and transfers on their events. uq_c_FromTime_Stop, uq_c_ToTime_Stop
Direct trip A journey without public transport: walking (WW), cycling (CC) or by car (Car) from origin to destination. PublicTransport_Prep/Direct

Timetable and network

Term Meaning In the configuration
Stop A place where a vehicle stops to let travellers board or alight (GTFS stops.txt). PublicTransport_Prep/Impl/Stops
Route A line, such as bus 11 or tram 5 (GTFS routes.txt).
Trip A route at one moment: one run of a vehicle along its stops (GTFS trips.txt).
Agency The operator of a route (GTFS agency.txt).
Mode The kind of vehicle: train, metro, tram, bus or ferry. Classifications/GTFS_Modes
Place The location of a stop, an origin or a destination in the network. PublicTransport_Prep/Impl/Places
Public transport node A stop that counts as a hub of public transport (Dutch: OV-knooppunt), such as a train station or a main HOV stop, derived from the GTFS feed and the departures on the analysis date. The nodes can be the destinations of a run (Destset 'OV_Knooppunten'). SourceData/Infrastructure/GTFS/PT_Hubs
Stop node A node of the export of the network in a time window: the stops within a short distance of each other that have departures or arrivals in the window, at the location of the busiest stop. Output/PT_NetworkExport/Tables/StopNodes
Time-expanded graph The public transport network in which each node is a combination of a time, a stop and a route, so that a path through it respects the timetable. Get_Windowed_Agency_Set_T
Flex A demand-responsive bus line, recognised by its name, by stop times that have to be booked or by its line number. ModelParameters/Advanced/IncludeFlex

Fares

Term Meaning In the configuration
Fare group The set of operators within which one fare applies to a whole ride. Regional transport (R) and the NS fare network (L) are separate groups. Classifications/Chains/FareGroup
Fare journey The rides that a traveller pays as one journey: an NS journey with one through fare between its first and last NS station, or an OV-chip journey in regional transport, whose rides follow each other within MaxTransferTimeForBoardingSurcharge and pay the highest boarding fare once. ChainJoiner_T; Advanced/MaxTransferTimeForBoardingSurcharge
Fixed price and variable price The amount per ride and the amount per kilometre of a row of the fare tables or the DOVA overview. FixedPrice, VariablePrice
Boarding fare The fixed price that a regional ride pays when it starts an OV-chip journey. Within one OV-chip journey the chain joiner charges only the highest boarding fare. Price_I of OD_R
Fixed fare per ride The price of a ride on a row of the detailed fare table without a price per kilometre and without a surcharge per ride, such as a ferry or an island bus. It is paid for every ride, and the ride does not start or continue an OV-chip journey. Price_S of OD_R, IsFixedFareRide
Surcharge per ride A fixed amount that a regional ride pays on top of its boarding fare and its price per kilometre, such as the flat fare of the Parkshuttle Rivium (Dutch: ritopslag). The ride stays part of the OV-chip journey and shares its boarding fare. Price_S of OD_R, column Ritopslag (RideSurcharge) of FareTable_<year>
Tariff units The distance unit of the NS fare between two stations. SourceData/Infrastructure/OVprijzen/NS/NS_TariffUnits_matrix
Concession area The area in which one operator runs regional transport under one concession. Each line gets one concession area, in which its rides find their fare. SourceData/RegioIndelingen/Concessiegebied, Route_Concessiegebied_rel
Trip surcharge The extra amount per ride on some trains: the Intercity direct and the Eurocity Direct between Schiphol Airport and Rotterdam Centraal, and the ICE. ModelParameters/Advanced/IncludeTripSurcharge

The fares are described on Public transport fares.

What a run calculates

Term Meaning In the configuration
Component A direct trip (WW, CC or Car) or a public transport journey <pre-transport>_PT_<post-transport>, such as W_PT_W, with its own output folder. Each GeoDmsRun step of batch\UpdateAll.cmd computes one component. Impl/ComponentName, Classifications/Components
Variant The components that one run computes and merges: every pre-transport type that is on with every post-transport type that is on, plus the direct trips that are on. ModelParameters, group 2; Impl/VariantComponents
Merge variant A named set of components with its own merge criteria, which a call of batch\UpdateAll.cmd -variant makes. ModelParameters/MergeVariants
Merging Combining the output of the components of the variant into one Pareto front per OD pair, as the last step of batch\UpdateAll.cmd (the component Merged). ModelParameters/Merge, NetworkSetup/ComponentMerge
Section A part of batch\UpdateAll.cmd that a call can name: checks, sources, legs, chains, cars or all. batch\UpdateAll.cmd
Criterion A quantity on which options are compared, such as price, travel time, or whether a journey needs a car or a bike. ModelParameters/MinimiseCriteria, ModelParameters/MergeCriteria
Pareto front The options of an OD pair that no other option dominates: no other option is at least as good on every criterion and better on one. Of options that are equal on every criterion, one stays. A relative epsilon on the travel time also leaves out an option that is only slightly faster than a cheaper one. pareto_optimal_eps; ModelParameters/Advanced/ChainParetoTimeEpsilon
Front before the post-transport The selection in the output step that keeps, per origin and per place where a chain arrives, only the chains with pre-transport that are in the front, before the model joins them with the post-transport legs (#140). Add_V_to_PT/Front
OD pair An origin and a destination.
OD pair mode A run for one OD pair, with OD_Origin and OD_Destination set. It keeps the route of every option, and writes its caches and output to folders of their own. ModelParameters/OD_Origin, OD_Destination, Impl/IsOD

Time

Term Meaning In the configuration
Analysis moment The reference year with its preset: the analysis date, the GTFS feed, OSM, TomTom, the CBS area division, the BAG and the OV-fiets locations. ModelParameters/AnalysisMoment, ModelParameters/AnalysisMomentPresets
Analysis date The day of the analysis; the network holds the service days before, on and after it on one time axis. AnalysisDay sets it when it is given; otherwise it is the analysis date of the preset of the analysis moment. ModelParameters/Impl/Analysis_date, ModelParameters/AnalysisDay
Part of the day The hour of the analysis, such as the morning rush hour, with its departure moments and its congestion moment. Peak and off-peak refer only to the hours of the NS fares. ModelParameters/PartOfDay, ModelParameters/PartsOfDay
Departure moment A moment at which journeys leave the origin; a journey may wait at home up to the maximum waiting time. ModelParameters/PT_DepartureMinutes_All, Advanced/MaxWaitingTimeAtOrigin
Time window The time span of the public transport network of a run: from the first departure moment to the last arrival that a journey can have, the last departure moment plus MaxPTTime, plus the wait at home when that does not count as travel time. ModelParameters/Impl/PT_LastArrivalMoment
Congestion moment The moment of the part of the day for the car: Morning, Afternoon or Evening, at 07:30, 12:30 or 19:30. On TomTom it gives the speed cap of the direct car trip and part of the signature of its caches; the time-dependent car trip itself takes the TomTom speeds of each departure moment. On OSM the car trip has the moment MaxSpeed. ModelParameters/Impl/Car_CongestionMoment_ForDirect, PartsOfDay/name

Origins, destinations and blocks

Term Meaning In the configuration
Origin set, destination set The origins and destinations of a run, such as the neighbourhoods of 2025 (Buurt2025). ModelParameters/Orgset, Destset
Origin block A part of the origins; the output step calculates per origin block, to limit memory. ModelParameters/Advanced/NumberOfOrgBlocks_All (1 block in the OD pair mode), MaxOrgBlockSize
Block part A part of an origin block that the output step calculates on its own, when the memory of a whole block would be too high. ModelParameters/Impl/OrgBlockParts, PublicTransport/PerPart
Portion The origin blocks that the output step of batch\UpdateAll.cmd calculates in one GeoDmsRun, so that memory is freed between portions. The chain step works in portions of stop blocks in the same way. ModelParameters/Impl/BlocksPerPortion, from Classifications/Components/BlocksPerPortion
Stop block A part of the boarding stops; the chain step calculates and stores the chains per stop block. ModelParameters/Advanced/NumberOfStopBlocks, MaxStopBlockSize

Caches

Term Meaning In the configuration
Cache A file or folder with intermediate results that the model writes once and reads back in later runs: the GTFS and OSM caches, the base sets, the chain cache and the car caches. The TomTom caches are source data instead (see TomTom data and caches). MakeUnlinkedData; %LocalDataProjDir%: IntermediateResults, GTFS and OSM
Decoupled Written to a cache and read back, instead of calculated in every run. ModelParameters/Advanced/PrePostTransportDecoupled
Calc, Write, Read The three items of a decoupled result: Calc calculates it, Write writes it to the cache, Read reads the cache back. for example PrePostTransport/<base set>/Calc, Write, Read
Signature The text with every setting that determines the content of a cache or an output folder. It is in the folder of the cache, or beside a parquet cache, and the model reads such a cache only when its signature matches. The name of a cache or an output folder holds a hash of its signature. The GTFS cache has no signature: its name is the date of its feed. The OSM network cache has one, because its network also depends on a few settings. Templates/Signature_T
Revision A part of a signature that is raised when a code change changes the content of a cache, so that the model no longer reads the old cache. ModelParameters/Impl/PT_Chains_Revision, CarNetwork_Revision

Clone this wiki locally