MissionCodes Manager - Revision history

Pguy: /* Train Mission Codes auto path assignment : and what are path triggers ? */

2019-02-17T10:28:11Z

Train Mission Codes auto path assignment : and what are path triggers ?

← Older revision		Revision as of 10:28, 17 February 2019
Line 144:		Line 144:


	''Since release 60, pathtriggers are also supported by enhanced interlocking towers. This has needed a few adaptations to already existing MCM pathtriggers. Now a pathtrigger can either be defined at the EIT level or at the MCM level. Pathtriggers defined at the EIT level are called EIT pathtriggers and works both for EIT and for MCM. Pathtriggers defined only in MCM are called MCM pathtriggers and works only in MCM. You need to use the IT manager to manage EIT pathtriggers and you need to use MCM to manage MCM only pathtriggers. MCM path trigger page will now list both types of path triggers so that you can see all the path triggers used in your session and at which level.""		''Since release 60, pathtriggers are also supported by enhanced interlocking towers. This has needed a few adaptations to already existing MCM pathtriggers. Now a pathtrigger can either be defined at the EIT level or at the MCM level. Pathtriggers defined at the EIT level are called EIT pathtriggers and works both for EIT and for MCM. Pathtriggers defined only in MCM are called MCM pathtriggers and works only in MCM. You need to use the IT manager to manage EIT pathtriggers and you need to use MCM to manage MCM only pathtriggers. MCM path trigger page will now list both types of path triggers so that you can see all the path triggers used in your session and at which level.''

	=== Train Mission codes : some other miscellaneous features ===		=== Train Mission codes : some other miscellaneous features ===

Pguy: /* Train Mission Codes auto path assignment : and what are path triggers ? */

2019-02-17T10:27:00Z

Train Mission Codes auto path assignment : and what are path triggers ?

← Older revision		Revision as of 10:27, 17 February 2019
Line 142:		Line 142:

	There is also in the package a driver command ITMCAssignNextPath ( <kuid:61392:8202> ) that will do the same processing as a path trigger on the current train when the command is executed. This driver command may be usefull for train stopped at a platform or a yard to start some auto path assignment process chain with follow on options.		There is also in the package a driver command ITMCAssignNextPath ( <kuid:61392:8202> ) that will do the same processing as a path trigger on the current train when the command is executed. This driver command may be usefull for train stopped at a platform or a yard to start some auto path assignment process chain with follow on options.


			''Since release 60, pathtriggers are also supported by enhanced interlocking towers. This has needed a few adaptations to already existing MCM pathtriggers. Now a pathtrigger can either be defined at the EIT level or at the MCM level. Pathtriggers defined at the EIT level are called EIT pathtriggers and works both for EIT and for MCM. Pathtriggers defined only in MCM are called MCM pathtriggers and works only in MCM. You need to use the IT manager to manage EIT pathtriggers and you need to use MCM to manage MCM only pathtriggers. MCM path trigger page will now list both types of path triggers so that you can see all the path triggers used in your session and at which level.""

	=== Train Mission codes : some other miscellaneous features ===		=== Train Mission codes : some other miscellaneous features ===

Pguy: /* Train Mission Codes auto path assignment : how it works ? */

2019-02-17T10:19:00Z

Train Mission Codes auto path assignment : how it works ?

← Older revision		Revision as of 10:19, 17 February 2019
Line 126:		Line 126:
	So when you have configured all your mission codes, trains and paths assignment, you only need to run your session and the paths will be auto assigned based on one of the current train mission codes and following your paths mission codes assignment configuration defined in Mission Code Manager.		So when you have configured all your mission codes, trains and paths assignment, you only need to run your session and the paths will be auto assigned based on one of the current train mission codes and following your paths mission codes assignment configuration defined in Mission Code Manager.

			''Since release 60, there is a new global parameter available on the initial mission code page : process all trains option. By default, it is set to "do not process trains without mission code" but you can change it to "process trains without mission code using implicit value". With this option activated, there is no longer any train without any mission code. First trains with no current mission code are considered as having an implicit mission code #NONE and all trains receive also another implicit mission code #TRP1 or #TPR2 or #TPR3 based on their current trainz priority. By making path eligible or not to these implicit mission codes #NONE, #TPR1, #TPR2,#TPR3 you can use the MCM routing facility to auto select paths for trains without any explicit mission code.''
	""Since release 60, there is a new global parameter available on the initial mission code page : process all trains option. By default, it is set to "do not process trains without mission code" but you can change it to "process trains without mission code using implicit value". With this option activated, there is no longer any train without any mission code. First trains with no current mission code are considered as having an implicit mission code #NONE and all trains receive also another implicit mission code #TRP1 or #TPR2 or #TPR3 based on their current trainz priority. By making path eligible or not to these implicit mission codes #NONE, #TPR1, #TPR2,#TPR3 you can use the MCM routing facility to auto select paths for trains without any explicit mission code.

	=== Train Mission Codes auto path assignment : and what are path triggers ? ===		=== Train Mission Codes auto path assignment : and what are path triggers ? ===

