com.graphhopper.routing.ch

Class CHAlgoFactoryDecorator

java.lang.Object

com.graphhopper.routing.ch.CHAlgoFactoryDecorator

All Implemented Interfaces:

RoutingAlgorithmFactoryDecorator

public class CHAlgoFactoryDecorator
extends Object
implements RoutingAlgorithmFactoryDecorator

This class implements the CH decorator for the routing algorithm factory and provides several helper methods related to CH preparation and its vehicle profiles.

Author:

Peter Karich

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CHAlgoFactoryDecorator.EdgeBasedCHMode Determines whether or not edge-based CH will be prepared for the different weightings/encoders.

Constructor Summary

Constructors

Constructor and Description
CHAlgoFactoryDecorator()

Method Summary

Modifier and Type	Method and Description
CHAlgoFactoryDecorator	addEdgeBasedWeighting(Weighting weighting)
CHAlgoFactoryDecorator	addNodeBasedWeighting(Weighting weighting) Decouple weightings from PrepareContractionHierarchies as we need weightings for the graphstorage and the graphstorage for the preparation.
CHAlgoFactoryDecorator	addPreparation(PrepareContractionHierarchies pch)
CHAlgoFactoryDecorator	addWeighting(String weighting)
void	createPreparations(GraphHopperStorage ghStorage)
RoutingAlgorithmFactory	getDecoratedAlgorithmFactory(RoutingAlgorithmFactory defaultAlgoFactory, HintsMap map) This method returns the specified algoFactory unchanged, decorates it or completely replaces it depending on the specified optionsMap.
CHAlgoFactoryDecorator.EdgeBasedCHMode	getEdgeBasedCHMode()
List<Weighting>	getEdgeBasedWeightings()
List<Weighting>	getNodeBasedWeightings()
PrepareContractionHierarchies	getPreparation(HintsMap map)
List<PrepareContractionHierarchies>	getPreparations()
int	getPreparationThreads()
List<String>	getWeightingsAsStrings()
boolean	hasWeightings()
void	init(CmdArgs args)
boolean	isDisablingAllowed()
boolean	isEnabled()
void	prepare(StorableProperties properties)
CHAlgoFactoryDecorator	setDisablingAllowed(boolean disablingAllowed) This method specifies if it is allowed to disable CH routing at runtime via routing hints.
CHAlgoFactoryDecorator	setEdgeBasedCHMode(CHAlgoFactoryDecorator.EdgeBasedCHMode edgeBasedCHMode) This method specifies whether or not edge-based CH preparation (needed for turn costs) should be performed.
CHAlgoFactoryDecorator	setEnabled(boolean enabled) Enables or disables contraction hierarchies (CH).
void	setPreparationThreads(int preparationThreads) This method changes the number of threads used for preparation on import.
CHAlgoFactoryDecorator	setWeightingsAsStrings(List<String> weightingList) Enables the use of contraction hierarchies to reduce query times.
CHAlgoFactoryDecorator	setWeightingsAsStrings(String... weightingNames)

Methods inherited from class java.lang.Object

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

Constructor Detail

CHAlgoFactoryDecorator

public CHAlgoFactoryDecorator()

Method Detail

init

public void init(CmdArgs args)

Specified by:

init in interface RoutingAlgorithmFactoryDecorator

isEnabled

public final boolean isEnabled()

Specified by:

isEnabled in interface RoutingAlgorithmFactoryDecorator

setEnabled

public final CHAlgoFactoryDecorator setEnabled(boolean enabled)

Enables or disables contraction hierarchies (CH). This speed-up mode is enabled by default.

isDisablingAllowed

public final boolean isDisablingAllowed()

setDisablingAllowed

public final CHAlgoFactoryDecorator setDisablingAllowed(boolean disablingAllowed)

This method specifies if it is allowed to disable CH routing at runtime via routing hints.

setEdgeBasedCHMode

public final CHAlgoFactoryDecorator setEdgeBasedCHMode(CHAlgoFactoryDecorator.EdgeBasedCHMode edgeBasedCHMode)

This method specifies whether or not edge-based CH preparation (needed for turn costs) should be performed.

See Also:

CHAlgoFactoryDecorator.EdgeBasedCHMode

addNodeBasedWeighting

public CHAlgoFactoryDecorator addNodeBasedWeighting(Weighting weighting)

Decouple weightings from PrepareContractionHierarchies as we need weightings for the graphstorage and the graphstorage for the preparation.

addEdgeBasedWeighting

public CHAlgoFactoryDecorator addEdgeBasedWeighting(Weighting weighting)

addWeighting

public CHAlgoFactoryDecorator addWeighting(String weighting)

addPreparation

public CHAlgoFactoryDecorator addPreparation(PrepareContractionHierarchies pch)

hasWeightings

public final boolean hasWeightings()

getNodeBasedWeightings

public final List<Weighting> getNodeBasedWeightings()

getEdgeBasedWeightings

public final List<Weighting> getEdgeBasedWeightings()

getEdgeBasedCHMode

public CHAlgoFactoryDecorator.EdgeBasedCHMode getEdgeBasedCHMode()

setWeightingsAsStrings

public CHAlgoFactoryDecorator setWeightingsAsStrings(String... weightingNames)

getWeightingsAsStrings

public List<String> getWeightingsAsStrings()

setWeightingsAsStrings

public CHAlgoFactoryDecorator setWeightingsAsStrings(List<String> weightingList)

Enables the use of contraction hierarchies to reduce query times. Enabled by default.

Parameters:

weightingList - A list containing multiple weightings like: "fastest", "shortest" or your own weight-calculation type.

getPreparations

public List<PrepareContractionHierarchies> getPreparations()

getDecoratedAlgorithmFactory

public RoutingAlgorithmFactory getDecoratedAlgorithmFactory(RoutingAlgorithmFactory defaultAlgoFactory,
                                                            HintsMap map)

Description copied from interface: RoutingAlgorithmFactoryDecorator

This method returns the specified algoFactory unchanged, decorates it or completely replaces it depending on the specified optionsMap.

Specified by:

getDecoratedAlgorithmFactory in interface RoutingAlgorithmFactoryDecorator

getPreparation

public PrepareContractionHierarchies getPreparation(HintsMap map)

getPreparationThreads

public int getPreparationThreads()

setPreparationThreads

public void setPreparationThreads(int preparationThreads)

This method changes the number of threads used for preparation on import. Default is 1. Make sure that you have enough memory when increasing this number!

prepare

public void prepare(StorableProperties properties)

createPreparations

public void createPreparations(GraphHopperStorage ghStorage)