The pedestrian following model. More...

#include <MSPModel_Striping.h>

Inheritance diagram for MSPModel_Striping:

Collaboration diagram for MSPModel_Striping:

Data Structures
class	by_xpos_sorter
	sorts the persons by position on the lane. If dir is forward, higher x positions come first. More...

class	lane_by_numid_sorter

class	MovePedestrians

struct	NextLaneInfo

struct	Obstacle
	information regarding surround Pedestrians (and potentially other things) More...

class	PState
	Container for pedestrian state and individual position update function. More...

class	walkingarea_path_sorter

struct	WalkingAreaPath

Public Member Functions
PedestrianState *	add (MSPerson person, MSPerson::MSPersonStage_Walking stage, SUMOTime now)
	register the given person as a pedestrian More...

bool	blockedAtDist (const MSLane lane, SUMOReal distToCrossing, std::vector< const MSPerson > *collectBlockers)
	whether a pedestrian is blocking the crossing of lane at offset distToCrossing More...

void	cleanupHelper ()
	remove state at simulation end More...

	MSPModel_Striping (const OptionsCont &oc, MSNet *net)
	Constructor (it should not be necessary to construct more than one instance) More...

void	remove (PedestrianState *state)
	remove the specified person from the pedestrian simulation More...

	~MSPModel_Striping ()

Static Public Member Functions
static bool	canTraverse (int dir, const ConstMSEdgeVector &route)
	return whether the route may traversed with the given starting direction More...

static void	cleanup ()
	remove state at simulation end More...

static MSPModel *	getModel ()

Static Public Attributes
static const int	BACKWARD

static const int	FORWARD

static const SUMOReal	SAFETY_GAP

static const SUMOReal	SIDEWALK_OFFSET
	the offset for computing person positions when walking on edges without a sidewalk More...

static const int	UNDEFINED_DIRECTION


static SUMOReal	stripeWidth
	model parameters More...

static SUMOReal	dawdling

static SUMOTime	jamTime

static const SUMOReal	LOOKAHEAD_SAMEDIR

static const SUMOReal	LOOKAHEAD_ONCOMING

static const SUMOReal	LATERAL_PENALTY

static const SUMOReal	OBSTRUCTED_PENALTY

static const SUMOReal	INAPPROPRIATE_PENALTY

static const SUMOReal	ONCOMING_CONFLICT_PENALTY

static const SUMOReal	OBSTRUCTION_THRESHOLD

static const SUMOReal	SQUEEZE

static const SUMOReal	BLOCKER_LOOKAHEAD

static const SUMOReal	RESERVE_FOR_ONCOMING_FACTOR

static const SUMOReal	RESERVE_FOR_ONCOMING_FACTOR_JUNCTIONS

static const SUMOReal	MAX_WAIT_TOLERANCE

static const SUMOReal	LATERAL_SPEED_FACTOR

static const SUMOReal	MIN_STARTUP_DIST

Protected Types
typedef std::map< const MSLane *, Pedestrians, lane_by_numid_sorter >	ActiveLanes

typedef std::map< const MSLane *, Obstacles, lane_by_numid_sorter >	NextLanesObstacles

typedef std::vector< Obstacle >	Obstacles

typedef std::vector< PState * >	Pedestrians

typedef std::map< std::pair< const MSLane , const MSLane >, WalkingAreaPath >	WalkingAreaPaths

Protected Member Functions
void	arriveAndAdvance (Pedestrians &pedestrians, SUMOTime currentTime, std::set< MSPerson * > &changedLane, int dir)
	handle arrivals and lane advancement More...

const ActiveLanes &	getActiveLanes ()

void	moveInDirection (SUMOTime currentTime, std::set< MSPerson * > &changedLane, int dir)
	move all pedestrians forward and advance to the next lane if applicable More...

void	moveInDirectionOnLane (Pedestrians &pedestrians, const MSLane lane, SUMOTime currentTime, std::set< MSPerson > &changedLane, int dir)
	move pedestrians forward on one lane More...

Static Protected Attributes
static const SUMOReal	DIST_BEHIND

static const SUMOReal	DIST_FAR_AWAY

static const SUMOReal	DIST_OVERLAP

Private Member Functions
const Obstacles &	getNextLaneObstacles (NextLanesObstacles &nextLanesObs, const MSLane lane, const MSLane nextLane, int stripes, SUMOReal nextLength, int nextDir, SUMOReal currentLength, int currentDir)