Pguy: /* Train Mission Codes auto path assignment : how it works ? */

2019-02-17T10:16:52Z

Train Mission Codes auto path assignment : how it works ?

← Older revision		Revision as of 10:16, 17 February 2019
Line 125:		Line 125:

	So when you have configured all your mission codes, trains and paths assignment, you only need to run your session and the paths will be auto assigned based on one of the current train mission codes and following your paths mission codes assignment configuration defined in Mission Code Manager.		So when you have configured all your mission codes, trains and paths assignment, you only need to run your session and the paths will be auto assigned based on one of the current train mission codes and following your paths mission codes assignment configuration defined in Mission Code Manager.


			""Since release 60, there is a new global parameter available on the initial mission code page : process all trains option. By default, it is set to "do not process trains without mission code" but you can change it to "process trains without mission code using implicit value". With this option activated, there is no longer any train without any mission code. First trains with no current mission code are considered as having an implicit mission code #NONE and all trains receive also another implicit mission code #TRP1 or #TPR2 or #TPR3 based on their current trainz priority. By making path eligible or not to these implicit mission codes #NONE, #TPR1, #TPR2,#TPR3 you can use the MCM routing facility to auto select paths for trains without any explicit mission code.

	=== Train Mission Codes auto path assignment : and what are path triggers ? ===		=== Train Mission Codes auto path assignment : and what are path triggers ? ===

Pguy: /* Train Mission Codes : how to assign a code to an interlocking tower and path */

2019-02-17T10:08:38Z

Train Mission Codes : how to assign a code to an interlocking tower and path

← Older revision		Revision as of 10:08, 17 February 2019
Line 107:		Line 107:

	On each path line, depending on its current status, you will find either a "add selected mcode to path config" or "suppress selected mcode from path config" to add or suppress mission code eligibility for the path. By listing for a selected mission code all paths eligibility, it is easy to have a global value of all the paths already enabled for a mission code and to update the configuration if needed. The view details link remains available also on this page to switch to a path view of all eligible mission codes for entering other specific parameters like priority and follow path option.		On each path line, depending on its current status, you will find either a "add selected mcode to path config" or "suppress selected mcode from path config" to add or suppress mission code eligibility for the path. By listing for a selected mission code all paths eligibility, it is easy to have a global value of all the paths already enabled for a mission code and to update the configuration if needed. The view details link remains available also on this page to switch to a path view of all eligible mission codes for entering other specific parameters like priority and follow path option.

			The page includes at its beginning an option to display all paths or only eligible paths and a tower name filter to enable to tailor this page to your need. To add new mission code eligibility to a path currently not eligible, of course you need to have the display option set to all paths and not limited to eligible paths.

	=== Train Mission Codes auto path assignment : how it works ? ===		=== Train Mission Codes auto path assignment : how it works ? ===

Pguy: /* Train Mission Codes : how to assign a code to an interlocking tower and path */

2019-02-17T10:04:29Z

Train Mission Codes : how to assign a code to an interlocking tower and path

← Older revision		Revision as of 10:04, 17 February 2019
Line 102:		Line 102:

	[[File:Help-missioncodemanager-rule-imgallpaths.png]]		[[File:Help-missioncodemanager-rule-imgallpaths.png]]


			The paths displayed in low green are path that are unique (only path available) at their entry signal and are by default considered as eligible for any mission codes without the need to configure anything. Paths displayed in high green are paths that have been explicitly made eligible for the selected mission code by validating the selected mission code for the path. Paths displayed in low grey are paths not eligible for the currently selected mission code.

			On each path line, depending on its current status, you will find either a "add selected mcode to path config" or "suppress selected mcode from path config" to add or suppress mission code eligibility for the path. By listing for a selected mission code all paths eligibility, it is easy to have a global value of all the paths already enabled for a mission code and to update the configuration if needed. The view details link remains available also on this page to switch to a path view of all eligible mission codes for entering other specific parameters like priority and follow path option.

	=== Train Mission Codes auto path assignment : how it works ? ===		=== Train Mission Codes auto path assignment : how it works ? ===

Pguy: /* Train Mission Codes : how to assign a code to an interlocking tower and path */

2019-02-17T09:55:03Z

Train Mission Codes : how to assign a code to an interlocking tower and path

