Repository navigation
Glossary
MaartenHilferink edited this page Nov 7, 2026
·
23 revisions
The terms 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, Cric, Cr or Cn. |
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 or ovfC. |
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 |
| 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
|
| 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 |
| 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; NS (L) and regional transport (R and O) are separate groups. | FareGroup |
| Fixed price and variable price | The amount per boarding and the amount per kilometre of a ride, from the fare tables or the DOVA overview. |
FixedPrice, VariablePrice
|
| Tariff units | The distance unit of the NS fare between two stations. | SourceData/Infrastructure/OVprijzen/NS/TariffUnits |
| Concession area | The area in which one operator runs regional transport under one concession; the fare of a ride depends on it. | SourceData/Infrastructure/OVprijzen |
| Trip surcharge | The extra amount per ride on special trains, such as the HSL between Schiphol and Rotterdam 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; batch\UpdateAll.cmd computes one component per GeoDmsRun step. |
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
|
| 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
|
| 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 beats on every criterion; a relative epsilon on travel time keeps options that are only slightly faster out. |
pareto_optimal_eps; ModelParameters/Advanced/ChainParetoTimeEpsilon
|
| OD pair | An origin and a destination; with OD_Origin and OD_Destination set, a run calculates one OD pair with the routes of its options. |
ModelParameters/OD_Origin, OD_Destination
|
| 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. | ModelParameters/Impl/Analysis_date |
| Part of the day | The hour of the analysis, such as the morning rush hour, with its departure moments and its congestion moment. |
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, MaxWaitingTimeAtOrigin
|
| Congestion moment | The moment of the TomTom speed profile that the direct car trip uses: MorningRush, NoonRush, LateEveningRush or Freeflow. | ModelParameters/Impl/Car_CongestionMoment_ForDirect |
| 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, MaxOrgBlockSize
|
| 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. |
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 How to run the model). |
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 source caches have no signature: their name holds their edition. The name of a cache holds a hash of its signature. | Templates/Signature_T |
| Revision | A part of a signature that is raised with a code change that changes the content of a cache, so that the old cache is no longer read. |
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.