Pedestrians &	getPedestrians (const MSLane *lane)
	retrieves the pedestian vector for the given lane (may be empty) More...

Static Private Member Functions
static void	addCloserObstacle (Obstacles &obs, SUMOReal x, int stripe, int numStripes, const std::string &id, SUMOReal width, int dir)

static int	connectedDirection (const MSLane from, const MSLane to)
	returns the direction in which these lanes are connectioned or 0 if they are not More...

static void	DEBUG_PRINT (const Obstacles &obs)

static Obstacles	getNeighboringObstacles (const Pedestrians &pedestrians, int egoIndex, int stripes)

static NextLaneInfo	getNextLane (const PState &ped, const MSLane currentLane, const MSLane prevLane)
	computes the successor lane for the given pedestrian and sets the link as well as the direction to use on the succesor lane More...

static const MSLane *	getNextWalkingArea (const MSLane currentLane, const int dir, MSLink &link)
	return the next walkingArea in the given direction More...

static int	getStripeOffset (int origStripes, int destStripes, bool addRemainder)

static void	initWalkingAreaPaths (const MSNet *net)

static int	numStripes (const MSLane *lane)
	return the maximum number of pedestrians walking side by side More...

static void	transformToCurrentLanePositions (Obstacles &o, int currentDir, int nextDir, SUMOReal currentLength, SUMOReal nextLength)

Private Attributes
ActiveLanes	myActiveLanes
	store of all lanes which have pedestrians on them More...

MovePedestrians *	myCommand
	the MovePedestrians command that is registered More...

int	myNumActivePedestrians
	the total number of active pedestrians More...

Static Private Attributes
static WalkingAreaPaths	myWalkingAreaPaths
	store for walkinArea elements More...

static Pedestrians	noPedestrians
	empty pedestrian vector More...

Friends
class	GUIPerson

Detailed Description

The pedestrian following model.

Definition at line 58 of file MSPModel_Striping.h.

Member Typedef Documentation

typedef std::map<const MSLane*, Pedestrians, lane_by_numid_sorter> MSPModel_Striping::ActiveLanes

protected

Definition at line 152 of file MSPModel_Striping.h.

typedef std::map<const MSLane*, Obstacles, lane_by_numid_sorter> MSPModel_Striping::NextLanesObstacles

protected

Definition at line 154 of file MSPModel_Striping.h.

typedef std::vector<Obstacle> MSPModel_Striping::Obstacles

protected

Definition at line 153 of file MSPModel_Striping.h.

typedef std::vector<PState*> MSPModel_Striping::Pedestrians

protected

Definition at line 150 of file MSPModel_Striping.h.

typedef std::map<std::pair<const MSLane*, const MSLane*>, WalkingAreaPath> MSPModel_Striping::WalkingAreaPaths

protected

Definition at line 155 of file MSPModel_Striping.h.

Constructor & Destructor Documentation

MSPModel_Striping::MSPModel_Striping	(	const OptionsCont &	oc,
		MSNet *	net
	)

Constructor (it should not be necessary to construct more than one instance)

Definition at line 106 of file MSPModel_Striping.cpp.

References MSEventControl::ADAPT_AFTER_EXECUTION, MSEventControl::addEvent(), dawdling, DELTA_T, MSNet::getBeginOfTimestepEvents(), MSNet::getCurrentTimeStep(), OptionsCont::getFloat(), OptionsCont::getString(), initWalkingAreaPaths(), jamTime, myCommand, string2time(), stripeWidth, and SUMOTime_MAX.

MSPModel_Striping::~MSPModel_Striping ( )

Definition at line 122 of file MSPModel_Striping.cpp.

Member Function Documentation

PedestrianState * MSPModel_Striping::add	(	MSPerson *	person,
		MSPerson::MSPersonStage_Walking *	stage,
		SUMOTime	now
	)

virtual

register the given person as a pedestrian

Implements MSPModel.

Definition at line 127 of file MSPModel_Striping.cpp.

References MSTransportable::getCurrentStageType(), MSTransportable::getEdge(), MSTransportable::MOVING_WITHOUT_VEHICLE, myActiveLanes, and myNumActivePedestrians.

void MSPModel_Striping::addCloserObstacle	(	Obstacles &	obs,
		SUMOReal	x,
		int	stripe,
		int	numStripes,
		const std::string &	id,
		SUMOReal	width,
		int	dir
	)

staticprivate

Definition at line 616 of file MSPModel_Striping.cpp.