← Older revision		Revision as of 09:55, 17 February 2019
Line 91:		Line 91:

	The option follow path is an option by default set to none, that can be set to either "on path activation" or to "on train entering path". When the option is set to "on path activation", when the current path will become active, Mission code manager will search forward for the next entry signal after the current path exit signal, and will try to activate a new path (follow path) for the current train at this new entry signal using the same assignment process than above. With the on train entering path, it is only when the current train enters the current path (leaves the current path entry signal) that the follow path at the next entry signal is searched. Using these options you can in fact chain paths activation following either the activation or the progression of the train in the previous paths.<br>		The option follow path is an option by default set to none, that can be set to either "on path activation" or to "on train entering path". When the option is set to "on path activation", when the current path will become active, Mission code manager will search forward for the next entry signal after the current path exit signal, and will try to activate a new path (follow path) for the current train at this new entry signal using the same assignment process than above. With the on train entering path, it is only when the current train enters the current path (leaves the current path entry signal) that the follow path at the next entry signal is searched. Using these options you can in fact chain paths activation following either the activation or the progression of the train in the previous paths.<br>

	You can set a global default value for the follow path option, which can be overridden by a default value at the path level, which can also be overridden at the mission code level.		You can set a global default value for the follow path option, which can be overridden by a default value at the path level, which can also be overridden at the mission code level.

	~~''Since release 28, chaining~~ path activation by using follow path option is limited by the current follow path depth. The follow path depth defines the maximum number of paths activated but not entered that a train can have. If a follow path activation is requested but the follow path depth is exceeded, the follow path activation will be delayed until the current number of paths activated but not entered will decrease under the follow path depth. The follow path request is not lost but is only delayed.''		Chaining path activation by using follow path option is limited by the current follow path depth. The follow path depth defines the maximum number of paths activated but not entered that a train can have. If a follow path activation is requested but the follow path depth is exceeded, the follow path activation will be delayed until the current number of paths activated but not entered will decrease under the follow path depth. The follow path request is not lost but is only delayed.
	~~''Follow~~ path depth ~~are defined~~ at the mission code level ~~and~~ the ~~current value~~ is the ~~maximum value of all the follow path depth~~ for ~~all~~ the mission ~~codes assigned to~~ the ~~current train~~.
	''		There is a global default follow path depth which is set on the initial mission code page. This value can be overridden at the mission code level by entering another value for any mission code on the initial mission code page.


			There is another way to add/remove mission code eligibility for a path. This can be done using the "view paths" link for a specific mission code on the initial mission code page. This link will display all the available paths in all towers :

			[[File:Help-missioncodemanager-rule-imgallpaths.png]]

	=== Train Mission Codes auto path assignment : how it works ? ===		=== Train Mission Codes auto path assignment : how it works ? ===

Pguy: /* Train Mission Codes : in practice how to define them */

2019-02-17T09:22:54Z

Train Mission Codes : in practice how to define them

← Older revision		Revision as of 09:22, 17 February 2019
Line 25:		Line 25:
	[[File:Help-missioncodemanager-rule-img02.png]]		[[File:Help-missioncodemanager-rule-img02.png]]

	In the example above, ~~eight~~ mission codes strings (~~GABMON~~,~~GARTBC~~,~~GARTOU~~,~~MONGAB,NORSOU,SOUNOR,TBCGAR,TOUGAR~~) have been defined for the current session.		In the example above, four mission codes strings (CentralToSouth,NorthToSouth,SouthToCentral,SouthToNorth) have been defined for the current session.

	~~''Since release 28, this screen~~ enables also to set the default follow path depth, ~~the debugging options for MCM and if needed a specific~~ follow path ~~depth for each mission code defined~~. The ~~check~~ and ~~suppress invalid~~ mission ~~code~~ data enables to ~~check all~~ mission codes ~~references in~~ MCM data ~~and to suppress any obsolete references~~.		This page enables also to set the default global values for Mission Code Manager options like default follow path depth, default follow path option, follow path search distance, exit signal track check mode, unique path select mode option, process all trains option and debugging mode which will be detailed later below in their respective section. The page includes also links to copy MCM data to the common clipboard and to paste MCM data from the common clipboard in order to enable copying MCM data between sessions. It has also a link repair mission codes from internal data that enables to try to recreate missing mission codes from internal MCM data if you have by mistake deleted some still needed mission codes.
	''

	=== Train Mission Codes : how to assign a code to a train ===		=== Train Mission Codes : how to assign a code to a train ===

Pguy: /* Mission Code Manager rule */

2019-02-17T08:59:01Z

Mission Code Manager rule

