Package org.goplanit.cost.virtual

Class FixedConnectoidTravelTimeCost

java.lang.Object

org.goplanit.component.PlanitComponent<AbstractVirtualCost>

org.goplanit.cost.virtual.AbstractVirtualCost

org.goplanit.cost.virtual.FixedConnectoidTravelTimeCost

All Implemented Interfaces:

Serializable, Cloneable, Comparable<IdAble>, EventListener, PlanitComponentListener, Cost<ConnectoidSegment>, VirtualCost, EventListener, ExternalIdAble, IdAble

public class FixedConnectoidTravelTimeCost
extends AbstractVirtualCost

Class holding fixed connectoid costs for each connectoid segment

Author:

markr

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static double	DEFAULT_FIXED_COST	Default fixed cost
protected double	fixedConnectoidCost	Fixed connectoid cost for connectoid segments

Fields inherited from interface org.goplanit.cost.virtual.VirtualCost

FIXED, SPEED

Constructor Summary

Constructors

Constructor	Description
FixedConnectoidTravelTimeCost(FixedConnectoidTravelTimeCost other)	Copy Constructor
FixedConnectoidTravelTimeCost(IdGroupingToken groupId)	Constructor

Method Summary

Modifier and Type	Method	Description
FixedConnectoidTravelTimeCost	clone()	Create a shallow copy of this entity
double	getDTravelTimeDFlow(boolean uncongested, Mode mode, ConnectoidSegment connectoidSegment)	fixed cost so derivative is always zero
double	getGeneralisedCost(Mode mode, ConnectoidSegment connectoidSegment)	Returns the generalised cost of travel along an edge segment for a specified mode
double	getTravelTimeCost(Mode mode, ConnectoidSegment connectoidSegment)	Returns the generalised cost of travel along an edge segment for a specified mode
void	initialiseBeforeSimulation(VirtualNetwork virtualNetwork)	Initialize the virtual cost component
void	populateWithCost(VirtualNetwork virtualNetwork, Mode mode, double[] costToFill)	Invoker expects (mode specific ) costs in passed in array to be filled, where each entry signifies a link segment by its id
void	reset()	Chosen cost is considered configuration not internal state, so upon resetting the chosen cost remains in tact
void	setFixedConnectoidCost(double fixedConnectoidCost)	set the fixed cost used for all relevant link segments
void	updateTimePeriod(TimePeriod timePeriod)	Provide the cost calculation with information regarding the time period for which the cost is to be calculated

Methods inherited from class org.goplanit.component.PlanitComponent

equals, getComponentType, getExternalId, getId, getIdGroupingToken, getKnownSupportedEventTypes, getXmlId, hashCode, onPlanitComponentEvent, setExternalId, setXmlId

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.goplanit.utils.event.EventListener

hasKnownSupportedEventTypes

Methods inherited from interface org.goplanit.utils.id.ExternalIdAble

hasExternalId, hasXmlId

Methods inherited from interface org.goplanit.utils.id.IdAble

compareTo, idEquals, idHashCode

Field Detail

fixedConnectoidCost

protected double fixedConnectoidCost

Fixed connectoid cost for connectoid segments

DEFAULT_FIXED_COST

public static final double DEFAULT_FIXED_COST

Default fixed cost

See Also:

Constant Field Values

Constructor Detail

FixedConnectoidTravelTimeCost

public FixedConnectoidTravelTimeCost(IdGroupingToken groupId)

Constructor

Parameters:

groupId - contiguous id generation within this group for instances of this class

FixedConnectoidTravelTimeCost

public FixedConnectoidTravelTimeCost(FixedConnectoidTravelTimeCost other)

Copy Constructor

Parameters:

other - to copy

Method Detail

setFixedConnectoidCost

public void setFixedConnectoidCost(double fixedConnectoidCost)

set the fixed cost used for all relevant link segments

Parameters:

fixedConnectoidCost - the fixed cost to use

initialiseBeforeSimulation

public void initialiseBeforeSimulation(VirtualNetwork virtualNetwork)
                                throws PlanItException

Initialize the virtual cost component

Specified by:

initialiseBeforeSimulation in class AbstractVirtualCost

Parameters:

virtualNetwork - the virtual network

Throws:

PlanItException - thrown if a link/mode combination exists for which no cost parameters have been set

updateTimePeriod

public void updateTimePeriod(TimePeriod timePeriod)

Provide the cost calculation with information regarding the time period for which the cost is to be calculated

Specified by:

updateTimePeriod in class AbstractVirtualCost

Parameters:

timePeriod - to apply

getGeneralisedCost

public double getGeneralisedCost(Mode mode,
                                 ConnectoidSegment connectoidSegment)

Returns the generalised cost of travel along an edge segment for a specified mode

Parameters:

mode - the specified mode of travel

connectoidSegment - the specified edge segment (which can be physical or virtual)

Returns:

the cost of travel along the specified segment

populateWithCost

public void populateWithCost(VirtualNetwork virtualNetwork,
                             Mode mode,
                             double[] costToFill)
                      throws PlanItException

Invoker expects (mode specific ) costs in passed in array to be filled, where each entry signifies a link segment by its id

Parameters:

virtualNetwork - the cost pertains to

mode - the mode these costs pertain to

costToFill - array of link segment costs identified by the link segment's internal id

Throws:

PlanItException - thrown if error

clone

public FixedConnectoidTravelTimeCost clone()

Create a shallow copy of this entity

Specified by:

clone in interface IdAble

Specified by:

clone in class PlanitComponent<AbstractVirtualCost>

Returns:

shallow copy of entity

reset

public void reset()

Chosen cost is considered configuration not internal state, so upon resetting the chosen cost remains in tact

Specified by:

reset in class PlanitComponent<AbstractVirtualCost>

getTravelTimeCost

public double getTravelTimeCost(Mode mode,
                                ConnectoidSegment connectoidSegment)

Returns the generalised cost of travel along an edge segment for a specified mode

Parameters:

mode - the specified mode of travel

connectoidSegment - the specified edge segment (which can be physical or virtual)

Returns:

the cost of travel along the specified segment

getDTravelTimeDFlow

public double getDTravelTimeDFlow(boolean uncongested,
                                  Mode mode,
                                  ConnectoidSegment connectoidSegment)

fixed cost so derivative is always zero

Parameters:

uncongested - flag idicating if the provided flow is uncongested or congested flow, relevant when flow can represent multiple traffic states

mode - to use

connectoidSegment - to use

Returns:

the first derivative of travel time for a unit flow rate change in PCU per Hour