Route Assignment Table: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
A Route can be manually assigned using the Route option in the change object.<br> | A Route can be manually assigned using the Route option in the change object.<br> | ||
Routes are used to tell trains which stations to go to on a track network. | Routes are used to tell trains which stations to go to on a track network. | ||
The Route Assignment Dialog displays a list of all of the Routes that you have specified in your model. | The Route Assignment Dialog displays a list of all of the Routes that you have specified in your model. | ||
In this list of Routes, each Route has a unique index number, which was defined at the time the route was created. | In this list of Routes, each Route has a unique index number, which was defined at the time the route was created. | ||
== Selector Reference<br> == | == Selector Reference<br> == | ||
Below the Routes list is a "Selector Reference" Attribute. This provides a value for which a matching Route index value is sought. | Below the Routes list is a "Selector Reference" Attribute. This provides a value for which a matching Route index value is sought. | ||
When an item passes through the Change Object, the Route whose index value matches the value of this Selector Reference Attribute will be assigned to the train item. | When an item passes through the Change Object, the Route whose index value matches the value of this Selector Reference Attribute will be assigned to the train item. | ||
You use the ">" button to configure the Selector Reference Attribute. Its default is a constant value of 1. <br> | You use the ">" button to configure the Selector Reference Attribute. Its default is a constant value of 1. <br> | ||
More common would be to use an item attribute which has been set in routine code before the train item arrives at this change object.<br> | More common would be to use an item attribute which has been set in routine code before the train item arrives at this change object.<br> | ||
Because the Selector Reference is an Attribute, you can point to an attribute that varies during a model run. | Because the Selector Reference is an Attribute, you can point to an attribute that varies during a model run. | ||
e.g. You can create an Item Attribute called "Trip_Name". Each item can be given a different trip_name value, and each item will be assigned a different Route when it passes through this change object.<br> | e.g. You can create an Item Attribute called "Trip_Name". Each item can be given a different trip_name value, and each item will be assigned a different Route when it passes through this change object.<br> | ||
<br> | |||
== Selector Reference Enables Multiple Choices<br> == | |||
The Selector Reference can be pointed to a Table. This enables a number of routes to be specified and they will be tested sequentially, with the first "accepting" route taken by an item. | |||
*The reference must be to the entire table. | |||
*The route index values to test are specified in column 1 of the table. | |||
*The reference must be to the entire table. | |||
*The route index values to test are specified in column 1 of the table. | |||
*The rows in this column should be set to the route IDs to test. | *The rows in this column should be set to the route IDs to test. | ||
== Row Limit Attribute == | == Row Limit Attribute == | ||
When you are using the table-based | When you are using the table-based multiple choice Selector Reference, you can set an additional "row limit" attribute. | ||
You use the ">" button to configure the Row Limit Attribute. Its default is a constant value of 1. | You use the ">" button to configure the Row Limit Attribute. Its default is a constant value of 1. | ||
This provides a convenient means of limiting the number of rows tested. | This provides a convenient means of limiting the number of rows tested. | ||
This is useful because the table needs to be prepared and available during lookahead, during which time rows cannot be added/ removed from a table. | This is useful because the table needs to be prepared and available during lookahead, during which time rows cannot be added/ removed from a table. | ||
The default of -1 for the row limit will scan all rows in the table.<br> | The default of -1 for the row limit will scan all rows in the table.<br> | ||
== Delete Button<br> == | == Delete Button<br> == | ||
The Delete button clears the route assignment function in this change object (so it performs no route | The Delete button clears the route assignment function in this change object (so it performs no route | ||
| Line 50: | Line 50: | ||
---- | ---- | ||
[[Category:Track]] [[Category:Context_Help]] | [[Category:Track]] [[Category:Context_Help]] | ||
Latest revision as of 17:57, 9 May 2011
A Route can be manually assigned using the Route option in the change object.
Routes are used to tell trains which stations to go to on a track network.
The Route Assignment Dialog displays a list of all of the Routes that you have specified in your model.
In this list of Routes, each Route has a unique index number, which was defined at the time the route was created.
Selector Reference
Below the Routes list is a "Selector Reference" Attribute. This provides a value for which a matching Route index value is sought.
When an item passes through the Change Object, the Route whose index value matches the value of this Selector Reference Attribute will be assigned to the train item.
You use the ">" button to configure the Selector Reference Attribute. Its default is a constant value of 1.
More common would be to use an item attribute which has been set in routine code before the train item arrives at this change object.
Because the Selector Reference is an Attribute, you can point to an attribute that varies during a model run.
e.g. You can create an Item Attribute called "Trip_Name". Each item can be given a different trip_name value, and each item will be assigned a different Route when it passes through this change object.
Selector Reference Enables Multiple Choices
The Selector Reference can be pointed to a Table. This enables a number of routes to be specified and they will be tested sequentially, with the first "accepting" route taken by an item.
- The reference must be to the entire table.
- The route index values to test are specified in column 1 of the table.
- The rows in this column should be set to the route IDs to test.
Row Limit Attribute
When you are using the table-based multiple choice Selector Reference, you can set an additional "row limit" attribute.
You use the ">" button to configure the Row Limit Attribute. Its default is a constant value of 1.
This provides a convenient means of limiting the number of rows tested.
This is useful because the table needs to be prepared and available during lookahead, during which time rows cannot be added/ removed from a table.
The default of -1 for the row limit will scan all rows in the table.
Delete Button
The Delete button clears the route assignment function in this change object (so it performs no route