Package org.onebusaway.gtfs_merge.strategies

Class ShapePointMergeStrategy

java.lang.Object

org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

org.onebusaway.gtfs_merge.strategies.AbstractCollectionEntityMergeStrategy<AgencyAndId>

org.onebusaway.gtfs_merge.strategies.ShapePointMergeStrategy

All Implemented Interfaces:

EntityMergeStrategy

public class ShapePointMergeStrategy
extends AbstractCollectionEntityMergeStrategy<AgencyAndId>

Entity merge strategy for handling ShapePoint entities. Shape points are an example of an entity collection, since multiple shape point entities are linked by a sinlge shape_id.

Author:

bdferris

Field Summary

Fields inherited from class org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

_duplicateDetectionStrategy, _logDuplicatesStrategy, _minElementDuplicateScoreForFuzzyMatch, _minElementsDuplicateScoreForAutoDetect, _minElementsInCommonScoreForAutoDetect

Constructor Summary

Constructors

Constructor	Description
ShapePointMergeStrategy()

Method Summary

Modifier and Type	Method	Description
void	getEntityTypes(Collection<Class<?>> entityTypes)	Determine the list of entity types handled by this merge strategy.
protected Collection<AgencyAndId>	getKeys(GtfsRelationalDao dao)	An entity-specific method to determine the set of unique identifiers used by collection entities in the specified GTFS feed.
protected void	renameKey(GtfsMergeContext context, AgencyAndId oldId, AgencyAndId newId)	If we detect that an entity collection in the source input feed duplicates an entity collection in the merged output feed, we rename all references to the old id in the source feed to use the id of the entity in the merged feed.
protected void	saveElementsForKey(GtfsMergeContext context, AgencyAndId shapeId)	Writes the specified entity collection to the merged output feed.
protected double	scoreDuplicateKey(GtfsMergeContext context, AgencyAndId key)	Given an id identifying an entity collection in both the source input feed and the merged output feed, produce a score between 0.0 and 1.0 identifying how likely it is that the two entity collections are one and the same, where 0.0 means they having nothing in common and 1.0 meaning they are exactly the same.

Methods inherited from class org.onebusaway.gtfs_merge.strategies.AbstractCollectionEntityMergeStrategy

getDescription, getRawKey, merge, pickBestDuplicateDetectionStrategy

Methods inherited from class org.onebusaway.gtfs_merge.strategies.AbstractEntityMergeStrategy

determineDuplicateDetectionStrategy, getDuplicateRenamingStrategy, setDuplicateDetectionStrategy, setDuplicateRenamingStrategy, setLogDuplicatesStrategy

Methods inherited from class java.lang.Object

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

Constructor Details

ShapePointMergeStrategy

public ShapePointMergeStrategy()

Method Details

getEntityTypes

public void getEntityTypes(Collection<Class<?>> entityTypes)

Description copied from interface: EntityMergeStrategy

Determine the list of entity types handled by this merge strategy.

Parameters:

entityTypes - the handled types should be added to this output collection.

getKeys

protected Collection<AgencyAndId> getKeys(GtfsRelationalDao dao)

Description copied from class: AbstractCollectionEntityMergeStrategy

An entity-specific method to determine the set of unique identifiers used by collection entities in the specified GTFS feed.

Specified by:

getKeys in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

dao -

Returns:

the set of unique identifiers

scoreDuplicateKey

protected double scoreDuplicateKey(GtfsMergeContext context,
 AgencyAndId key)

Description copied from class: AbstractCollectionEntityMergeStrategy

Given an id identifying an entity collection in both the source input feed and the merged output feed, produce a score between 0.0 and 1.0 identifying how likely it is that the two entity collections are one and the same, where 0.0 means they having nothing in common and 1.0 meaning they are exactly the same.

Specified by:

scoreDuplicateKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

key -

Returns:

renameKey

protected void renameKey(GtfsMergeContext context,
 AgencyAndId oldId,
 AgencyAndId newId)

Description copied from class: AbstractCollectionEntityMergeStrategy

If we detect that an entity collection in the source input feed duplicates an entity collection in the merged output feed, we rename all references to the old id in the source feed to use the id of the entity in the merged feed. That way, when examining other entities in the source feed that referenced the original entity collection with entities in the target feed that reference the duplicate entity, both sets of entity will now appear to reference the same thing. This can be useful for similarity detection.

Specified by:

renameKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

oldId - the original id in the source input feed

newId - the new id, which replaces the old in the source input feed

saveElementsForKey

protected void saveElementsForKey(GtfsMergeContext context,
 AgencyAndId shapeId)

Description copied from class: AbstractCollectionEntityMergeStrategy

Writes the specified entity collection to the merged output feed.

Specified by:

saveElementsForKey in class AbstractCollectionEntityMergeStrategy<AgencyAndId>

Parameters:

context -

shapeId - the identifier for the entity collection to save