Package jmri.jmrit.operations.router

Class Router

java.lang.Object

jmri.jmrit.operations.trains.trainbuilder.TrainCommon

jmri.jmrit.operations.router.Router

All Implemented Interfaces:

InstanceManagerAutoDefault

public class Router
extends TrainCommon
implements InstanceManagerAutoDefault

Router for car movement. This code attempts to find a way (a route) to move a car to its final destination through the use of two or more trains. First the code tries to move car using a single train. If that fails, attempts are made using two trains via a classification/interchange (C/I) tracks, then yard tracks if enabled. Next attempts are made using three or more trains using any combination of C/I and yard tracks. If that fails and routing via staging is enabled, the code tries two trains using staging tracks, then multiple trains using a combination of C/I, yards, and staging tracks. Currently the router is limited to seven trains.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) PrintWriter	_buildReport
protected List<Train>	_excludeTrains
protected final List<Track>	_lastLocationTracks
protected final List<Train>	_lastLocationTrains
protected Hashtable<String,Train>	_listTrains
protected final List<Track>	_next2ndLocationTracks
protected final List<Track>	_next3rdLocationTracks
protected final List<Track>	_next4thLocationTracks
protected final List<Track>	_nextLocationTracks
protected final List<Train>	_nextLocationTrains
(package private) Date	_startTime
protected static final String	STATUS_NOT_ABLE
protected static final String	STATUS_NOT_THIS_TRAIN
static final String	STATUS_NOT_THIS_TRAIN_PREFIX
protected static final String	STATUS_ROUTER_DISABLED
(package private) TrainManager	tmanager

Fields inherited from class jmri.jmrit.operations.trains.trainbuilder.TrainCommon

_dropCars, _pickupCars, BLANK_LINE, BUILD_REPORT_CHAR, carManager, ENGINE, engineManager, HORIZONTAL_LINE_CHAR, HYPHEN, IS_MANIFEST, IS_TWO_COLUMN_TRACK, LOCAL, locationManager, NEW_LINE, PAPER_MARGINS, PICKUP, SPACE, TAB, TEXT_COLOR_DONE, TEXT_COLOR_END, TEXT_COLOR_START, VERTICAL_LINE_CHAR

Constructor Summary

Constructors

Constructor	Description
Router()

Method Summary

Modifier and Type	Method	Description
String	getStatus()	Returns the status of the router when using the setDestination() for a car.
boolean	isCarRouteable(Car car, Train train, Location destination, Track track, PrintWriter buildReport)
boolean	isCarRouteable(Car car, Train train, Track track, PrintWriter buildReport)	Determines if car can be routed to the destination track
boolean	setDestination(Car car, Train train, PrintWriter buildReport)	Attempts to set the car's destination if a final destination exists.

Methods inherited from class jmri.jmrit.operations.trains.trainbuilder.TrainCommon

addCarsLocationUnknown, addLine, addLine, blockCarsByTrack, blockCarsByTrackNameTwoColumn, blockCarsTwoColumn, blockLocosTwoColumn, clearUtilityCarTypes, convertStringTime, convertStringToDate, countPickupUtilityCars, countSetoutUtilityCars, countUtilityCars, createTabIfNeeded, dropCar, dropCar, dropEngine, dropEngines, formatColorString, formatStringToCommaSeparated, getDate, getDate, getDropCarHeader, getDropEngineHeader, getISO8601Date, getLineLength, getLocalMoveHeader, getManifestHeaderLineLength, getPageSize, getPickupCarHeader, getPickupEngineHeader, getSwitchListTrainStatus, getTextColor, getTextColorName, getTextColorString, getTrainMessage, isNextCar, isNextCar, isThereWorkAtLocation, isThereWorkAtLocation, localMoveCar, newLine, newLine, padAndTruncate, padAndTruncateIfNeeded, padString, pickupCar, pickUpCar, pickUpCarTruncated, pickupEngine, pickupEngines, pickupUtilityCars, pickupUtilityCars, printCarHeader, printDropCarHeader, printDropEngineHeader, printEngineHeader, printHorizontalLine, printHorizontalLine, printHorizontalLine1, printHorizontalLine2, printHorizontalLine3, printLocalCarMoveHeader, printPickupCarHeader, printPickupEngineHeader, printTrackComments, printTrackNameHeader, setCarPickupAndSetoutTimes, setoutUtilityCars, setoutUtilityCars, setoutUtilityCars, splitString, splitStringLeftParenthesis, tabString, truncatedDropCar

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

tmanager

TrainManager tmanager

_nextLocationTracks

protected final List<Track> _nextLocationTracks

_lastLocationTracks

protected final List<Track> _lastLocationTracks

_next2ndLocationTracks

protected final List<Track> _next2ndLocationTracks

_next3rdLocationTracks

protected final List<Track> _next3rdLocationTracks

_next4thLocationTracks

protected final List<Track> _next4thLocationTracks

_nextLocationTrains

protected final List<Train> _nextLocationTrains

_lastLocationTrains

protected final List<Train> _lastLocationTrains

_excludeTrains

protected List<Train> _excludeTrains

_listTrains

protected Hashtable<String,Train> _listTrains

STATUS_NOT_THIS_TRAIN

protected static final String STATUS_NOT_THIS_TRAIN

STATUS_NOT_THIS_TRAIN_PREFIX

public static final String STATUS_NOT_THIS_TRAIN_PREFIX

STATUS_NOT_ABLE

protected static final String STATUS_NOT_ABLE

STATUS_ROUTER_DISABLED

protected static final String STATUS_ROUTER_DISABLED

_buildReport

PrintWriter _buildReport

_startTime

Date _startTime

Constructor Details

Router

public Router()

Method Details

getStatus

public String getStatus()

Returns the status of the router when using the setDestination() for a car.

Returns:

Track.OKAY, STATUS_NOT_THIS_TRAIN, STATUS_NOT_ABLE, STATUS_ROUTER_DISABLED, or the destination track status is there's an issue.

isCarRouteable

public boolean isCarRouteable(Car car,
 Train train,
 Track track,
 PrintWriter buildReport)

Determines if car can be routed to the destination track

Parameters:

car - the car being tested

train - the first train servicing the car, can be null

track - the destination track, can not be null

buildReport - the report, can be null

Returns:

true if the car can be routed to the track

isCarRouteable

public boolean isCarRouteable(Car car,
 Train train,
 Location destination,
 Track track,
 PrintWriter buildReport)

setDestination

public boolean setDestination(Car car,
 Train train,
 PrintWriter buildReport)

Attempts to set the car's destination if a final destination exists. Only sets the car's destination if the train is part of the car's route.

Parameters:

car - the car to route

train - the first train to carry this car, can be null

buildReport - PrintWriter for build report, and can be null

Returns:

true if car can be routed.