References MSPModel::BACKWARD, and MSPModel::FORWARD.

Referenced by getActiveLanes(), and getNextLaneObstacles().

void MSPModel_Striping::arriveAndAdvance	(	Pedestrians &	pedestrians,
		SUMOTime	currentTime,
		std::set< MSPerson * > &	changedLane,
		int	dir
	)

protected

handle arrivals and lane advancement

Definition at line 700 of file MSPModel_Striping.cpp.

References MSPModel_Striping::PState::distToLaneEnd(), MSPModel_Striping::PState::moveToNextLane(), myActiveLanes, MSPModel_Striping::PState::myDir, MSPModel_Striping::PState::myLane, myNumActivePedestrians, and MSPModel_Striping::PState::myPerson.

Referenced by moveInDirection().

bool MSPModel_Striping::blockedAtDist	(	const MSLane *	lane,
		SUMOReal	distToCrossing,
		std::vector< const MSPerson * > *	collectBlockers
	)

virtual

whether a pedestrian is blocking the crossing of lane at offset distToCrossing

Implements MSPModel.

Definition at line 152 of file MSPModel_Striping.cpp.

References BLOCKER_LOOKAHEAD, MSPModel::FORWARD, MSPModel_Striping::PState::getLength(), getPedestrians(), MSPModel_Striping::PState::myDir, MSPModel_Striping::PState::myPerson, MSPModel_Striping::PState::myRelX, MSPModel::SAFETY_GAP, and SUMOReal.

bool MSPModel::canTraverse	(	int	dir,
		const ConstMSEdgeVector &	route
	)

staticinherited

return whether the route may traversed with the given starting direction

Definition at line 91 of file MSPModel.cpp.

References MSPModel::BACKWARD, MSPModel::FORWARD, MSEdge::getFromJunction(), and MSEdge::getToJunction().

Referenced by MSPModel_Striping::PState::PState().

void MSPModel::cleanup ( )

staticinherited

remove state at simulation end

Definition at line 81 of file MSPModel.cpp.

References MSPModel::cleanupHelper(), and MSPModel::myModel.

Referenced by MSNet::clearAll().

void MSPModel_Striping::cleanupHelper ( )

virtual

remove state at simulation end

Reimplemented from MSPModel.

Definition at line 192 of file MSPModel_Striping.cpp.

References myActiveLanes, myNumActivePedestrians, and myWalkingAreaPaths.

int MSPModel_Striping::connectedDirection	(	const MSLane *	from,
		const MSLane *	to
	)

staticprivate

returns the direction in which these lanes are connectioned or 0 if they are not

Definition at line 210 of file MSPModel_Striping.cpp.

References MSPModel::BACKWARD, MSPModel::FORWARD, MSLinkContHelper::getConnectingLink(), and MSPModel::UNDEFINED_DIRECTION.

Referenced by getActiveLanes(), and getNextLane().

void MSPModel_Striping::DEBUG_PRINT ( const Obstacles & obs )

staticprivate

const ActiveLanes& MSPModel_Striping::getActiveLanes ( )

inlineprotected

Definition at line 367 of file MSPModel_Striping.h.

References addCloserObstacle(), connectedDirection(), DEBUG_PRINT(), getNeighboringObstacles(), getNextLane(), getNextLaneObstacles(), getNextWalkingArea(), getPedestrians(), getStripeOffset(), initWalkingAreaPaths(), myActiveLanes, numStripes(), SUMOReal, and transformToCurrentLanePositions().

MSPModel * MSPModel::getModel ( )

staticinherited

Definition at line 63 of file MSPModel.cpp.

References MSNet::getInstance(), OptionsCont::getOptions(), OptionsCont::getString(), and MSPModel::myModel.

Referenced by MSPerson::MSPersonStage_Walking::abort(), MSLink::getInternalLengthsAfter(), and MSPerson::MSPersonStage_Walking::proceed().

MSPModel_Striping::Obstacles MSPModel_Striping::getNeighboringObstacles	(	const Pedestrians &	pedestrians,
		int	egoIndex,
		int	stripes
	)

staticprivate

Definition at line 454 of file MSPModel_Striping.cpp.

References DEBUG_PRINT(), DEBUGCOND, DIST_BEHIND, DIST_OVERLAP, MSPModel_Striping::PState::distanceTo(), MSTransportable::getID(), MSPModel_Striping::PState::myDir, MSPModel_Striping::PState::myPerson, MSPModel_Striping::PState::myWaitingToEnter, MSPModel_Striping::PState::otherStripe(), SIMTIME, and MSPModel_Striping::PState::stripe().

