no way to compare when less than two revisions

Differences

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

@@ Line 1: / Line 1: @@
+======Rijrichting======
+[[dutch|{{ :rocrail-logo-35.png}}]]
+[[dutch#inhoud|Inhoud ]]->[[ dutch#auto  mode| Auto  mode ]]
+  * ** Rijrichting**
+// \\ // \\
+=====Lokomotief Richting=====
+Alle lokomotieven hebben een richting, die op de voorzijde en de achterzijde van de lokomotief wordt gebaseerd. De richting van een stoomlokomotief is duidelijk wegens hun ontwerp.
+{{brawa40032-t3-945.png}}
+De elektrische lokomotieven zijn netelig omdat beide uiteinden hetzelfde lijken.
+{{HR2053.png}}
+Voor 3 rail-electrisch, het uiteinde met de sleper is meestal de voorzijde.
+{{pickup-shoe.jpg}}
+//Märklin Electrische Lokomotief, linkerzijde//
+When the decoder in the locomotive receives a command to move forward, it spins the motor one way, when it receives a command to move backwards it spins the motor in reverse. Note that if you hook up the decoder incorrectly, it will move the wrong way. You might not notice this if you are wiring an Electric Locomotive, but its obvious for Steamers.
+When you run a locomotive manually in Rocrail, you can see in the GUI if Rocrail is sending forwards commands or backwards commands. Look at the Direction button in the Locomotive Control Window, and pay attention to the arrowhead on the button:
+| {{rocrail-forwards.png}} |   | Sending forwards commands to the decoder |   |
+| {{rocrail-reverse.png}} |   | Sending backwards commands to the decoder |   |
+Note the use of a Steam Locomotive graphic, this makes it obvious whether the decoder commands are forwards or backwards for this locomotive.
+====The Placing Checkbox====
+You can make Rocrail swap the forwards and backwards commands sent to a **specific** Loc's decoder with the Placing Checkbox in the Locomotives dialog:
+{{loc-int-placing-en.png}}
+If the box is checked, the placing is **Default**, which means Rocrail should send **forwards** commands to the decoder to make this locomotive move **forwards** on a Route. If you uncheck this box, then Rocrail will send **backwards** commands to make this locomotive move **forwards** on a Route.
+{{steamer-backwards-consist-2.jpg}}
+//Consist with reversed steamer -- when backwards really means forwards//
+=====Route Richting=====
+A Route is two adjacent blocks that are linked together. Routes have a direction, specified by choosing the From Block and the To Block in the [[route-gen-en|Routes dialog box]]:
+{{route-gen-en.png}}
+Routes dialog [Needs to be for route A-B, with From Block/To Block and Run
+Direction circled in Red]
+The **default** direction of the Route is always from the From Block to the To Block in the dialog.
+[TK -- example plan shot. Rob, I have this shot, I will post it and the others for this page, they come from a GUI track plan.]
+Rocrail sends forwards commands to all locomotive's **by default** to move the loc from A to B on this Route.
+====The Run Direction Setting====
+You can make Rocrail swap the direction of a Route by setting the Run Direction to reverse. By default, Rocrail will send forwards commands to **any** locomotive in Block A to move it to Block B. If you set Run Direction to Reverse, Rocrail will send backwards commands to **any** locomotive to move them from Block A to Block B.
+TK -- example track shot w/Reverse as default direction.
+====The Usage Setting====
+**The Usage Setting has nothing to do with direction.** It does not change whether Rocrail sends forwards or backwards commands to a locomotive's decoder.
+Instead, it controls whether Rocrail can use the route **one way only**, like any road in real life.
+If Usage is set to **From - To**, Rocrail can only move a loc from the From Block to the To Block. Moving backwards from the To block to the From block is not allowed.
+If Usage is set to **Both Directions**, then a locomotive is allowed to move from either block to the other. However, the commands sent to the locomotive's decoder are still determined by the Block the loc is in, and the direction for the Route.
+This means if the Run Direction for the Route is **forwards**, and the Locomotive is in the **To** block, Rocrail will send **backwards** commands to the decoder to move from the To Block to the From block, **to make it back up**.
+=====How Locomotive and Route Direction Combine=====
+When Rocrail wants to move a locomotive from one block to another, it calculates which direction to send to the locomotive's decoder by combining the direction for the Locomotive and the direction for the Route given the Locomotive's block position.
+  * First, Rocrail determines if it must send forwards or backwards commands to the locomotive based on the Route settings and whether the locomotive is in the From block or the To Block.
+  * Then, Rocrail determines if it must swap the commands for **this specific locomotive** based on the Placing checkbox for the locomotive.
+There are actually 8 different possible combinations of Locomotive and Route direction for a Locomotive in Block A of our route A-B. Examine the following table:
+----
+**Matrix of Locomotive and Route Direction Combinations**
+| **Run Direction** |   | **Placing Checkbox** |   | **Locomotive Facing** |   | **Decoder Command Sent** |   | **Results** |
+| Forwards |   | Checked |   | Towards B |   | forwards |   | Moves to B |
+| Forwards |   | Checked |   | Away from B |   | forwards |   | Moves away from B (**1**) |
+| Forwards |   | Unchecked |   | Towards B |   | backwards |   | Moves away from B (**2**) |
+| Forwards |   | Unchecked |   | Away from B |   | backwards |   | Moves to B |
+| Reverse |   | Checked |   | Towards B |   | backwards |   | Moves away from B (**3**) |
+| Reverse |   | Checked |   | Away from B |   | backwards |   | Moves to B |
+| Reverse |   | Unchecked |   | Towards B |   | forwards |   | Moves to B |
+| Reverse |   | Unchecked |   | Away from B |   | forwards |   | Moves away from B (**4**) |
+**1** -- Locomotive facing is wrong. Loc is facing backwards on the track, it should be facing towards B.
+**2** -- Placing checkbox is wrong. Unchecked means this Loc is supposed to be facing backwards on the track (away from B), but it is facing forwards (towards B).
+**3** -- Locomotive facing is wrong. Reverse Run Direction means all locs are supposed to run this route backwards, backing up from A to B. Loc is facing B, it cannot "backup" to B.
+**4** -- Placing checkbox is wrong. The loc's facing matches the Route, but the placing checkbox says it is backwards on the Route.
+----
+If we expand the matrix above to include a Locomotive in Block B, the number of combinations is **32**, because we must take into consideration **both** placing the Loc in Block B and whether the Usage setting for the Route is From To or Both Directions. Half of those combinations result in Rocrail **not moving the Loc at all**, because a Route that is From To cannot move a loc from the To block back to the From block.
+=====Incorrect Settings=====
+Because of all the different combinations of Locomotive and Route Direction, it is possible to create layouts that cannot be run Automatically. If you do not set up the layout properly, you will quickly confuse yourself as you watch your locomotives move the wrong way on your track, or not move at all, or even worse, bash each other head on.
+You can also make some of your Locomotives fail, while others work perfectly, if you incorrectly place them on the track, and/or do not set the Placing checkbox to match their orientation.
+There are many things to watch out for, here are some examples of common mistakes.
+====Wrong Routes====
+You must create Routes that match how you want your trains to run. Consider this very basic example of a layout that will never work:
+TK -- A-B-C example.
+Routes
+A-B, Run Direction set to Forwards
+C-B, Run Direction set to Forwards
+This might be a simple Trolley layout, with the train moving from A to B to C and back again. But because the Routes are defined incorrectly, the layout won't work. Note that A-B is from the left to the middle, and that C-B is from the right to the middle.
+Assuming default settings for everything, Rocrail will try to move the loc from A to B, and then from B to C. If the loc is placed in A facing B, Rocrail will first move it from A to B by sending forwards commands. This will work, and the loc will move from A to B.
+Then Rocrail will try to move it to block C, using the Route C-B. Because the loc is now in the To block of the C-B route, Rocrail will want to send backwards commands to the decoder, but the loc is facing forwards at block C. The loc will move backwards from B back into A, where it will trigger a Ghost Train exception and shut off the power.
+====Wrong Physical Placing====
+TK-- Shot of real loc with icon loc underneath
+You put the loc on the track in Block A, but facing away from Block B. Rocrail sends forwards commands, which make the loc move forwards away from Block B.
+====Wrong Run Direction====
+TK -- Shot of example with loc icon
+You put the loc on the track in Block A, facing Block B. But, the Run Direction for the Route is Reverse. Rocrail sends backwards commands to the loc, making it move away from Block B.
+====Wrong Placing Checkbox====
+TK -- Shot of example with dialog
+You put the loc on the track in Block A, facing Block B. The Run Direction is set forwards, but the Placing checkbox for this locomotive is unchecked. Rocrail checks the route and wants to send forwards commands. But then it checks the loc, and swaps the direction, and sends backwards commands. The loc moves away from Block B.
+=====Tracing Direction Commands=====
+To help understand why Rocrail doesn't move a loc the way you want it to, you can turn on tracing of Automatic commands in the server. Watch the Server's shell window to see what it is doing as you run your layout. Stop the server and then examine the trace files to see why Rocrail did something you didn't expect.
+====Ghost Train Exceptions====
+====Loc Won't Move====
+===== Avoiding problems with unwanted direction of travel =====
+To ensure that a train (or a locomotive) drives in the desired direction in automatic mode and routes are set by the automatic in exactly the same direction, the following points should be observed before starting the locomotive.
+Assuming that Rocrail has been started, track power is switched on and the train is in the considered block:
+  - Determine in which direction the train should start from the block. {{  :direction:direction-blockside-arrow1-en.png?300}}
+  - Make sure there is a valid route to the next block in that direction.
+  - Select the loco in the loco control panel (click on the loco ID).
+  - Make sure the direction is set to **> >** in the throttle of the loco control panel. (See picture on the right)
+  - Let the locomotive drive a little bit with the help of the throttle and stop again.
+  - Is this the desired direction in which the train should move?
+    * If yes, continue to the point 7.
+    * If not, select the locomotive's context menu (right-click on the loco in the loco panel or on the block where the train is located) and select "**Swap Placing**".
+  - Does the arrowhead in the block symbol point in the desired direction?
+    * If not, select the locomotive's context menu (right-click on the loco in the loco panel or on the block where the train is located) and select "**Swap block enter side**".
+> **Note:** From point 3 on, the sequence shown must be observed and adhered to!