Repository navigation
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.
- A journey and its parts
- Timetable and network
- Fares
- What a run calculates
- Time
- Origins, destinations and blocks
- Caches
| 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 |
| 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 |
| 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.
| 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
|
| 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
|
| 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
|
| 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
|
NetworkModel PBL documentation
© Object Vision BV. Documentation under CC BY-SA 4.0, source code under GNU GPL v3.