MultiCommodityFlow Class Reference

Multi-commodity flow calculating base class. More...

#include <mcf.h>

Inheritance diagram for MultiCommodityFlow:

Protected Member Functions
	MultiCommodityFlow (LinkGraphJob &job)
	Constructor.
template<class Tannotation , class Tedge_iterator >
void	Dijkstra (NodeID from, PathVector &paths)
	A slightly modified Dijkstra algorithm.
uint	PushFlow (Node &node, NodeID to, Path *path, uint accuracy, uint max_saturation)
	Push flow along a path and update the unsatisfied_demand of the associated edge.
void	CleanupPaths (NodeID source, PathVector &paths)
	Clean up paths that lead nowhere and the root path.

Protected Attributes
LinkGraphJob &	job
	Job we're working with.
uint	max_saturation
	Maximum saturation for edges.

Detailed Description

Multi-commodity flow calculating base class.

Definition at line 13 of file mcf.h.

Constructor & Destructor Documentation

MultiCommodityFlow()

MultiCommodityFlow::MultiCommodityFlow ( LinkGraphJob &  job )

inlineprotected

Constructor.

Parameters

job	Link graph job being executed.

Definition at line 19 of file mcf.h.

Member Function Documentation

CleanupPaths()

void MultiCommodityFlow::CleanupPaths ( NodeID  source_id, PathVector &  paths  )

protected

Clean up paths that lead nowhere and the root path.

Parameters

source_id	ID of the root node.
paths	Paths to be cleaned up.

Definition at line 312 of file mcf.cpp.

References Path::Detach(), Path::GetFlow(), Path::GetNode(), Path::GetNumChildren(), and Path::GetParent().

Referenced by MCF1stPass::MCF1stPass(), and MCF2ndPass::MCF2ndPass().

Dijkstra()

template<class Tannotation , class Tedge_iterator >

void MultiCommodityFlow::Dijkstra ( NodeID  source_node, PathVector &  paths  )

protected

A slightly modified Dijkstra algorithm.

Grades the paths not necessarily by distance, but by the value Tannotation computes. It uses the max_saturation setting to artificially decrease capacities.

Template Parameters

Tannotation	Annotation to be used.
Tedge_iterator	Iterator to be used for getting outgoing edges.

Parameters

source_node	Node where the algorithm starts.
paths	Container for the paths to be calculated.

Definition at line 257 of file mcf.cpp.

References LinkGraph::BaseEdge::capacity, LinkGraphJob::Cargo(), CC_EXPRESS, CC_MAIL, CC_PASSENGERS, Ticks::DAY_TICKS, DistanceMaxPlusManhattan(), IsCargoInClass(), job, max_saturation, LinkGraphJob::Size(), and LinkGraph::BaseEdge::TravelTime().

PushFlow()

uint MultiCommodityFlow::PushFlow ( Node &  node, NodeID  to, Path *  path, uint  accuracy, uint  max_saturation  )

protected

Push flow along a path and update the unsatisfied_demand of the associated edge.

Parameters

node	Node where the path starts.
to	Node where the path ends.
path	End of the path the flow should be pushed on.
accuracy	Accuracy of the calculation.
max_saturation	If < UINT_MAX only push flow up to the given saturation, otherwise the path can be "overloaded".

Definition at line 344 of file mcf.cpp.

References Path::AddFlow(), Clamp(), and job.

Referenced by MCF1stPass::MCF1stPass(), and MCF2ndPass::MCF2ndPass().

Field Documentation

job

LinkGraphJob& MultiCommodityFlow::job

protected

Job we're working with.

Definition at line 30 of file mcf.h.

Referenced by Dijkstra(), MCF1stPass::EliminateCycle(), MCF1stPass::EliminateCycles(), MCF1stPass::EliminateCycles(), MCF1stPass::MCF1stPass(), MCF2ndPass::MCF2ndPass(), and PushFlow().

max_saturation

uint MultiCommodityFlow::max_saturation

protected

Maximum saturation for edges.

Definition at line 31 of file mcf.h.

Referenced by Dijkstra(), and MCF2ndPass::MCF2ndPass().

---

The documentation for this class was generated from the following files:

• src/linkgraph/mcf.h
• src/linkgraph/mcf.cpp