How to Use Track Priority Markers

From TrainzOnline
Revision as of 09:51, 13 January 2023 by Pware (Talk | contribs)

Jump to: navigation, search

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22.

Contents

In Summary:
DotPoint.JPG Track Priority Markers are purple coloured track markers that are invisible in Driver Mode but visible in Surveyor Mode. They are used to direct specific trains under AI control through the track section where they are placed
DotPoint.JPG Track Priority Markers only work on AI controlled trains. They have no effect on manually controlled trains
DotPoint.JPG The direction that the marker is pointing has absolutely NO EFFECT on its operation
DotPoint.JPG Track Priority Markers are used with Priority Levels that are assigned to each train


  Top   Next Down Bottom

What are Track Priority Markers?

DotPoint.JPG Priority levels have no set meanings but can be assigned to specific AI trains to force them through selected sections of track (the track sections are defined as between consecutive junction sets)


Priority Markers are used to assign different levels of Priority to track sections. Trains under AI control that have the same Priority Level as the track will, usually, be directed along that track.

PencilTips.PNG A better way of thinking about the meaning of Priority is to use the word Preference instead. Preference indicates a choice between different paths while Priority is often mistakenly taken to mean importance.


Route or Session?

DotPoint.JPG Priority Markers can be placed in a Route layer or in a Session layer


NotePad.PNG Notes:

DotPoint.JPG Placing Priority Markers in a Route layer (e.g. in the same layer as the track) means that they will be available in all Sessions created using that particular Route.
DotPoint.JPG Placing Priority Markers in a Session layer means that they will only be available in that Session. This can be useful if two or more Sessions are being created and you want to use different Priority Markers in each Session.


LinkWiki.PNG Information on Route and Session layers can be found at:-


  Top Next Up Next Down Bottom

Adding a Track Priority Marker

NotePad.PNG Notes:

A Track Priority Marker has no useful properties other than its Priority Level (1, 2 or 3).


 In Surveyor Classic (S10) 

PriorityMarker1.png

Steps.PNG Steps:
  1. Open the Track Tool
  2. Select the Trackmark button
  3. Select the Track Priority Marker
  4. Select the + (add) button - it may already be selected
  5. Click on the track location where the priority marker is to be placed


This will place the Track Priority Marker on the track and open its properties window.
PriorityMarker2.png
Click the default Priority value shown to select one 1, 2 or 3. Each click will cycle to the next value.

You can also assign the Priority Marker:-

  • a name (which is not necessary for its operation)
  • a layer and
  • a bound layer


 In Surveyor 2.0 (S20) 

Surveyor 2.0 is currently only available for Trainz Plus Standard and Trainz Plus Gold subscription members.

 Adding a Priority Marker 

DotPoint1.JPG In the Asset Palette either:-

Ablue.png Left click the Track Mesh Filter icon

Track mesh

OR
Bblue.png Left click the Content Drop-down Box

Filter List
Then select Track Objects
Track Objects

NotePad.PNG Notes:

If the Assets Palette is not shown on the screen, then:-

Windows Menu
1. open the Window Menu from the menu icons at the top of the screen
2. Left click on the Assets Palette name
to add a tick and make it visible.
PencilTips.PNG  Shortcut 

If you already have a Priority Marker placed in your route then:-

  1. select the Eyedropper Tool in the Tools Palette (or press the  R  key)
  2. Left click on the existing Priority Marker and then left click on the Priority Marker name in the Filter List

This will instantly select the Priority Marker in the Filter List and switch control to the Placement Tool.

Jump to Step DotPoint5.JPG below.


DotPoint2.JPG To narrow down the filter list, type "mark" (UPPER/lower case does not matter) in the Search Text Box

Text search
DotPoint3.JPG This will list all the Track Objects containing the text "mark" in the filter list.
Filtered list DotPoint4.JPG Select the item AI Routing Priority Marker.

If you are not sure about an asset then double-click on the name to bring up its image and description.

DotPoint5.JPG Place the Priority Marker on the track.

Add priority marker


NotePad.PNG Notes:

To delete a Priority Marker (or any asset):-

  1. select either the:-
    • Free Move Tool (or press  S ) or
    • Fine Adjustment Tool (or press  D )
  2. Left click on the Priority Marker
  3. press the  Delete  key

