Package org.planit.project

Class PlanItProjectInput

java.lang.Object

org.planit.project.PlanItProjectInput

public class PlanItProjectInput
extends Object

Class that holds all the input traffic components for a PLANit project. The PLANit project holds an instance of this class and delegates all calls relating to inputs to this class.

Author:

markr

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	PlanItProjectInput.ProjectDemands	Internal class for registered demands
class	PlanItProjectInput.ProjectNetworks	Internal class for registered physical networks
class	PlanItProjectInput.ProjectODPathSets	Internal class for registered od path sets
class	PlanItProjectInput.ProjectZonings	Internal class for registered zonings

Field Summary

Fields

Modifier and Type	Field	Description
PlanItProjectInput.ProjectDemands	demands	The registered demands
protected TrafficAssignmentComponentFactory<Demands>	demandsFactory	Object factory for demands object
protected TreeMap<Long,Demands>	demandsMap	The demands registered on this project
protected TrafficAssignmentComponentFactory<Network>	infrastructureNetworkFactory	Object Factory for infrastructure network object
protected TreeMap<Long,InfrastructureNetwork>	infrastructureNetworkMap	The physical networks registered on this project
protected Map<InfrastructureNetwork,List<InitialLinkSegmentCost>>	initialLinkSegmentCosts	Map to store all InitialLinkSegmentCost objects for each physical network
protected TrafficAssignmentComponentFactory<InitialPhysicalCost>	initialPhysicalCostFactory	Object factory for physical costs
PlanItProjectInput.ProjectODPathSets	odPathSets	The registered OD path sets
protected TrafficAssignmentComponentFactory<ODPathSets>	odPathSetsFactory	Object factory for od path sets object
protected TreeMap<Long,ODPathSets>	odPathSetsMap	The od path sets registered on this project
PlanItProjectInput.ProjectNetworks	physicalNetworks	The registered physical networks
protected TrafficAssignmentComponentFactory<Zoning>	zoningFactory	Object factory for zoning objects
PlanItProjectInput.ProjectZonings	zonings	The registered zonings
protected TreeMap<Long,Zoning>	zoningsMap	The zonings registered on this project

Constructor Summary

Constructors

Constructor	Description
PlanItProjectInput(long projectId, IdGroupingToken projectGroupId, InputBuilderListener inputBuilderListener)	Constructor

Method Summary

Modifier and Type	Method	Description
Demands	createAndRegisterDemands(Zoning zoning, InfrastructureNetwork network)	Create and register demands to the project inputs
InfrastructureNetwork	createAndRegisterInfrastructureNetwork(String infrastructureNetworkType)	Create and register an infrastructure based network on the project input
InitialLinkSegmentCost	createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network, String fileName)	Create and register initial link segment costs from a (single) file which we assume are available in the native xml/csv output format as provided in this project
List<InitialLinkSegmentCostPeriod>	createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network, String fileName, Demands demands)	Create and register initial link segment costs from a (single) file for all time periods in Demands object
InitialLinkSegmentCostPeriod	createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network, String fileName, TimePeriod timePeriod)	Create and register initial link segment costs from a (single) file for each time period
ODPathSets	createAndRegisterOdPathSets(InfrastructureLayer networkLayer, Zoning zoning, String odPathSetInputPath)	Create and register the OD path sets on the project input
Zoning	createAndRegisterZoning(InfrastructureNetwork infrastructureNetwork)	Create and register the zoning system on the network and project input
List<InitialLinkSegmentCost>	getInitialLinkSegmentCost(InfrastructureNetwork network)	Return the initial link segment costs for a network

Methods inherited from class java.lang.Object

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

Field Detail

infrastructureNetworkMap

protected final TreeMap<Long,InfrastructureNetwork> infrastructureNetworkMap

The physical networks registered on this project

demandsMap

protected final TreeMap<Long,Demands> demandsMap

The demands registered on this project

odPathSetsMap

protected final TreeMap<Long,ODPathSets> odPathSetsMap

The od path sets registered on this project

zoningsMap

protected final TreeMap<Long,Zoning> zoningsMap

The zonings registered on this project

initialLinkSegmentCosts

protected final Map<InfrastructureNetwork,List<InitialLinkSegmentCost>> initialLinkSegmentCosts

Map to store all InitialLinkSegmentCost objects for each physical network

infrastructureNetworkFactory

protected TrafficAssignmentComponentFactory<Network> infrastructureNetworkFactory

Object Factory for infrastructure network object

demandsFactory

protected TrafficAssignmentComponentFactory<Demands> demandsFactory

Object factory for demands object

zoningFactory

