Version 2; the actual version.
under construction
Foreword 1:
This documentation has been created with:

Foreword 2:
The word "train" is used in this documentation. This means a locomotive with a Rocrail train. To simplify matters, only a locomotive is tested in the Rocrail workspace using the length of the locomotive to represent the length of the complete train.

A layout (1200mm x 3600mm) was designed for test purposes, which
- consists of two ovals and
- a storage area for trains and
- a storage area for locomotives (or short trains).
For this documentation only the inner oval is considered (here marked with gray and colored tracks).

Since there should be at least three Rocrail blocks in an oval, the oval was divided into four blocks:
- the two straight lines and
- the two arches.
Since the upper straight line is intersected by a switch, two small blocks were provided on the left and right side of the switch.

A short train can now travel on each block, while a long train can only travel on the two straight lines if you combine the two blocks into one block on the upper straight line. This documentation describes how to define this in Rocrail.
The colored tracks represent the sensors. The block lengths were calculated from the length between the sensors plus the length of the "enter" sensor (but without the "in" sensor).

The Rocrail blocks are shown in the first picture. They are arranged in a clockwise direction; the train always moves from the plus side into a block. This is not mandatory, but should be dealt with in this way in this documentation.

The Rocrail - blocks require an "identifier". It consists of the two letters "bk" (for the English word "block") and a two-digit number. The entire Rocrail layout uses
- block number 10 to 19 in the northern part,
- block number 20 to 29 in the eastern part,
- block number 30 to 39 in the southern part and
- block number 40 to 49 in the western part;
neither of which is mandatory, but is to be dealt with in this documentation.

The Rocrail - sensors need an "identifier". It consists of the two letters "fb" (for the English word "feedback"), a two-digit number and a plus sign or a minus sign, depending on whether the sensor is arranged on the plus side of the block or on the minus side of the block. None of this is mandatory either, but should …

The Rocrail - switches require an "identifier". It consists of the two letters "sw" (for the English word "switch") and a two-digit consecutive number. This is …

The Rocrail router assigns the sensors to the blocks and generates these block properties:

To allow a long train to stop on the upper straight line, a new "virtual block" is formed from the two blocks:
- bk1516v = bk15 and bk16
Rocrail outlines virtual blocks with dashed lines. Virtual blocks have to be created manually. While the Rocrail router can assist us with the configuration of sensors, signals, routes, commands for switches and signals, etc., all of this has to be configured manually for virtual blocks.

The orientation of the individual blocks that make up the virtual block is mandatory here! This and other important basic requirements can be found in the wiki at https://wiki.rocrail.net/doku.php?id=block-gen-en#virtual

Block "bk1516v" / Properties / General:

Sensors of block "bk1516v" / Properties / Routes:

The routes are now created manually for the long train. Just copy an existing route. Here is an easy task to start with:
from block "bk42" minus to the virtual block "bk1516v" plus just copy the route "[bk42-]-[bk15+]":

For the long train a route is required from block "bk32" via block "bk42" to the virtual block "bk1516v". Therefore the route "[bk42-]-[bk1516v+]" is copied that was just created:

The list of commands for this route must be completed manually; the turnouts "sw08" and "sw12" must be entered.


Accordingly, all the required routes to and from the virtual block "bk1516v" have to be created both clockwise and counterclockwise which results in the following list of manual routes:

Starting from block bk32 what blocks can be reached clockwise? The existing routes are:

1) route [bk32-]-[bk42+]: for a short train the next block bk42 is reserved:

2a) route [bk32-]-[bk1516v+] via bk42: for a long train the blocks bk42, bk15, bk16 and the virtual block bk1516v are reserved:

2b) route [bk32-]-[bk1516v+] via bk42: a short train can of course also choose the route to the virtual block:

If this is not desired, you can define conditions in the route to the virtual block, e.g. "Minimum train length" [millimeters]

The value can be set like this:
- the train must be at least as long as the short block before the virtual block.
Since Rocrail provides a safety distance (min. Block - train length) (standard is 20 millimeters), this value is subtracted from the block length which results in: Minimum train length = 545 millimeters.

The switch "sw14" is part of the virtual block. It should be locked when there is a train inside the virtual block. One possibility is to assign the virtual block "bk1516v" to this switch:

The switch is now marked in red when the virtual block is occupied.

All tests have been done with this Rocrail workspace, whereby only the direction of travel from block "bk32" via block "bk42" to the virtual block "bk1516v" was examined and checked. Other driving options have not been checked and may contain discrepancies.

A train of length 545 mm can drive from block "bk32" to block "bk42", but not to block "bk15" because block "bk15" is only 532 millimeters long. So it will occupy the long virtual block. To avoid this, manually create a route from block "bk42" to block "bk16" via block "bk15" and inside the permissions of the route set a minimum length of 512 mm. Have fun.