Steps.PNG Steps:
DotPoint1Blue.png Select the Placement Tool (or press the  E  key) from the Tools Palette
DotPoint2Blue.png Left click on the track at the position where you want to place the Priority Marker

The Priority Marker can be easily moved if needed - see below.



Tools and keymap for S20

PencilTips.PNG If you need to rotate the Priority Marker to face the opposite direction then:-
  1. Left click on its Context Tool (DotPoint3Blue.png in the image below or press the  T  key if the asset has already been selected)
  2. from the popup menu select  Rotate Trackside 
Note: the direction it faces has no effect on its operation.


 Set the Priority Marker Properties 

PrioritymarkAdjust S20.png DotPoint3Blue.png Set its Priority Level

This is its only important property.


Steps.PNG Steps:
  1. Left click on the Context Tool (DotPoint3Blue.png in the image on the left or press the  T  key if the asset has already been selected) to open up the object property and control menu
  2. Left click on the  Edit Properties  option in the popup menu
  3. click on the Priority Level number - it will start at Priority 0 (meaning "not set"). Then select a value from the choices 1, 2 and 3
  4. click the Tick.PNG to accept the change or the Cross.PNG to reject it

DotPoint3Blue.png Change Its Name
The name of the marker is only useful for finding it in the route. It is not needed for any operational purpose.


Steps.PNG Steps:
  1. Left click on the Context Tool (DotPoint3Blue.png in the image above or press the  T  key if the asset has already been selected) to open up the object property and control menu
  2. Left click on the  Edit Properties  option in the popup menu
  3. enter a name for the Priority Marker
  4. click the Tick.PNG to accept the change or the Cross.PNG to reject it

DotPoint4Blue.png Set its Trigger Radius
The trigger radius can be adjusted so that the marker can fit between two close junctions without overlapping them.


Steps.PNG Steps:
  1. Left click and hold down the mouse button on the Green Dot next to the Priority Marker (DotPoint4Blue.png in the images above and below)
  2. While holding down the Left mouse button, move the mouse Forward or Backward to increase or reduce the trigger radius


 Move the Priority Marker 

DotPoint5Blue.png Move it Along the Track


Steps.PNG Steps:
  1. Left click and hold down the mouse button on the Yellow Dot next to the Priority Marker (DotPoint5Blue.png in the images above and below)
  2. While holding down the Left mouse button, move the mouse Forward or Backward to drag the Priority Marker along the track


PrioritymarkFineAdjust S20.png DotPoint6Blue.png Reposition it Up/Down

This feature allows a Priority Marker to be physically placed above the track so that it will not be hidden if a consist is parked on the Priority Marker.


Steps.PNG Steps:
  1. Select the Fine Adjustment Tool (or press the  D  key)
  2. Left click and hold down the mouse button on the Blue Vertical Axis Line above the Priority Marker (DotPoint6Blue.png in the image on the left)
  3. While holding down the Left mouse button, move the mouse Forward or Backward to move the Priority Marker Up or Down

PencilTips.PNG If you need to return the Priority Marker to its original position then:-
  1. Left click on its Context Tool (or press the  T  key if the asset has already been selected)
  2. from the popup menu select  Reattach to Track 


DotPoint7Blue.png Reposition the it Left/Right
This feature allows a Priority Marker to be physically placed left or right alongside the track so that it will not be hidden if a consist is parked on the Priority Marker.


Steps.PNG Steps:
  1. Select the Fine Adjustment Tool (or press the  D  key)
  2. Left click and hold down the mouse button on the Red Horizontal Axis Line on the Priority Marker (DotPoint7Blue.png in the image above)
  3. While holding down the Left mouse button, move the mouse Forward or Backward to move the Priority Marker Left or Right of the track
NotePad.PNG Notes:

The Green Horizontal Axis Line shown as DotPoint8Blue.png in the image above pointing forward from the Priority Marker will move the Priority Marker forward/backward regardless of whether it is on the track or not. It has the same effect as DotPoint5Blue.png Move it Along the Track. However, by using this tool it is possible to move the Priority Marker beyond the end of the track if that is ever required.


