at.ac.ait.ariadne.routeformat.util

Class RouteSegmentMerger

java.lang.Object

at.ac.ait.ariadne.routeformat.util.RouteSegmentMerger

public class RouteSegmentMerger
extends Object

Merges a list of a list of consecutive segments (i.e. roughly without jumps such as the end of one segment is 1km away from the start of the next segment ), where the latter is considered a Route.

Between two routes time gaps are handled as follows:

• for positive gaps the second route will get the gap added as boarding time in the first segment not included in getWriteWaitingTimePreferableNotInto() (or as alighting time if the segment is Constants.DetailedModeOfTransportType.TRANSFER).
• for negative gaps (=overlaps) the second route will be shifted so that the gap is zero (and a warning will be logged if the shifted routes contain non-foot segments because this may lead to wrong routes, i.e. shifting public transport routes is probably not useful)

With setMergeSegmentsWithSameMot(boolean) merging of adjacent segments with (exactly!) the same mode of transport, which is activated by default, can be (de)activated. Note, that for merged segments boarding and alighting time is simply summed up and the geometry is simply concatenated without recalculating the distance.

With setAdditionalAlightingSecondsBetweenRoutes(List) additional alighting seconds can be added.

Author:

AIT Austrian Institute of Technology GmbH

Constructor Summary

Constructors

Constructor and Description
RouteSegmentMerger(List<List<RouteSegment>> routes)

Method Summary

Modifier and Type	Method and Description
List<RouteSegment>	createMergedSegments()
List<Integer>	getAdditionalAlightingSecondsBetweenRoutes()
Set<ModeOfTransport>	getWriteWaitingTimePreferableNotInto()
boolean	isMergeSegmentsWithSameMot()
void	setAdditionalAlightingSecondsBetweenRoutes(List<Integer> additionalAlightingSecondsBetweenRoutes)
void	setMergeSegmentsWithSameMot(boolean mergeSegmentsWithSameMot)
void	setWriteWaitingTimePreferableNotInto(Set<ModeOfTransport> writeWaitingTimePreferableNotInto)

Methods inherited from class java.lang.Object

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

Constructor Detail

RouteSegmentMerger

public RouteSegmentMerger(List<List<RouteSegment>> routes)

Parameters:

routes - the routes to be merged into one route. lists must not be empty.

Method Detail

isMergeSegmentsWithSameMot

public boolean isMergeSegmentsWithSameMot()

setMergeSegmentsWithSameMot

public void setMergeSegmentsWithSameMot(boolean mergeSegmentsWithSameMot)

getWriteWaitingTimePreferableNotInto

public Set<ModeOfTransport> getWriteWaitingTimePreferableNotInto()

Returns:

a mutable copy of the internal set

setWriteWaitingTimePreferableNotInto

public void setWriteWaitingTimePreferableNotInto(Set<ModeOfTransport> writeWaitingTimePreferableNotInto)

getAdditionalAlightingSecondsBetweenRoutes

public List<Integer> getAdditionalAlightingSecondsBetweenRoutes()

Returns:

a mutable copy of the internal list

setAdditionalAlightingSecondsBetweenRoutes

public void setAdditionalAlightingSecondsBetweenRoutes(List<Integer> additionalAlightingSecondsBetweenRoutes)

createMergedSegments

public List<RouteSegment> createMergedSegments()