Phase 4. Modeling rail car classification

1. Draw more railway tracks as shown on the picture below. These will be the destination tracks. To draw such rail topology, first draw several long tracks right to the end of the hump yard, and then add branch tracks.
   

   

2. Give meaningful names to the destination tracks like trackN1 ... trackN6.
   

   

3. Add six Position on Track elements on every destination track and name them stopLineN1 .. stopLineN6. That’s how we define stop lines for each track. The cars rolling down by gravity onto their destination tracks will stop at these lines.
   

   

Train arriving to the hump yard may contain several cars of the same type in sequence. Those cars can be rolled to their track at once.

1. Create a Function element that will calculate the number of successive cars of the same type in the train standing on the hump. Name it carsOfSameType and make sure to set the following parameters:
   

   

2. Create another Function element and name it departurePointOnTrack.
   

   It will determine the destination track for the rail cars in the classification bowl (the tracks where the cars of this particular type are sorted). This function takes the train as the argument, then checks the type of the first car of the train (since train usually consists just of a single car). We find the type of the car with the help of instanceof Java operator. It evaluates to true if the object is an instance of the specified class. Finally the function returns Position on track that depends on the car type.

   Make sure to set the following parameters:
   

   

3. Drag a Variable element into the graphical editor from the Agent palette. This variable will store the reference to the track where the required number of cars of the same type is ready to be taken by a loco from the yard.
   

   

4. Modify Variable:
   Name: trackReadyToDepart.
   Choose Other in the Type drop down list and specify RailwayTrack in field that will appear next to it.
   

1. TrainDecouple block decouples the cars when the train is on the hump. The train may contain several cars of the same type in sequence. Those cars are rolled to their track at once. (We find the number of the cars to be rolled by the function carsOfSameType created on the previous step). The destination is defined by the function departurePointOnTrack that we have defined on the previous step.
   

   Set the following parameters for the TrainDecouple block:
   Number of cars to decouple: carsOfSameType(train)
   New train: Train
   

2. There is a short delay before the train continues decoupling.
   

   Set the following parameters for the Delay block:
   Delay time: 5 seconds
   

3. Now we should determine whether the train contains more freight cars to be decoupled. This is done by SelectOutput block. We check whether the train contains more than one car (remember, that one car is the loco itself). If it is so, the train enters the TrainDecouple block again. The cycle repeats until the train contains just one loco ready to depart from the yard.
   

   Set the following parameters for the SelectOutput block:
   Select True output: If condition is true
   Condition: agent.size() > 1
   

4. Do not forget to connect the right port of the SelectOutput block to the input port of the trainMoveTo4 block to move the train to the hump again.

1. We use TrainMoveTo again to simulate train movement. We specify the name of the lower track (trackN6) as the destination point.|
   

   Set the following parameters for the TrainMoveTo block:
   Route is: Calculated automatically…
   arget is: A given offset on a track
   Railway track: trackN6
   

2. Finally, the loco is removed from the model by TrainDispose block.

Simulate how rail cars roll by gravity onto their destination tracks (the tracks where the cars are sorted).

1. The movement (as always) is simulated with TrainMoveTo. The train consists of single cars, or some coupled cars of the same type in a block. The destination (stop line of the track corresponding to this rail car type) is returned by the function departurePointOnTrack we’ve defined earlier.
   

   Set the following parameters for the TrainMoveTo block:
   Route is: Calculated automatically…
   Target is: A given position on track
   Position on track: departurePointOnTrack(train)
   Finish options: Decelerate and stop
   

2. If there are any other cars on the same destination track, they are assembled together with the just rolled cars in the TrainCouple block.
   

3. The cars continue assembling until the required number of cars is on the track (a locomotive arrives at this point to take them away from the yard). This SelectOutput block checks whether the assembly should be stopped or not. We specify that the train should be assembled until it has 8 cars.
   

   Set the following parameters for the SelectOutput.block:
   Select True output: If condition is true
   Condition: agent.size() < 8
   

It will simulate how the ready train combined from 8 cars of the same type leaves the yard.

1. First, we couple the cars with the loco by means of the TrainCouple block (the loco logic will be defined on the next step).
2. Then the train leaves the yard (this is modeled with a common TrainMoveTo block).
   

   Set the following parameters for the TrainMoveTo block:
   Route is: not specified (train will follow switches)
   Target is: not specified
   

3. Finally, we remove the train from the model with the TrainDispose.

1. First, let us add TrainSource block to model locomotive arrival. The train consists just of one railcar (the loco itself). Choose the manual train generation mode since this block will create trains only when the new train is ready to depart from the yard. The loco should appear on the track defined by the variable trackReadyToDepart (we calculate the variable value on the next step).
   

   Set the following parameters for the TrainSource block:
   Name: newLoco
   Arrivals defined by: Call of inject() function
   # of cars (including loco): 1
   Entry point defined as: offset on the track
   

   Railway track: trackReadyToDepart (Switch to the code field by clicking the icon)
   Offset from: Beginning of the track
   Offset of 1st car: tracklength - 15 meters
   New train: Train
   

   New rail car: Locomotive

2. This block checks whether the required number of the cars of the same type is already on the yard track, or not yet. Define the On exit (false) action. It is executed when the required number of rail cars is reached. The line trackReadyToDepart = agent.getTrack( true ); stores the current track to the variable trackReadyToDepart.
   

   The line newLoco.inject(); generates new locomotive. Being created, the loco follows to the block we create next.
   

   Set the following parameters in the Actions section of the SelectOutput block:
   

   On exit (false):
   trackReadyToDepart = agent.getTrack( true );
   newLoco.inject();
   

3. This TrainMoveTo block simulates how the loco moves to the cars ready to depart. Please note that the movement direction is Backward (the loco moves in the direction opposite to the track direction, from right to left). Then the loco couples with the cars and the resulting train passes to the flowchart branch simulating how the train leaves the yard.
   

   Set the following parameters for the TrainMoveTo block:
   Direction: Backward
   Route is: not specified (train will follow switches)
   Target is: not specified
   Cruise speed: 10 meters per second