← Older revision		Revision as of 08:59, 17 February 2019
Line 6:		Line 6:
	'''MissionCode Manager''' is a rule ( <kuid:61392:8200> ) which enables to add, edit and manage Mission Code strings, which can be assigned to trains and can be used to auto select paths in interlocking towers to route the trains to their destination.		'''MissionCode Manager''' is a rule ( <kuid:61392:8200> ) which enables to add, edit and manage Mission Code strings, which can be assigned to trains and can be used to auto select paths in interlocking towers to route the trains to their destination.

	''This page has been updated to support new features brought with version 16 of Mission code Manager and associated stuff.		''This page has been updated to support new features brought with version 60 of Mission code Manager and associated stuff.

	=== Train Mission Codes : what is it and for which purpose ?===		=== Train Mission Codes : what is it and for which purpose ?===

Pguy: /* Train Mission Codes : how to assign a code to an interlocking tower and path */

2018-03-03T18:49:25Z

Train Mission Codes : how to assign a code to an interlocking tower and path

← Older revision		Revision as of 18:49, 3 March 2018
Line 85:		Line 85:

	On this path details page, you have some links to add new mission code to the current selected path or to remove some already assigned mission codes.		On this path details page, you have some links to add new mission code to the current selected path or to remove some already assigned mission codes.
	On the example above, you are editing mission code assignment for the path SouthToV2 in tower IT Garrenac South (with entry signal C600 and exit signal C602) and two mission codes are valid for this path : mongab and sounor.

	It is also possible to define a priority between 1, 2 and 3 for a path mission code assignment. This priority will be used when the Mission Code Manager has to activate a path for a train at an entry signal. If several paths are available at the entry signal and the mission code is valid for several of these paths, the mission code manager will try first to activate an eligible path (available path with mission code assigned to this path) with mission code priority 1, then 2 and last 3. If several paths are eligible for a mission code at the same priority level, the mission code manager will try to activate a randomly chosen path between paths with same priority.		It is also possible to define a priority between 1, 2 and 3 for a path mission code assignment. This priority will be used when the Mission Code Manager has to activate a path for a train at an entry signal. If several paths are available at the entry signal and the mission code is valid for several of these paths, the mission code manager will try first to activate an eligible path (available path with mission code assigned to this path) with mission code priority 1, then 2 and last 3. If several paths are eligible for a mission code at the same priority level, the mission code manager will try to activate a randomly chosen path between paths with same priority.
Line 92:		Line 91:
	It is also possible on this page to edit the auto assign AI flag and auto assign flag for the current path.		It is also possible on this page to edit the auto assign AI flag and auto assign flag for the current path.

	The option follow path is an option by default set to none, that can be set to either "on path activation" or to "on train entering path". When the option is set to "on path activation", when the current path will become active, Mission code manager will search forward for the next entry signal after the current path exit signal, and will try to activate a new path (follow path) for the current train at this new entry signal using the same assignment process than above. With the on train entering path, it is only when the current train enters the current path (leaves the current path entry signal) that the follow path at the next entry signal is searched. Using these options you can in fact chain paths activation following either the activation or the progression of the train in the previous paths.		The option follow path is an option by default set to none, that can be set to either "on path activation" or to "on train entering path". When the option is set to "on path activation", when the current path will become active, Mission code manager will search forward for the next entry signal after the current path exit signal, and will try to activate a new path (follow path) for the current train at this new entry signal using the same assignment process than above. With the on train entering path, it is only when the current train enters the current path (leaves the current path entry signal) that the follow path at the next entry signal is searched. Using these options you can in fact chain paths activation following either the activation or the progression of the train in the previous paths.<br>
	~~It is also possible to~~ set ~~this option to "~~option at ~~code~~ level~~" and with this choice you will~~ be ~~able to choose follow path option for each mission code~~ at the mission code level~~. For example you can choose for mission code A to have a follow path option on path activation and for mission code B on train entering path~~.		You can set a global default value for the follow path option, which can be overridden by a default value at the path level, which can also be overridden at the mission code level.

	''Since release 28, chaining path activation by using follow path option is limited by the current follow path depth. The follow path depth defines the maximum number of paths activated but not entered that a train can have. If a follow path activation is requested but the follow path depth is exceeded, the follow path activation will be delayed until the current number of paths activated but not entered will decrease under the follow path depth. The follow path request is not lost but is only delayed.''		''Since release 28, chaining path activation by using follow path option is limited by the current follow path depth. The follow path depth defines the maximum number of paths activated but not entered that a train can have. If a follow path activation is requested but the follow path depth is exceeded, the follow path activation will be delayed until the current number of paths activated but not entered will decrease under the follow path depth. The follow path request is not lost but is only delayed.''