Locations

Introduction

A Location is a group of blocks (or staging blocks) sharing the same logic destination; for example all tracks belonging to one station. Locations may be used within schedules (see Locations and Schedules) or to manage a hidden yard utilizing Flow Management (see below).

Limitations

FiFo cannot be used if one or more location blocks is of type Staging Block.

Index


A list of all defined locations.

New

Creates a location “NEW”.

Delete

Deletes the selected location from the list.

Apply

Overwrites the name of the selected location with the name typed into the name field.

Blocks


A list of all blocks belonging to the selected location.
The first one in the list which does match train type and is free will be selected as destination in combination with schedules.

  • The list order, first main then sub, has both effect when a train is running random or with a schedule to a location.
  • Main blocks in multiple locations are not supported.
  • Sub blocks are not included in the flow management.

Drop down list

The block to be added to the location is selected from the drop down list.

Add

The block selected from the drop down list is added to the location.

Delete

The selected block is deleted from the location.

Up/Down

Move a location block up or down in the list to change priority.

Flow management

The flow management of a location controls outgoing trains and is very well suited to manage hidden yards: The minimal occupancy grants the yard remains partly filled while the FiFo option allows the trains to exit alternately.

Requirements

  • It has to be ensured the trains have to stop in the location. The wait option of all blocks covered by the location has to be enabled (see Block General).
  • The block type should be set to Others (see Block Details).
  • The Mainline Block option must be disabled. :!:


Details


Options

The flow management is controlled by the following two parameters:

Minimal Occupied

Setting this option to values greater than zero will activate the location flow of trains.
No train is allowed to depart if the number of trains is lower than this value.
Or with other words:
Only if the number of trains in the location is equal or greater than this value a train is allowed to exit the location.

With hidden stations this allows to control the amount of traffic on the layout: If in a hidden yard consisting of five tracks four trains are always to remain the value has to be set to five (a train is allowed to depart not until five trains are in the yard). Rule of thumb: Number of trains to remain in the yard plus one. The maximal reasonable value is equal to the number of tracks in the yard.

  • If the minimal occupancy is not reached no train will depart from the location in auto mode even if, for instance, it is attempted to move the train by means of drag and drop. To move a train out of the location under this condition
    • either the train is (re) started (see below)
    • or the auto mode has to be switched off and the train has to be controlled manually, e. g. by means of a Rocrail throttle.
  • With a train (re)Start command the minimal occupancy can be overwritten one time per (re)start command:
    • If the train is in auto mode already a single start command from the context menu will start it.
    • If the train is not in auto mode, the first start command will set it in auto mode and a second start command will allow it to depart.
  • Schedules may be used together with flow management. However, the Time Processing of the respective schedule should be set to Relative as the flow management takes priority over the schedule's departure times.
  • If a train has already received the exit permit, but has not yet left the block, he is no longer counted in the minimum occupation.
    Even if only because the minimum occupation of the location - seemingly - would be given no other train can drive out.

Fifo

In conjunction with Minimal Occupied (see above) this option will allow departing trains to regard the “First in, first out” rule.

  • If the FiFo option is activated trains do depart in strict rotation.
  • All trains in this location must be in automatic mode to enable flow and to prevent a deadlock situation.
Remark: After a restart the Fifo will be initialized; the order of entering before the restart is not preserved.
Remark: There is no FiFo without a Minimal Occupied greater than zero.

Example

Location 1 has FiFo active and minimal occupancy 3.
Location 2 has FiFo active and minimal occupancy 2.

Put Rocrail in automode and start all locos.

Example 2

Location “Schattenbahnhof” has FiFo active, minimal occupancy 3, permission nothing chosen.
Location “Fernverkehr” has FiFo active, minimal occupancy 2, permission of type “Intercity”.
Location “Güterverkehr” has FiFo active, minimal occupancy 2, permission of type “Freight”.

“Ortschaft” = Location
Put Rocrail in automode and start all locos.


Dynamic Text

With the XMLScript command “info” an overview of a location can be set in a Text object.

<?xml version="1.0" encoding="UTF-8"?>
<xmlscript>
  <location id="Blaak" cmd="info" svalue="tx1"/>
</xmlscript>

All loco's are checked if they have a schedule assigned, and the schedules will be scanned if blocks are in it for the selected location.

Line Format

Depart time,Destination Location ID,Block ID,Train/Loco ID,Optional text|

Personal Tools