The Finder

Introduction

The Finder can be used to find a path from one Block to another or to a Location.
This function must be enabled with Use Finder for destination path or in the Rocrail Automode Properties
The Finder will be active after setting a Destination.


How it works

After activating, by setting a destination, the Finder will try to find a path to it by recursively iterate through all Routes.
More then one path can be found depending of the complexity of the layout.
The path will be converted into a temporary schedule which will be activated for the selected Loco.
The new schedule will have a “F” prefix in the table and will be removed at the end of the Rocrail Server session if not modified before with the Schedule Dialog.
Example of a schedule name created by the Finder: F[-1-staging]
If already an “F” schedule exist for the wanted path it will be used instead of generating it again.

Limitations

  • To avoid looping and using too much CPU resources the max. recursive depth is set to the number of available Routes.
  • The search will stop if the max. depth has been reach more then the available number routes.
  • Routes which needs a direction change will be skipped.


Requirements


Settings


Use Finder for destination path

Path

If more than one path has been found the following options can be used for selecting one:

Shortest

Select the shortest found path.

Longest

Select the longest found path.

Options

Find alternative paths

This option can only be used if a valid Support Key is provided.

If not enabled, or no valid support key, the finder will stop after the first path that has been found. Depending on how the layout is designed this could be a (big) detour.
The max. number of alternative paths can be set. The default is 10 which normally will do. Increasing this number can cause massive CPU usage without any better paths found.
This number of alternative paths is also restricted by the number of routes.

Regular stop

All schedule entries will get the Regular stop option.

Temporary schedules

The generated schedules will be removed at shutdown.
This is default and highly recommended! Changing routes can make Finder schedules invalid and can lead to deadlocks.

Check permissions

Check if the loco has permission to use routes and blocks.

Check destination permissions

Check if the loco has permission to use routes running to the destination block and of the destination block itself.

Avoid occupied blocks

Avoid occupied block to find a path.
Depending on the block occupancy and layout the find result could be zero.

Use locations

Use block locations in the generated schedule.
If not all blocks in a location leads to the same follow-up block/location this will end the schedule.

Avoid terminal blocks for none commuter trains

If a train is allowed to enter a terminal block this could be a dead end.
Use this option to avoid running into terminal stations.

Update schedules

If a schedule already exist it will be updated to meet the actual permissions.
This option is recommended to avoid running into occupied blocks.

Reserve destination

The destination block will be reserved.
Do not use incase the destination is a location.

Start only with a schedule after DnD

If no path is found this option will prevent starting the loco after using Drag and Drop.

Depart side

Set the Depart Side of the schedule destinations.

Home

Menu → Automatic → Home location
With the home action all locomotives with a Home location set, and which are not already at the home location, will get a command to run to the home location.
The Finder will be used to find a path to the Home location.


Personal Tools