org.transitime.core

Class SpatialMatcher

java.lang.Object

org.transitime.core.SpatialMatcher

public class SpatialMatcher
extends java.lang.Object

For determining possible spatial matches. A spatial match is when the AVL report location is within allowable distance of the path segment and the heading is OK and the distance to the segment is a local minimum (it is a best match).

Author:

SkiBu Smith

Method Summary

Modifier and Type	Method and Description
static java.util.List<SpatialMatch>	getSpatialMatches(AvlReport avlReport, Block block, java.util.List<Trip> tripsToInvestigate) Goes through the Block assignment data and determines the closest spatial matches.
static java.util.List<SpatialMatch>	getSpatialMatches(VehicleState vehicleState) Starts at the previous match and goes from that point forward through the block assignment looking for the best spatial matches.
static java.util.List<SpatialMatch>	getSpatialMatchesIgnoringLayovers(AvlReport avlReport, Block block, java.util.List<Trip> tripsToInvestigate) Goes through the Block assignment data and determines the closest spatial matches that are not for layovers.
static boolean	problemMatchDueToLackOfHeadingInfo(SpatialMatch spatialMatch, VehicleState vehicleState) Checks to see if for a non-layover match if can verify that the vehicle is moving in the proper direction.

Methods inherited from class java.lang.Object

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

Method Detail

problemMatchDueToLackOfHeadingInfo

public static boolean problemMatchDueToLackOfHeadingInfo(SpatialMatch spatialMatch,
                                                         VehicleState vehicleState)

Checks to see if for a non-layover match if can verify that the vehicle is moving in the proper direction. This is intended to avoid matching vehicle to wrong trip. Only concerned with non-layover matches because for layovers heading doesn't matter since vehicle is supposed to be able to move around on indeterminate path to the layover stop.

If cannot confirm that the heading of the vehicle matches then should reject all matches so that won't wrongly match to a layover for another trip. When get another AVL report for the vehicle will then be able to see if heading proper using two AVL reports.

Parameters:

spatialMatch - The spatial match that should be investigated

vehicleState - For determining previous AVL reports

Returns:

True if for a non-layover match that couldn't verify that vehicle heading in proper direction for the match.

getSpatialMatches

public static java.util.List<SpatialMatch> getSpatialMatches(AvlReport avlReport,
                                                             Block block,
                                                             java.util.List<Trip> tripsToInvestigate)

Goes through the Block assignment data and determines the closest spatial matches. For first matching a vehicle to a block assignment. Matches must be within getMaxAllowableDistanceFromSegment() except layovers are always included since vehicle are allowed to be away from the route path during layovers.

Parameters:

avlReport - The AVL report to match to the block

block - The block being investigated

tripsToInvestigate - List of trips that should bother investigating. The calling function can determine which trips are currently active and pass that list in such that this method doesn't need to look through all trips.

Returns:

non-null possibly empty list of spatial matches

getSpatialMatchesIgnoringLayovers

public static java.util.List<SpatialMatch> getSpatialMatchesIgnoringLayovers(AvlReport avlReport,
                                                                             Block block,
                                                                             java.util.List<Trip> tripsToInvestigate)

Goes through the Block assignment data and determines the closest spatial matches that are not for layovers. For first matching a vehicle to a block assignment. Matches must be within getMaxAllowableDistanceFromSegment() except layovers are always included since vehicle are allowed to be away from the route path during layovers.

Parameters:

avlReport - The AVL report to match to the block

block - The block to investigate

tripsToInvestigate - List of trips that should bother investigating. The calling function can determine which trips are currently active and pass that list in such that this method doesn't need to look through all trips.

Returns:

non-null possibly empty list of spatial matches

getSpatialMatches

public static java.util.List<SpatialMatch> getSpatialMatches(VehicleState vehicleState)

Starts at the previous match and goes from that point forward through the block assignment looking for the best spatial matches. Intended for when have a predictable vehicle already matched to an assignment and then get a new AVL report that needs to be matched.

Parameters:

vehicleState - the previous vehicle state

Returns:

list of possible spatial matches. If no spatial matches then returns empty list (as opposed to null)