View Javadoc
1   package org.opentrafficsim.demo.sdm;
2   
3   import java.util.LinkedHashSet;
4   import java.util.Set;
5   
6   import org.djunits.value.vdouble.scalar.Duration;
7   import org.opentrafficsim.base.parameters.ParameterException;
8   import org.opentrafficsim.base.parameters.ParameterSet;
9   import org.opentrafficsim.base.parameters.ParameterTypes;
10  import org.opentrafficsim.base.parameters.Parameters;
11  import org.opentrafficsim.core.gtu.GTUException;
12  import org.opentrafficsim.core.gtu.GTUType;
13  import org.opentrafficsim.core.gtu.perception.DirectEgoPerception;
14  import org.opentrafficsim.core.network.Node;
15  import org.opentrafficsim.core.parameters.ParameterFactoryByType;
16  import org.opentrafficsim.road.gtu.generator.od.StrategicalPlannerFactorySupplierOD;
17  import org.opentrafficsim.road.gtu.lane.LaneBasedGTU;
18  import org.opentrafficsim.road.gtu.lane.perception.CategoricalLanePerception;
19  import org.opentrafficsim.road.gtu.lane.perception.LanePerception;
20  import org.opentrafficsim.road.gtu.lane.perception.PerceptionFactory;
21  import org.opentrafficsim.road.gtu.lane.perception.categories.AnticipationTrafficPerception;
22  import org.opentrafficsim.road.gtu.lane.perception.categories.DirectInfrastructurePerception;
23  import org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.Anticipation;
24  import org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.DirectNeighborsPerception;
25  import org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.Estimation;
26  import org.opentrafficsim.road.gtu.lane.perception.categories.neighbors.HeadwayGtuType;
27  import org.opentrafficsim.road.gtu.lane.perception.mental.AdaptationHeadway;
28  import org.opentrafficsim.road.gtu.lane.perception.mental.AdaptationSituationalAwareness;
29  import org.opentrafficsim.road.gtu.lane.perception.mental.Fuller;
30  import org.opentrafficsim.road.gtu.lane.perception.mental.Fuller.BehavioralAdaptation;
31  import org.opentrafficsim.road.gtu.lane.perception.mental.Task;
32  import org.opentrafficsim.road.gtu.lane.perception.mental.TaskCarFollowing;
33  import org.opentrafficsim.road.gtu.lane.tactical.following.IDMPlusFactory;
34  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.AccelerationIncentive;
35  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveKeep;
36  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveRoute;
37  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveSpeedWithCourtesy;
38  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.IncentiveStayRight;
39  import org.opentrafficsim.road.gtu.lane.tactical.lmrs.LMRSFactory;
40  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.Cooperation;
41  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.GapAcceptance;
42  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.MandatoryIncentive;
43  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.Synchronization;
44  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.Tailgating;
45  import org.opentrafficsim.road.gtu.lane.tactical.util.lmrs.VoluntaryIncentive;
46  import org.opentrafficsim.road.gtu.strategical.LaneBasedStrategicalPlannerFactory;
47  import org.opentrafficsim.road.gtu.strategical.od.Category;
48  import org.opentrafficsim.road.gtu.strategical.route.LaneBasedStrategicalRoutePlannerFactory;
49  import org.opentrafficsim.road.network.OTSRoadNetwork;
50  
51  import nl.tudelft.simulation.jstats.streams.StreamInterface;
52  
53  /**
54   * Regular strategical planner with LMRS using Fuller perception.
55   * <p>
56   * Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
57   * BSD-style license. See <a href="http://opentrafficsim.org/node/13">OpenTrafficSim License</a>.
58   * <p>
59   * @version $Revision$, $LastChangedDate$, by $Author$, initial version 6 nov. 2018 <br>
60   * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
61   * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
62   * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
63   */
64  
65  public class SdmStrategicalPlannerFactory implements StrategicalPlannerFactorySupplierOD
66  {
67  
68      /** Car factory. */
69      private final LaneBasedStrategicalPlannerFactory<?> carFactory;
70  
71      /** Truck factory. */
72      private final LaneBasedStrategicalPlannerFactory<?> truckFactory;
73  
74      /**
75       * Constructor.
76       * @param network the network
77       * @param stream StreamInterface; random number stream
78       * @param simulation SdmSimulation; simulation to obtain properties from
79       */
80      @SuppressWarnings("synthetic-access")
81      SdmStrategicalPlannerFactory(final OTSRoadNetwork network, final StreamInterface stream, final SdmSimulation simulation)
82      {
83          ParameterFactoryByType paramFactory = new ParameterFactoryByType();
84  
85          paramFactory.addParameter(Fuller.TC, simulation.getTc());
86          paramFactory.addParameter(Fuller.TS_CRIT, simulation.getTsCrit());
87          paramFactory.addParameter(Fuller.TS_MAX, simulation.getTsMax());
88  
89          paramFactory.addParameter(AdaptationSituationalAwareness.SA_MIN, simulation.getSaMin());
90          paramFactory.addParameter(AdaptationSituationalAwareness.SA_MAX, simulation.getSaMax());
91          paramFactory.addParameter(AdaptationSituationalAwareness.TR_MAX, simulation.getTrMax());
92  
93          paramFactory.addParameter(AdaptationHeadway.BETA_T, simulation.getBetaT());
94  
95          paramFactory.addParameter(ParameterTypes.DT, simulation.getDt());
96          paramFactory.addParameter(ParameterTypes.TMIN, simulation.getIdmOptions().getTMin());
97          paramFactory.addParameter(ParameterTypes.TMAX, simulation.getIdmOptions().getTMax());
98          paramFactory.addParameter(ParameterTypes.T, simulation.getIdmOptions().getTMax());
99          paramFactory.addParameter(network.getGtuType(GTUType.DEFAULTS.CAR), ParameterTypes.A,
100                 simulation.getIdmOptions().getACar());
101         paramFactory.addParameter(network.getGtuType(GTUType.DEFAULTS.TRUCK), ParameterTypes.A,
102                 simulation.getIdmOptions().getATruck());
103         paramFactory.addParameter(ParameterTypes.B, simulation.getIdmOptions().getB());
104 
105         Set<MandatoryIncentive> mandatoryIncentives = new LinkedHashSet<>();
106         mandatoryIncentives.add(new IncentiveRoute());
107         Set<VoluntaryIncentive> voluntaryIncentives = new LinkedHashSet<>();
108         voluntaryIncentives.add(new IncentiveSpeedWithCourtesy());
109         voluntaryIncentives.add(new IncentiveKeep());
110         Set<AccelerationIncentive> accelerationIncentives = new LinkedHashSet<>();
111         // accelerationIncentives.add(new AccelerationNoRightOvertake());
112         PerceptionFactory perceptionFactory = new SdmPerception();
113         this.carFactory = new LaneBasedStrategicalRoutePlannerFactory(new LMRSFactory(new IDMPlusFactory(stream),
114                 perceptionFactory, Synchronization.ALIGN_GAP, Cooperation.PASSIVE, GapAcceptance.INFORMED, Tailgating.NONE,
115                 mandatoryIncentives, voluntaryIncentives, accelerationIncentives), paramFactory);
116 
117         voluntaryIncentives = new LinkedHashSet<>(voluntaryIncentives);
118         voluntaryIncentives.add(new IncentiveStayRight());
119         this.truckFactory = new LaneBasedStrategicalRoutePlannerFactory(new LMRSFactory(new IDMPlusFactory(stream),
120                 perceptionFactory, Synchronization.ALIGN_GAP, Cooperation.PASSIVE, GapAcceptance.INFORMED, Tailgating.NONE,
121                 mandatoryIncentives, voluntaryIncentives, accelerationIncentives), paramFactory);
122     }
123 
124     /** {@inheritDoc} */
125     @Override
126     public LaneBasedStrategicalPlannerFactory<?> getFactory(final Node origin, final Node destination, final Category category,
127             final StreamInterface randomStream) throws GTUException
128     {
129         if (category.get(GTUType.class).isOfType(GTUType.DEFAULTS.TRUCK))
130         {
131             return this.truckFactory;
132         }
133         return this.carFactory;
134     }
135 
136     /**
137      * Factory for perception with Fuller.
138      * <p>
139      * Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
140      * <br>
141      * BSD-style license. See <a href="http://opentrafficsim.org/node/13">OpenTrafficSim License</a>.
142      * <p>
143      * @version $Revision$, $LastChangedDate$, by $Author$, initial version 6 nov. 2018 <br>
144      * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
145      * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
146      * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
147      */
148     private class SdmPerception implements PerceptionFactory
149     {
150         /** {@inheritDoc} */
151         @Override
152         public Parameters getParameters() throws ParameterException
153         {
154             ParameterSet params = new ParameterSet();
155             params.setDefaultParameters(Fuller.class);
156             params.setDefaultParameters(AdaptationSituationalAwareness.class);
157             params.setDefaultParameter(AdaptationHeadway.BETA_T);
158             params.setDefaultParameter(ParameterTypes.PERCEPTION);
159             params.setDefaultParameter(ParameterTypes.LOOKBACK);
160             params.setDefaultParameter(ParameterTypes.LOOKAHEAD);
161             params.setParameter(ParameterTypes.TR, Duration.ZERO);
162             return params;
163         }
164 
165         /** {@inheritDoc} */
166         @Override
167         public LanePerception generatePerception(final LaneBasedGTU gtu)
168         {
169             Set<Task> tasks = new LinkedHashSet<>();
170             tasks.add(new TaskCarFollowing());
171             Set<BehavioralAdaptation> adaptations = new LinkedHashSet<>();
172             adaptations.add(new AdaptationSituationalAwareness());
173             adaptations.add(new AdaptationHeadway());
174             CategoricalLanePerception perception = new CategoricalLanePerception(gtu, new Fuller(tasks, adaptations));
175             perception.addPerceptionCategory(new DirectEgoPerception<>(perception));
176             perception.addPerceptionCategory(new AnticipationTrafficPerception(perception));
177             perception.addPerceptionCategory(new DirectInfrastructurePerception(perception));
178             perception.addPerceptionCategory(new DirectNeighborsPerception(perception,
179                     new HeadwayGtuType.PerceivedHeadwayGtuType(Estimation.UNDERESTIMATION, Anticipation.CONSTANT_SPEED)));
180             return perception;
181         }
182     }
183 
184 }