Referenced by getActiveLanes(), and moveInDirectionOnLane().

MSPModel_Striping::NextLaneInfo MSPModel_Striping::getNextLane	(	const PState &	ped,
		const MSLane *	currentLane,
		const MSLane *	prevLane
	)

staticprivate

computes the successor lane for the given pedestrian and sets the link as well as the direction to use on the succesor lane

Parameters

[in]	currentLane	The lane the pedestrian is currently on
[in]	ped	The pedestrian for which to compute the next lane

Definition at line 288 of file MSPModel_Striping.cpp.

References MSPModel::BACKWARD, PedestrianRouter< E, L, N, V, INTERNALROUTER >::compute(), connectedDirection(), DEBUGCOND, MSPModel::FORWARD, MSPerson::MSPersonStage_Walking::getArrivalPos(), MSLinkContHelper::getConnectingLink(), MSLane::getEdge(), MSEdge::getFromJunction(), Named::getID(), MSTransportable::getID(), MSNet::getInstance(), MSEdge::getLength(), MSLane::getLinkCont(), MSLane::getLogicalPredecessorLane(), MSPerson::MSPersonStage_Walking::getMaxSpeed(), MSPerson::MSPersonStage_Walking::getNextRouteEdge(), getNextWalkingArea(), MSNet::getPedestrianRouter(), MSPerson::MSPersonStage_Walking::getRoute(), MSEdge::getToJunction(), MSLink::getViaLaneOrLane(), MSEdge::isCrossing(), MSEdge::isInternal(), MSEdge::isWalkingArea(), MSPModel_Striping::PState::myDir, MSPModel_Striping::PState::myPerson, MSPModel_Striping::PState::myStage, POSITION_EPS, SIMTIME, SUMOReal, time2string(), toString(), MSPModel::UNDEFINED_DIRECTION, and WRITE_WARNING.

Referenced by getActiveLanes(), moveInDirectionOnLane(), MSPModel_Striping::PState::moveToNextLane(), and MSPModel_Striping::PState::PState().

const MSPModel_Striping::Obstacles & MSPModel_Striping::getNextLaneObstacles	(	NextLanesObstacles &	nextLanesObs,
		const MSLane *	lane,
		const MSLane *	nextLane,
		int	stripes,
		SUMOReal	nextLength,
		int	nextDir,
		SUMOReal	currentLength,
		int	currentDir
	)

private

Definition at line 504 of file MSPModel_Striping.cpp.

Referenced by getActiveLanes(), and moveInDirectionOnLane().

const MSLane * MSPModel_Striping::getNextWalkingArea	(	const MSLane *	currentLane,
		const int	dir,
		MSLink *&	link
	)

staticprivate

return the next walkingArea in the given direction

Definition at line 431 of file MSPModel_Striping.cpp.

References MSPModel::FORWARD, MSLane::getIncomingLanes(), MSLink::getLane(), and MSLane::getLinkCont().

Referenced by getActiveLanes(), and getNextLane().

MSPModel_Striping::Pedestrians & MSPModel_Striping::getPedestrians ( const MSLane * lane )

private

retrieves the pedestian vector for the given lane (may be empty)

Definition at line 180 of file MSPModel_Striping.cpp.

References myActiveLanes, and noPedestrians.

Referenced by blockedAtDist(), getActiveLanes(), and getNextLaneObstacles().

int MSPModel_Striping::getStripeOffset	(	int	origStripes,
		int	destStripes,
		bool	addRemainder
	)

staticprivate

Definition at line 494 of file MSPModel_Striping.cpp.

Referenced by getActiveLanes(), getNextLaneObstacles(), and MSPModel_Striping::PState::moveToNextLane().

void MSPModel_Striping::initWalkingAreaPaths ( const MSNet * net )

staticprivate

void MSPModel_Striping::moveInDirection	(	SUMOTime	currentTime,
		std::set< MSPerson * > &	changedLane,
		int	dir
	)

protected

move all pedestrians forward and advance to the next lane if applicable

Definition at line 625 of file MSPModel_Striping.cpp.

void MSPModel_Striping::moveInDirectionOnLane	(	Pedestrians &	pedestrians,
		const MSLane *	lane,
		SUMOTime	currentTime,
		std::set< MSPerson * > &	changedLane,
		int	dir
	)