Vehicle Contents (Movement Order)

A Vehicle Contents movement order is defined by a set of delimited values that determines changes to be made to a set of vehicles. Changes include loading/unloading passengers, loading/unloading freight, changing vehicle destinations, and changing freight contents.

The type number for this order is 18.

For each vehicle that is to be changed, 5 values need to be defined. For 2 vehicles, 10 values are required, etc. The format for each vehicle is as follows:

  index;loaded;loadtype;mass;destination

index

The vehicle index, where the first vehicle is index 0, the second is index 1, etc.

Example:

      loco, car1, car2, car3, .... car9
  index: 0     1     2     3          9
  	   
      loco1, loco2, loco3, car1, car2, car3 
  index:  0      1      2     3     4     5

During simulation, if there is any mismatch in indices (example: 10 values, only 9 cars) the simulation will not execute the order. When in Developer mode, a warning message is generated when order execution fails due to an index mismatch.

loaded

0 : empty
1 : loaded

Used to indicate whether a passenger car is loaded or not. This value is ignored for freight cars. Any value other than 0 or 1 generates a warning in Developer mode, and loaded is set to 0 (empty)

loadtype

Integer as defined in table 'TrainLoads'.

example:

0 equals "empty"  (not defined in table, is a special value)               
1 equals Iron Ore (defined in table)
2 equals Grain    (defined in table)

If load type is mismatched with load class of car type (example: Iron Ore in tank car) then the simulation generates an error. If load type is not found (or is not a number) sim generates an error when sim starts.

mass

Integer value in metric tonnes. Used for freight cars. For passenger cars, this value is ignored.

If empty: 0

If a value is larger than the max value for that type of car is entered, the simulation automatically clips to max value. If not a valid integer, an error is generated. If a valid integer, but is negative, a warning is generated, and the value is interpreted as zero.

destination

Text of desired vehicle destination. In Developer mode, a text length longer than 30 characters generates a warning.

---

Return to Timetables