PencilTips.PNG If you need to return the Priority Marker to its original position then:-
  1. Left click on its Context Tool (or press the  T  key if the asset has already been selected)
  2. from the popup menu select  Reattach to Track 


 Assign a Priority Marker to a New Layer 

The Info Palette will show the layer assigned to the currently selected object. To the left of the layer name is a small arrow object.

Info palette

Layer control


Steps.PNG Steps:
  1. click the small arrow next to the layer name. This will open the layer properties for the selected object
  2. click the Layer drop down box to select a new layer for the object
  3. if required, click the Binding drop down box to select a new binding layer for the object
  4. if required, click the  Lock Layer  button to lock the selected layer. If the layer is already locked then this will be shown as an  Unlock Layer  button


Stop.PNG WARNING:

You will not be allowed to place a track object in a layer that is higher up the list than the layer containing the track.


LinkWiki.PNG Information on layers can be found at:-
  Top Next Up Next Down Bottom

Assigning Priority Levels to Trains

DotPoint.JPG A higher priority level does not mean that one consist is more important than another. A priority 1 consist will not be given first access to a junction, for example, or be the first one to depart. The priority levels have no set meaning beyond what you decide they will mean.


NotePad.PNG Notes:

Every locomotive (and its consist) must have a Priority Level of 1, 2 or 3. The default priority level of every locomotive is 2. You cannot assign NO Priority to a locomotive


For example you could assign priority 1 to express trains and 3 to slow general "all stops" freight trains, or you could assign priority 3 to express trains and 1 to slow general "all stops" freight trains, it is up to you. These values will not alter the speed or importance of these trains but will only decide which paths they should take.

 In Surveyor Classic (S10) 

To assign a priority level to a locomotive.


Steps.PNG Steps:
  1. Open the properties window of the locomotive
  2. Click the Train Priority value - each click will cycle through the values 1, 2, 3. The default priority level for all consists is 2
  3. Click the Tick.PNG to accept the change or the Cross.PNG to reject it

PriorityTrain.png

 In Surveyor 2.0 (S20) 

Surveyor 2.0 is currently only available for Trainz Plus Standard and Trainz Plus Gold subscription members.

To assign a priority level to a locomotive.

Context tool of a loco

Steps.PNG Steps:
  1. select either the:-
    • Free Move Tool (or press  S ) or
    • Fine Adjustment Tool (or press  D )
  2. Left click on the selected locomotive
  3. Left click on the Context Tool (shown in the image on the left or press the  T  key) to open up the loco property and control menu
  4. Left click on the  Edit Properties  option in the popup menu
  5. click the Train Priority value - each click will cycle through the values 1, 2, 3. The default priority level for all consists is 2
  6. click the Tick.PNG to accept the change or the Cross.PNG to reject it

  Top Next Up Next Down Bottom

Priority Marker Operation

Main Points:
DotPoint.JPG Track Priority Markers only work on AI controlled trains. They have no effect on manually controlled trains
DotPoint.JPG Track Priority Markers fool an AI train that has the same priority level into thinking that the path containing the marker is the shortest possible path, even when it is not
DotPoint.JPG AI trains will avoid, where possible, a path containing a Track Priority Marker that does not match its own priority level
DotPoint.JPG If the specified path is blocked, then the AI will ignore the Track Priority Marker and find another path
DotPoint.JPG The direction that the Track Priority Marker is pointing has NO effect on its operation

Consider the situation represented in the diagrams below. Three trains - Red, Green, Yellow - have been given priority levels of 1, 2 and 3 as shown. Each is given the driver command Drive to Trackmark or Navigate to Trackmark. The destination trackmark is shown on the right.

In Figure 1 below, no Track Priority Markers have been set. All three trains will take the shortest path, assuming there are no blockages.

Priority Map - Priority NULL
Figure 1


In Figure 2 below, a Track Priority Marker has been placed on the top loop line and has been given a priority level of 1. The red train (priority level 1) will now take the priority 1 path because it will "see" that as being the shortest of the three possible paths. The green and yellow trains (priority levels 2 and 3) will still "see" the middle path as the shortest.

Priority Map - Priority 1
Figure 2


In Figure 3 below, a Track Priority Marker has been placed on the lower loop line and has been given a priority level of 3. For the same reasons as explained above, the yellow train (priority level 3) will now take the priority 3 path because it now sees that as the shortest.

