Track-related System-Item Attributes

Planimate automatically maintains a number of system-item attributes as trains move along a track network. These are useful to modellers generating logs and graphs of the train movement which occurs.

These simplify management of routines executed as trains move through the network:

The following are system attributes maintained for each train item:

---

Name
Read / Write
Description

---

Item Route ID

R

When an Item is assigned a Route to traverse a Rail Network, this is the ID for that Route. Corresponds to its index in the _Model Routes System Label List.

Item Route Step

R/W

When an Item assigned a Route moves across a Rail Network, as it completes each step by arriving at the next Object named in the Route, its Route Step Attribute will be incremented.

Item Stopping

R

When an Item enters a Loop Object on a Rail Network, it will know whether it has to stop to allow a train to pass it in one direction or another. If it does have to stop, this attribute can be read. (>1 = Stopping; 0 = Not Stopping).

Item Booking ID

R/W

Required for calculation operations to support adding bookings to a section; reading back all bookings from a section; clearing a sections bookings. Sections are read and written using a table which must have the following columns: "_book id" identifier of the item which the section is booked for. An integer >= 1. Only the item whose system attribute "booking id" matches will have access to the section during the booked interval "_from"; "_to" Specify the time range over which the section is booked

Track Last Section ID

R

Gives the object label index of the last section the train entered.

Track Last Section Road

R

Gives the road number the item travelled on the section that the train last entered.0 for single road; for multi-road sections its 1,2 (or 3 for triple track) When an Item leaves a Track Section in a Rail Network, the Road that it travelled on is recorded. This enables you to track the progress of a train item in great detail. Consistency of results will depend on the 'direction' in which you have laid the track objects.

Track Loop Exit Start

R

This gives the time that a train began to leave the previous loop or portal. If its a loop and a loop exit delay was set and actually required, this is the start time of the loop exit delay.

Track Loop Exit End

R

This gives the time that a train actually began to move on the previous section. If the object is a portal or a loop with no exit delay, this time will be the same as the Track Loop Exit Start time.

Track Loop Entry Start

R

This gives the time that a train arrived at a loop or portal. If its a loop and a loop entry delay was set and required, this is the start time of the loop entry delay period (during which the section remains unavailable and the train cannot leave the loop).

Track Loop Entry End

R

This gives the time that train completed arrival at a loop or portal. If the object is a portal or a loop with no entry delay, this time will be the same as the Track Loop Entry Start time.

Track Section Nominal Time

R

Gives the nominal running time for the section that the train last used, as compared to the actual running time which can be influenced by section restrictions.