Classes
class	MyWithinDayMobsimListener

class	RunWithinDayReplanningFromPlansExample

Functions
static List< MobsimAgent >	getAgentsToReplan (Netsim mobsim)

boolean	doReplanning (MobsimAgent agent, Netsim mobsim)

Detailed Description

Definition: Withinday replanning means that agents can replan while they are on their way, technically while the mobsim is running.

At this point, there are at least two approaches:

One approach, put forward by Christoph Dobler, which takes existing agents with plans and modifies future parts of their plans.
Another approach, put forward by Kai Nagel and Michael Zilske, which re-programms the agent from the inside out.

In the end, each approach will be able to emulate the other one, so it may come down to a matter of taste.

This package contains the first variant. The other one is described in another tutorial package.

This package contains (as of dec'10):

tutorial.programming.withinDayReplanningFromPlans.RunWithinDayReplanningFromPlansExample (very short), which contains the main method.
tutorial.programming.withinDayReplanningFromPlans.MyMobsimFactory (short), which defines that mobsim setup.
tutorial.programming.withinDayReplanningFromPlans.MyWithinDayMobsimListener, which contains a concrete implementation for withinday replanning of vehicle drivers.

Please address yourself to Christoph Dobler for support.

Function Documentation

static List<MobsimAgent> tutorial.programming.withinDayReplanningFromPlans.getAgentsToReplan ( Netsim mobsim )

staticprivate

Definition at line 92 of file MyWithinDayMobsimListener.java.

References org.matsim.core.mobsim.qsim.interfaces.NetsimNetwork.getNetsimLinks(), org.matsim.core.mobsim.qsim.interfaces.Netsim.getNetsimNetwork(), org.matsim.core.mobsim.qsim.interfaces.Netsim.getSimTimer(), and org.matsim.core.mobsim.framework.MobsimTimer.getTimeOfDay().

                                                                        {
 
         List<MobsimAgent> set = new ArrayList<MobsimAgent>();
 
         // don't do anything for most time steps:
         if (Math.floor(mobsim.getSimTimer().getTimeOfDay()) !=  22000.0) {
             return set;
         }
         
         // find agents that are en-route (more interesting case)
         for (NetsimLink link:mobsim.getNetsimNetwork().getNetsimLinks().values()){
             for (MobsimVehicle vehicle : link.getAllNonParkedVehicles()) {
                 MobsimDriverAgent agent=vehicle.getDriver();
                 System.out.println(agent.getId());
                 if ( true ) { // some condition ...
                     System.out.println("found agent");
                     set.add(agent);
                 }
             }
         }
 
         return set;
 
     }

Here is the call graph for this function:

boolean tutorial.programming.withinDayReplanningFromPlans.doReplanning	(	MobsimAgent	agent,
		Netsim	mobsim
	)

private

Definition at line 117 of file MyWithinDayMobsimListener.java.

                                                                     {
         double now = mobsim.getSimTimer().getTimeOfDay() ;
         
         Plan plan = WithinDayAgentUtils.getModifiablePlan( agent ) ; 
 
         if (plan == null) {
             log.info( " we don't have a modifiable plan; returning ... ") ;
             return false;
         }
         if ( !(WithinDayAgentUtils.getCurrentPlanElement(agent) instanceof Leg) ) {
             log.info( "agent not on leg; returning ... ") ;
             return false ;
         }
         if (!((Leg) WithinDayAgentUtils.getCurrentPlanElement(agent)).getMode().equals(TransportMode.car)) {
             log.info( "not a car leg; can only replan car legs; returning ... ") ;
             return false;
         }
         
         List<PlanElement> planElements = plan.getPlanElements() ;
         final Integer planElementsIndex = WithinDayAgentUtils.getCurrentPlanElementIndex(agent);
         
         if ( !(planElements.get(planElementsIndex+1) instanceof Activity || !(planElements.get(planElementsIndex+2) instanceof Leg)) ) {
             log.error( "this version of withinday replanning cannot deal with plans where legs and acts do not alternate; returning ...") ;
             return false ;
         }
 
         // now the real work begins. This, as an example, changes the activity (i.e. the destination of the current leg) and then
         // re-splices the plan
         
         Id<Link> newDestinationLinkId = Id.create("22", Link.class) ;
         Activity newAct = mobsim.getScenario().getPopulation().getFactory().createActivityFromLinkId("w", newDestinationLinkId ) ;
         newAct.setMaximumDuration(3600);
         
         planElements.set( planElementsIndex+1, newAct );
         
         // =============================================================================================================
         // =============================================================================================================
         // EditRoutes at this point only works for car routes
 
         TravelTime travelTime = travelTimes.get( TransportMode.car ) ;
         
         TravelDisutility travelDisutility = travelDisutilityFactories.get( TransportMode.car ).createTravelDisutility(travelTime) ;
 
         Network network = scenario.getNetwork() ;
 
         LeastCostPathCalculator pathCalculator = pathCalculatorFactory.createPathCalculator(network, travelDisutility, travelTime ) ;
 
         EditRoutes editRoutes = new EditRoutes( scenario.getNetwork(), pathCalculator, scenario.getPopulation().getFactory() ) ;
         
         // new Route for current Leg.
         final Leg leg = (Leg) plan.getPlanElements().get(planElementsIndex);
         final Person person = ((HasPerson) agent).getPerson();
         final Integer linkIdx = WithinDayAgentUtils.getCurrentRouteLinkIdIndex(agent);
 
         editRoutes.relocateCurrentLegRoute(leg, person, linkIdx, newDestinationLinkId, now) ;
         
         // the route _from_ the modified activity also needs to be replanned:
         Leg futureLeg = (Leg) plan.getPlanElements().get(planElementsIndex + 2);
         EditRoutes.relocateFutureLegRoute(futureLeg, newDestinationLinkId, futureLeg.getRoute().getEndLinkId(), person, 
                 scenario.getNetwork(), tripRouter);
         
         // =============================================================================================================
         // =============================================================================================================
         
         // finally reset the cached Values of the PersonAgent - they may have changed!
         WithinDayAgentUtils.resetCaches(agent);
         
         return true;
     }

Here is the call graph for this function:

Classes

Functions

Detailed Description

Function Documentation