Path entry matchers

Some of the timetable transformations, incidents and amendment are applied on a specified entry of the train timetables, or between two entries.

You can select:

• All entries, with any
• An entry directly by its station short code.
• A list of entries listing their station code, comma separated.
• All entries of a segment with between <start> and <end>.
• Entries matching a logical expression. The pattern of these expression generally is <entry property> <operator> <value>.

The comparison operators for strings, numeric, date or time properties include: >, <, >=, <=, ==, and !=. For easier embedding of expressions inside XML documents (for example, Driving policy documents, Timetable transformation documents), these operators are aliased with the mnemonic comparison operators: gt (greater than), lt (less than), le (less than or equal to), ge (greater than or equal to), eq (equal to), neq (not equal to). Furthermore, is and is not are aliases for == and !=.

To match a single-valued property agains a list of values, use the in or the not in operators; to match any value of a list-valued property against a given value use the contain operator, or its alias contains. The following sections explain the meaning of each available property, and provide an example of their use.

tip

When a station name, trainset name etc. contain spaces or special characters, it must be double quoted. Special characters are all symbols except underscore, hash (#), minus, plus, dot, at (@).

Path entries

Entry type

Possible entry types are: Stop, Pass, Turnback, ServiceStop, SetDownOnly, PickUpOnly, RequestStop.

type = Turnback

To write expression more fluently, there are some aliases available. To match any stop entry type (Stop, Turnback, ServiceStop, SetDownOnly, PickUpOnly, RequestStop):

stopping

To match only revenue stops of passenger trains, use calling.

Calling

Describing a passenger train stopping at a station to allow passengers to alight or board.

From Ian Ellis, Ellis' British Railway Engineering Encyclopaedia, 4th edition

calling

Non stopping trains:

passing

Intermediate stop or destination:

arriving

Origin or intermediate stop:

departing

Train origin entry

origin

Train destination entry

destination

Turnback

turnback

Planned time

arrival time < 07:00:00
departure time > 08:00:00
arrival time between 11:00:00 and 12:30:00
departure time between 23:00:00 and 02:30:00 from LIVST

Stop time

The planned stop time.

stop time < 03:30

Station name

station = ILFORD

Station designators

Stations may have, in addition to the station code and station name, additional names called designators that identity that station in external systems, interfaces, interchange file formats, etc. Designators are assigned to stations by registers, according to the RailML nomenclature. Typical registries in the UK infrastructure model are TIPLOC (Timing point location), STANOX (Station number), STANME (Station name), CRS (Computer reservation system), NLC (National location code) and NLCDESC (National location code description).

The following example matches all station with a designator equal to LST assigned by the 'CRS' register (London Liverpool Street).

station designator CRS = LST

The following example matches all station with a designator equal to 696500 assigned by the 'NLC' register (London Liverpool Street).

station designator NLC = 696500

The following example matches all station with a designator equal to LIVERPOOL ST CROSSRAIL assigned by the 'NLCDESC' register (London Liverpool Street low level).

station designator NLCDESC = 'LIVERPOOL ST CROSSRAIL'

Please note that register and designators containing a space must be quoted.

Station type

Possible station types are: Station, Junction, Halt, Other.

station type = Halt

Station load factor

The Station Load Factors are defined in Treno, and imported to Trenissimo using the Import Macro from Treno action.

station load factor = HBF

Station group

The Station Groups are defined in Treno, and imported to Trenissimo using the Import Macro from Treno action.

station group = Holdeplass

Station track

station track = 7

Line or line track

inbound line = EL
inbound line track = EL/Down
inbound line not in (EL, ML)
outbound line = ML
outbound line track = ML/Up
outbound line not in (EL, ML)

Trainset name

The trainset of the train arriving or leaving . Outboud is implied when direction is not specified.

outbound trainset = 345
inbound trainset not in (EMU390, EMU370)

Trainset length

The supported measure units are m (meter) and yd (yard). Outboud is implied when direction is not specified.

trainset length > 120 m
outbound trainset length > 120 m
inbound trainset length > 120 m

Other trainset properties

trainset maximum speed > 200 km/h
trainset weight > 1200 t
trainset parts >= 3
trainset speed type = MU
outbound trainset engines contains EMU390
inbound trainset name = "EMU390/3"
trainset weight > 1600 t

Peak hour

peak hour

Trainset change

trainset change

Connection

In Treno and Trenissimo, connections are attach, detach and turnaround activities.

connection

Interpolation

Treno planning tool can automatically interpolate missing passing times, when importing timetables from other systems or tools. To exclude interpolated entries:

not interpolated

All entries in a segment

All entries from ILFORD to SHENFLD, including both ILFORD and SHENFLD

between ILFORD and SHENFLD

All entries from ILFORD to SHENFLD, excluding ILFORD

between ILFORD excluded and SHENFLD

All entries from SHENFLD to LIVST, excluding LIVST

between SHENFLD and LIVST excluded

tip

In addition to defining a section using station codes, is also possible to use any other entry expression. The parentheses are required to avoid ambiguous interpretation of complex expressions. To select all entries from the origin of the train up the entry preceding ILFORD:

between (origin) and (station = ILFORD) excluded

Other entry matchers

Select the first / last entry / stop / pass / arrival / departure / station track / station stop after / before a different entry.

• stop matches both intermediate stops and origin or destination entries.
• arrival matches intermedia stops or destination entries.
• departure matches origin entries or intermediate stops.
• station track matches any entry at a station track, i.e. a track with a name, belonging to a station. In Treno v3.2, only Stations may have named track, Junction, Halts or other kind of control points have only unnamed tracks. From a microscopic perspective, Station tracks are marked by a Station track joint. Unnamed tracks may only have Station reference joints.
• station stop matches a stop on a station track.

first station stop after LIVST
last pass before SHENFLD

These expression differ from <expression> at next/previous ...:

• first station stop after LIVST matches only the first stop after LIVST, no matter which type of entry is at LIVST. For a given train, at most one entry can match this expression.
• station code = LIVST at previous stop matches any pass entry after LIVST, or the first stop after LIVST. There is no guarantee that only one entry fa given train matches this expression.

Other train matchers

Select an entry only if the previous / next train arriving from the same line track or departing towards the same line track is within a given interval.

previous arriving train within 2 minutes

Actual path entries

Arrived

The train has already arrived at the station.

arrived

Departed

The train has already left the station.

departed

Stopped at station

The train is currently stopped at the station.

stopped

Delay

The arrival or departure or passing delay at the specified entry. The train must be at least arrived at the station, otherwise this expression won't be applied. delay > 01:30

Arrival delay

The arrival delay at the specified entry. Valid only it the train is already arrived at that station.

arrival delay > 01:30

Departure delay

The departure delay at the specified entry. Valid only it the train is already departed from that station.

departure delay > 01:30

Estimated arrival delay

The estimated arrival delay at the specified entry. Valid only for trains already departed from their origin.

estimated arrival delay > 01:30

Estimated departure delay

The estimated departure delay at the specified entry. Valid only for trains already departed from their origin.

estimated departure delay > 01:30

Dwell time delay

The dwell time delay at the specified entry. Valid only it the train is already departed from that station. The following expressions are equivalent:

dwell time delay > 01:30
stop time delay > 01:30

Expression on the whole train

A path entry matcher can refer to an entire train, for example the following expression checks that the entry is at a station, that the estimated departure delay is higher than 01:30 and that the train origin is LIVST.

station type = Station and estimated departure delay > 01:30 and train origin = LIVST

warning

The syntax for this type of expression requires brackets where there may be ambiguities, for example with the use of and, or and not.

<expr on entry> and train <expr on train>
<expr on entry> and train (<expr on train> or <expr on train>)
<expr on entry> and train (<expr on train> and <expr on train>)
<expr on entry> and train (not <expr on train>)