protected TrafficAssignmentComponentFactory<Zoning> zoningFactory

Object factory for zoning objects

odPathSetsFactory

protected TrafficAssignmentComponentFactory<ODPathSets> odPathSetsFactory

Object factory for od path sets object

initialPhysicalCostFactory

protected TrafficAssignmentComponentFactory<InitialPhysicalCost> initialPhysicalCostFactory

Object factory for physical costs

physicalNetworks

public final PlanItProjectInput.ProjectNetworks physicalNetworks

The registered physical networks

demands

public final PlanItProjectInput.ProjectDemands demands

The registered demands

zonings

public final PlanItProjectInput.ProjectZonings zonings

The registered zonings

odPathSets

public final PlanItProjectInput.ProjectODPathSets odPathSets

The registered OD path sets

Constructor Detail

PlanItProjectInput

public PlanItProjectInput(long projectId,
                          IdGroupingToken projectGroupId,
                          InputBuilderListener inputBuilderListener)

Constructor

Parameters:

projectId - the projectId

projectGroupId - the id generator token

inputBuilderListener - the input builder to parse inputs

Method Detail

createAndRegisterInfrastructureNetwork

public InfrastructureNetwork createAndRegisterInfrastructureNetwork(String infrastructureNetworkType)
                                                             throws PlanItException

Create and register an infrastructure based network on the project input

Parameters:

infrastructureNetworkType - name of infrastructure network class to register

Returns:

the generated network

Throws:

PlanItException - thrown if there is an error

createAndRegisterZoning

public Zoning createAndRegisterZoning(InfrastructureNetwork infrastructureNetwork)
                               throws PlanItException

Create and register the zoning system on the network and project input

Parameters:

infrastructureNetwork - the infrastructure network on which the zoning will be based

Returns:

the generated zoning object

Throws:

PlanItException - thrown if there is an error

createAndRegisterDemands

public Demands createAndRegisterDemands(Zoning zoning,
                                        InfrastructureNetwork network)
                                 throws PlanItException

Create and register demands to the project inputs

Parameters:

zoning - zoning object which defines the zones which will be used in the demand matrix to be created

network - the network which stores the modes (demands can different for each mode)

Returns:

the generated demands object

Throws:

PlanItException - thrown if there is an error

createAndRegisterOdPathSets

public ODPathSets createAndRegisterOdPathSets(InfrastructureLayer networkLayer,
                                              Zoning zoning,
                                              String odPathSetInputPath)
                                       throws PlanItException

Create and register the OD path sets on the project input

Parameters:

networkLayer - network the paths must be compatible with

zoning - zoning to match od paths to

odPathSetInputPath - path to collect the paths from

Returns:

od path sets that have been parsed

Throws:

PlanItException - thrown if there is an error

createAndRegisterInitialLinkSegmentCost

public InitialLinkSegmentCost createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network,
                                                                      String fileName)
                                                               throws PlanItException

Create and register initial link segment costs from a (single) file which we assume are available in the native xml/csv output format as provided in this project

Parameters:

network - network the InitialLinkSegmentCost object will be registered for

fileName - file containing the initial link segment cost values

Returns:

the InitialLinkSegmentCost object

Throws:

PlanItException - thrown if there is an error

createAndRegisterInitialLinkSegmentCost

public InitialLinkSegmentCostPeriod createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network,
                                                                            String fileName,
                                                                            TimePeriod timePeriod)
                                                                     throws PlanItException

Create and register initial link segment costs from a (single) file for each time period

Parameters:

network - network the InitialLinkSegmentCost object will be registered for

fileName - location of file containing the initial link segment cost values

timePeriod - the current time period

Returns:

the InitialLinkSegmentCost object

Throws:

PlanItException - thrown if there is an error

createAndRegisterInitialLinkSegmentCost

public List<InitialLinkSegmentCostPeriod> createAndRegisterInitialLinkSegmentCost(InfrastructureNetwork network,
                                                                                  String fileName,
                                                                                  Demands demands)
                                                                           throws PlanItException

Create and register initial link segment costs from a (single) file for all time periods in Demands object

Parameters:

network - network the InitialLinkSegmentCost object will be registered for

fileName - location of file containing the initial link segment cost values

demands - the Demands object

Returns:

the InitialLinkSegmentCost object

Throws:

PlanItException - thrown if there is an error

getInitialLinkSegmentCost

public List<InitialLinkSegmentCost> getInitialLinkSegmentCost(InfrastructureNetwork network)

Return the initial link segment costs for a network

Parameters:

network - the specified network

Returns:

the initial link segment costs for the specified physical network