Priority Map - Priority 3
Figure 3


In Figure 4 below, Track Priority Markers have been placed on the upper and lower loop lines and set as shown. The red and yellow trains will take their respective loop paths while the green train is unaffected.

Priority Map - Priority 1&3
Figure 4


An exception, shown in Figure 5 below, will occur when a Track Priority Marker path has been blocked, for example by another train under AI or manual control. In the figure the lower loop path has been blocked. The red train will take its assigned path, the green train takes its shortest path and yellow train will be forced to take what it "sees" as the next shortest path.

Priority Map - Priority 2&3 blocked
Figure 5

NotePad.PNG Notes:

An AI controlled train will not attempt to find an alternative path around a blockage if:-

  • the Drive To driver command is used, and
  • the blocked path is the shortest path and has the same priority value as the consist

This is the normal operation of the Drive To command and is not caused by the Track Priority Markers or consist priority levels. This situation would occur with or without the use of priority levels and markers.



Another exception, shown in Figure 6 below, will occur when a driver command overrides a Track Priority Marker. In the figure the yellow train (priority level 3) has been given the driver command Drive To Station followed by Drive to Trackmark. As the station is not on the priority 3 path, that path will be ignored to reach the station and then the trackmark. After stopping at the station the train will not reverse back onto the main line to then use the priority 3 track.

Priority Map - Station
Figure 6


The Special Case of Priority 2
Figure 7 below shows a situation that does not fit the points made above. A Track Priority Marker has been set to priority level 2 and placed on the lower loop. The green train has been given the command to drive to the trackmark but ignores its assigned priority 2 path and proceeds via the shortest actual path. Track that has not been assigned a Track Priority Marker will have a default priority level of 2. In this situation, the green train "sees" two paths that match its priority level so it takes the shorter of the two.

Priority Map - 2
Figure 7


Track Priority Markers can also be used to direct trains away from specific paths. Figure 8 below shows how this can be done. A Track Priority Marker set to priority level 1 has been positioned on the shortest physical path. This will block all trains of priority level 2 and 3 from using that path - they will see it as the longest available path. A second Track Priority Marker set to priority level 3 has been positioned on the 2nd shortest physical path. This will block all trains of priority level 1 and 2 from using that path. The end result is that the green train (priority level 2) has only one path available - the longest physical path.

Priority Map - excluding 2
Figure 8


The situation shown in Figure 8 above only works up to a point. Figure 9 below shows what will happen when ALL paths are set to a blocking priority level. The green train (priority level 2) will ignore all the priority markers and choose its own shortest path. Track Priority Markers will only make a path *look* longer or shorter. When all paths have conflicting priorities to an AI train, then the AI will go back to selecting the actual shortest physical path.

Priority Map - all conflicted
Figure 9



  Top Next Up Next Down Bottom


Modifying Train Priority Levels

DotPoint.JPG You can alter the Priority Level of a train in Driver mode


DotPoint1Blue.png Manually in Driver Mode

This can be done "on the fly" using the mouse.


Steps.PNG Steps:
  1. Hold down the CTRL key and right mouse click on the locomotive or on any of the wagons in the consist
  2. Select View Details from the popup menu
  3. Click the current priority setting to cycle through the values to the one you want

View Details

DotPoint2Blue.png Using a Driver Command

This can be done in Surveyor in the session PageLink.PNGDriver Setup Rule or by adding a driver command to the command bar in Driver.

  • Insert the driver command PageLink2.PNG Priorityz into the driver command bar and set it to the new level

LinkWiki.PNG Information on adding driver commands can be found on the Trainz Wiki Page at:-


  Top Next Up   Bottom

Track Priority in Map View

In Surveyor when using Map View or zooming the camera right out, the tracks will be shown colour coded according to their assigned track priority level. If the track layout shown in Figure 4 above, with the priority markers as used in that figure, was shown in Map View then this would be the result.

MiniMap

Tracks that have not been given a priority marker will be shown as dark blue indicating that they have the default priority level 2.

Related Links

LinkWiki.PNG


  Top Next Up    


Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz


This page was created by Trainz user pware in September 2019 and was last updated as shown below.


Personal tools