User Tools

Site Tools


locations-details-en

Differences

This shows you the differences between two versions of the page.


Previous revision
locations-details-en [2024/01/22 11:26] (current) – [Requirements] rjversluis
Line 1: Line 1:
 +======Locations Details======
 +[[:english#objects|{{  :objects.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
 +[[:english|Content]] -> [[:english#objects|Objects]] -> **[[:locations-def-en|Locations]]**
 +  * [[:locations-def-en|Index]] | [[:locations-block-en|Blocks]] | **[[:locations-details-en|Details]]** | [[:locations-graph-en|Diagram]]
 +// \\ // \\
  
 +{{:location-details-en.png?801}}\\
 +
 +
 + \\
 +===== Prioritization =====
 +Normal or blocklist selection.\\
 +See: __**[[:rocrailini-automode-en#location_prioritization|Location prioritization]]**__ \\
 +
 + \\
 +===== 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-gen-en|Block General]]**).
 +  * The block type should be set to **Others** (see **[[:block-details-en|Block Details]]**).
 +  * The __**[[:block-gen-en#mainline|Mainline]]**__ Block option must be disabled. :!:
 +  * All blocks must have the same orientation for some flow 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.\\
 +If there are staging blocks in the location, __all__ trains in staging blocks are counted.\\
 +
 +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)__**[[:loc-tab-en#start_stop|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 **[[:schedules-dest-en#time_processing|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, it is no longer counted in the minimum occupation. \\ If this is the only reason why the minimum occupation of the locality - apparently - would still be given, no other train can leave.
 +
 +
 +==== 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.
 +    * This can only be overwritten with a train (re)__**[[:loc-tab-en#start_stop|Start]]**__ command (see also [[#minimal_occupied|Minimal Occupied]] above).
 +  * __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.
 + \\
 +==== Random ====
 +A random "Fifo" sequence is created at the start of a Rocrail session.
 +\\
 +>**Remark:** The last locomotive arrival time, is taken into account if Fifo is set without random.
 +>**Remark:** Thus the block sequence in the location no longer plays a role.
 +==== Trains ====
 +Only locomotives with an assigned train are allowed in this location.\\
 +
 + \\
 +==== Select shortest block ====
 +See: __**[[:rocrailini-automode-en#select_shortest_block|Select shortest block]]**__\\
 +Note: The "Enable" checkbox must be set to activate this option.\\
 + \\
 +====Partner====
 +A free block must be available in one of the partner locations to be able to depart. Without an entry the option is deactivated.\\
 +The CSV list can be modified by the three dot button on the right. The will open another Locations Dialog for selecting partners.\\
 + \\
 +
 +=====Maximal occupied=====
 +====Total====
 +Set the maximal occupancy in the location if it needs some free blocks to move trains without deadlocking. A value of zero disables the maximal occupied option.\\
 +This option can be specified for both enter sides.\\
 +The Number of Commuter trains plus Others**(("Other" here does not mean the type, but __all other types, except commuter trains__))** should be set equal to the total.\\
 +====Commuter train====
 +Maximal number of commuter trains in this location. (Independent of the enter side)\\
 +====Others====
 +Maximal number of none commuter trains, others, in this location. (Independent of the enter side)\\
 +====Type====
 +Maximal number of a type in this location. (Independent of the enter side)\\
 +
 +
 +
 + \\
 +=====Timetable=====
 +| {{:location:timetabledlg-en.png?300}} | {{:location:html-scheduletable.png?300}} | {{ :location:native-scheduletable.png?300}} |
 +| __**[[:rocgui-gen-en#popup_timetables|Timetable Dialog]]**__ | Formated in HTML. | Plain text. |
 +
 +====Schedule Requirements====
 +  * Absolute and hourly only.
 +  * Destinations must be real blocks.
 +  * The regular stops must have a depart time set.
 +
 +====Generate timetable====
 +Generate a timetable on the fly in __**[[:rocrail-server-scripting-en|RCP]]**__ format. This is also for use with __**[[:rocrailini-service-en#mqtt_service|MQTT]]**__ and __**[[:nodered:nodered-en|Node-RED]]**__.\\
 +In case of actions the __**[[:text-gen-en#variables|%callertext%]]**__ variable will be set with plain ASCII or HTML.\\
 +
 +> Tip: See the __**[[:userpages:nice2have:iot-fahrplananzeiger-de|User page of Gerrit for a Node-RED implementation]]**__. (DE)\\ {{:users:nice2have:iot-fpa.jpg?300}}\\
 +
 +====Publish====
 +Publish the timetable to all clients.\\
 +Rocview will automatically __**[[:rocgui-gen-en#popup_timetables|popup Timetable dialogs]]**__ if wanted. (No actions needed.)\\
 +
 +To reset the schedules to the last position and size shown, the option __**[[:rocgui-gen-en#restore_dialog_size|Restore dialog size]]**__ must be activated.\\
 +If this does not happen after Rocrail has been restarted, (then one time only) the popup windows will have to be closed manually.\\
 +
 +====HTML====
 +Format the timetable in HTML for actions.\\
 +The receiving text object should have the __**[[:text-gen-en#html|HTML option]]**__ enabled.\\
 +
 +====Helpfull Forum Links====
 +  * https://forum.rocrail.net/viewtopic.php?f=6&t=15238
 +
 + \\
 +
 +=====Actions=====
 +See **[[actionctrl-en|Actions]]** for more details.\\
 +====Timetable====
 +Action state: "scheduleupdate"
 +===Location action control===
 +{{:location:location-timetable-action-en.png}}\\
 +===Sub state===
 +If a block is selected as sub state the first entry for this block from the timetable will be used to set the following text variables:\\
 +  * %calleruserdata% = Depart time including delay.
 +  * %callertext% = The via blocks and final destination.
 +
 +===Text action===
 +{{:location:timetable-text-action-en.png}}\\
 +
 + \\
 +====Occupancy====
 +Action state: "occupdate"
 +  * %calleruserdata% = actual occupancy:minimal occupancy, like "2:0"
 +  * %callertext% = The Fifo list of locos in this location.
 +
 + \\
 +
 +=====Flow management examples=====
 +==== Example 1====
 +Location 1 has Fifo active and minimal occupancy 3.\\
 +Location 2 has Fifo active and minimal occupancy 2.\\
 +{{:location:location-test.png}}\\
 +  * {{:location:location-test.zip}}
 +//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”.\\
 +{{:users:cds:bsp_ortschaften.png}}\\
 +  * {{:users:cds:test_ortschaften.zip}}\\
 +"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.\\
 +
 +<code xml>
 +<?xml version="1.0" encoding="UTF-8"?>
 +<xmlscript>
 +  <location id="Blaak" cmd="info" svalue="tx1"/>
 +</xmlscript>
 +</code>
 +
 +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====
 +<code>
 +Depart time,Destination Location ID,Block ID,Train/Loco ID,Optional text|
 +</code>
 +
 + \\