org.opentripplanner.standalone

Class GraphBuilderParameters

java.lang.Object

org.opentripplanner.standalone.GraphBuilderParameters

public class GraphBuilderParameters
extends Object

These are parameters that when changed, necessitate a Graph rebuild. They are distinct from the RouterParameters which can be applied to a pre-built graph or on the fly at runtime. Eventually both classes may be initialized from the same config file so make sure there is no overlap in the JSON keys used. These used to be command line parameters, but there were getting to be too many of them and besides, we want to allow different graph builder configuration for each Graph.

TODO maybe have only one giant config file and just annotate the parameters to indicate which ones trigger a rebuild ...or just feed the same JSON tree to two different classes, one of which is the build configuration and the other is the router configuration.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	areaVisibility Perform visibility calculations on OSM areas (these calculations can be time consuming).
CustomNamer	customNamer A custom OSM namer to use.
static double	DEFAULT_SUBWAY_ACCESS_TIME
S3BucketConfig	elevationBucket If specified, download NED elevation tiles from the given AWS S3 bucket.
boolean	embedRouterConfig Embed the Router config in the graph, which allows it to be sent to a server fully configured over the wire.
FareServiceFactory	fareServiceFactory A specific fares service to use.
boolean	fetchElevationUS Download US NED elevation data and apply it to the graph.
boolean	htmlAnnotations Generates nice HTML report of Graph errors/warnings (annotations).
boolean	matchBusRoutesToStreets Based on GTFS shape data, guess which OSM streets each bus runs on to improve stop linking.
int	maxHtmlAnnotationsPerFile If number of annotations is larger then specified number annotations will be split in multiple files.
int	maxInterlineDistance Maximal distance between stops in meters that will connect consecutive trips that are made with same vehicle
boolean	parentStopLinking Link GTFS stops to their parent stops.
boolean	staticBikeParkAndRide Whether we should create bike P+R stations from OSM data.
boolean	staticBikeRental Whether bike rental stations should be loaded from OSM, rather than periodically dynamically pulled from APIs.
boolean	staticParkAndRide Whether we should create car P+R stations from OSM data.
boolean	stationTransfers Create direct transfers between the constituent stops of each parent station.
boolean	streets Include street input files (OSM/PBF).
double	subwayAccessTime Minutes necessary to reach stops served by trips on routes of route_type=1 (subway) from the street.
boolean	transit Include all transit input files (GTFS) from scanned directory.
boolean	useTransfersTxt Create direct transfer edges from transfers.txt in GTFS, instead of based on distance.

Constructor Summary

Constructors

Constructor and Description
GraphBuilderParameters(com.fasterxml.jackson.databind.JsonNode config) Set all parameters from the given Jackson JSON tree, applying defaults.

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SUBWAY_ACCESS_TIME

public static double DEFAULT_SUBWAY_ACCESS_TIME

htmlAnnotations

public final boolean htmlAnnotations

Generates nice HTML report of Graph errors/warnings (annotations). They are stored in the same location as the graph.

maxHtmlAnnotationsPerFile

public final int maxHtmlAnnotationsPerFile

If number of annotations is larger then specified number annotations will be split in multiple files. Since browsers have problems opening large HTML files.

transit

public final boolean transit

Include all transit input files (GTFS) from scanned directory.

useTransfersTxt

public final boolean useTransfersTxt

Create direct transfer edges from transfers.txt in GTFS, instead of based on distance.

parentStopLinking

public final boolean parentStopLinking

Link GTFS stops to their parent stops.

stationTransfers

public final boolean stationTransfers

Create direct transfers between the constituent stops of each parent station.

subwayAccessTime

public final double subwayAccessTime

Minutes necessary to reach stops served by trips on routes of route_type=1 (subway) from the street. Perhaps this should be a runtime router parameter rather than a graph build parameter.

streets

public final boolean streets

Include street input files (OSM/PBF).

embedRouterConfig

public final boolean embedRouterConfig

Embed the Router config in the graph, which allows it to be sent to a server fully configured over the wire.

areaVisibility

public final boolean areaVisibility

Perform visibility calculations on OSM areas (these calculations can be time consuming).

matchBusRoutesToStreets

public final boolean matchBusRoutesToStreets

Based on GTFS shape data, guess which OSM streets each bus runs on to improve stop linking.

fetchElevationUS

public final boolean fetchElevationUS

Download US NED elevation data and apply it to the graph.

elevationBucket

public final S3BucketConfig elevationBucket

If specified, download NED elevation tiles from the given AWS S3 bucket.

fareServiceFactory

public final FareServiceFactory fareServiceFactory

A specific fares service to use.

customNamer

public final CustomNamer customNamer

A custom OSM namer to use.

staticBikeRental

public boolean staticBikeRental

Whether bike rental stations should be loaded from OSM, rather than periodically dynamically pulled from APIs.

staticParkAndRide

public boolean staticParkAndRide

Whether we should create car P+R stations from OSM data.

staticBikeParkAndRide

public boolean staticBikeParkAndRide

Whether we should create bike P+R stations from OSM data.

maxInterlineDistance

public int maxInterlineDistance

Maximal distance between stops in meters that will connect consecutive trips that are made with same vehicle

Constructor Detail

GraphBuilderParameters

public GraphBuilderParameters(com.fasterxml.jackson.databind.JsonNode config)

Set all parameters from the given Jackson JSON tree, applying defaults. Supplying MissingNode.getInstance() will cause all the defaults to be applied. This could be done automatically with the "reflective query scraper" but it's less type safe and less clear. Until that class is more type safe, it seems simpler to just list out the parameters by name here.