View Javadoc
1   package org.opentrafficsim.swing.script;
2   
3   import java.awt.Dimension;
4   import java.rmi.RemoteException;
5   import java.text.SimpleDateFormat;
6   import java.util.Date;
7   import java.util.LinkedHashMap;
8   import java.util.List;
9   import java.util.Map;
10  
11  import org.djunits.value.vdouble.scalar.Duration;
12  import org.djunits.value.vdouble.scalar.Time;
13  import org.djutils.cli.Checkable;
14  import org.djutils.cli.CliException;
15  import org.djutils.cli.CliUtil;
16  import org.djutils.event.EventInterface;
17  import org.djutils.event.EventListenerInterface;
18  import org.djutils.exceptions.Throw;
19  import org.djutils.exceptions.Try;
20  import org.djutils.reflection.ClassUtil;
21  import org.opentrafficsim.core.animation.gtu.colorer.GTUColorer;
22  import org.opentrafficsim.core.dsol.OTSAnimator;
23  import org.opentrafficsim.core.dsol.OTSModelInterface;
24  import org.opentrafficsim.core.dsol.OTSSimulator;
25  import org.opentrafficsim.core.dsol.OTSSimulatorInterface;
26  import org.opentrafficsim.core.network.OTSNetwork;
27  import org.opentrafficsim.draw.core.OTSDrawingException;
28  import org.opentrafficsim.draw.factory.DefaultAnimationFactory;
29  import org.opentrafficsim.road.network.OTSRoadNetwork;
30  import org.opentrafficsim.swing.gui.AnimationToggles;
31  import org.opentrafficsim.swing.gui.OTSAnimationPanel;
32  import org.opentrafficsim.swing.gui.OTSSimulationApplication;
33  import org.opentrafficsim.swing.gui.OTSSwingApplication;
34  
35  import nl.tudelft.simulation.dsol.SimRuntimeException;
36  import nl.tudelft.simulation.dsol.experiment.Replication;
37  import nl.tudelft.simulation.dsol.model.inputparameters.InputParameterMap;
38  import nl.tudelft.simulation.dsol.model.outputstatistics.OutputStatistic;
39  import nl.tudelft.simulation.jstats.streams.MersenneTwister;
40  import nl.tudelft.simulation.jstats.streams.StreamInterface;
41  import picocli.CommandLine.Command;
42  import picocli.CommandLine.Option;
43  
44  /**
45   * Template for simulation script. This class allows the user to run a single visualized simulation, or to batch-run the same
46   * model. Parameters can be given through the command-line using djutils-ext. Fields can be added to sub-classes using the
47   * {@code @Options} and similar annotations. Default values of the properties in this abstract class can be overwritten by the
48   * sub-class using {@code CliUtil.changeDefaultValue()}.
49   * <p>
50   * Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
51   * BSD-style license. See <a href="http://opentrafficsim.org/node/13">OpenTrafficSim License</a>.
52   * <p>
53   * @version $Revision$, $LastChangedDate$, by $Author$, initial version 9 apr. 2018 <br>
54   * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
55   * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
56   * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
57   */
58  @Command(description = "Test program for CLI", name = "Program", mixinStandardHelpOptions = true, showDefaultValues = true)
59  public abstract class AbstractSimulationScript implements EventListenerInterface, Checkable
60  {
61      /** */
62      private static final long serialVersionUID = 20200129L;
63  
64      /** Name. */
65      private final String name;
66  
67      /** Description. */
68      private final String description;
69  
70      /** The simulator. */
71      private OTSSimulatorInterface simulator;
72  
73      /** The network. */
74      private OTSRoadNetwork network;
75  
76      /** GTU colorer. */
77      private GTUColorer gtuColorer = OTSSwingApplication.DEFAULT_COLORER;
78  
79      /** Seed. */
80      @Option(names = "--seed", description = "Seed", defaultValue = "1")
81      private long seed;
82  
83      /** Start time. */
84      @Option(names = { "-s", "--startTime" }, description = "Start time", defaultValue = "0s")
85      private Time startTime;
86  
87      /** Warm-up time. */
88      @Option(names = { "-w", "--warmupTime" }, description = "Warm-up time", defaultValue = "0s")
89      private Duration warmupTime;
90  
91      /** Simulation time. */
92      @Option(names = { "-t", "--simulationTime" }, description = "Simulation time (including warm-up time)",
93              defaultValue = "3600s")
94      private Duration simulationTime;
95  
96      /** Autorun. */
97      @Option(names = { "-a", "--autorun" }, description = "Autorun", negatable = true, defaultValue = "false")
98      private boolean autorun;
99  
100     /**
101      * Constructor.
102      * @param name String; name
103      * @param description String; description
104      */
105     protected AbstractSimulationScript(final String name, final String description)
106     {
107         this.name = name;
108         this.description = description;
109         try
110         {
111             CliUtil.changeCommandName(this, this.name);
112             CliUtil.changeCommandDescription(this, this.description);
113             SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
114             CliUtil.changeCommandVersion(this,
115                     formatter.format(new Date(ClassUtil.classFileDescriptor(this.getClass()).getLastChangedDate())));
116         }
117         catch (IllegalStateException | IllegalArgumentException | CliException exception)
118         {
119             throw new RuntimeException("Exception while setting properties in @Command annotation.", exception);
120         }
121     }
122 
123     /**
124      * Returns the seed.
125      * @return long; seed
126      */
127     public long getSeed()
128     {
129         return this.seed;
130     }
131 
132     /**
133      * Returns the start time.
134      * @return Time; start time
135      */
136     public Time getStartTime()
137     {
138         return this.startTime;
139     }
140 
141     /**
142      * Returns the warm-up time.
143      * @return Duration; warm-up time
144      */
145     public Duration getWarmupTime()
146     {
147         return this.warmupTime;
148     }
149 
150     /**
151      * Returns the simulation time.
152      * @return Duration; simulation time
153      */
154     public Duration getSimulationTime()
155     {
156         return this.simulationTime;
157     }
158 
159     /**
160      * Returns whether to autorun.
161      * @return boolean; whether to autorun
162      */
163     public boolean isAutorun()
164     {
165         return this.autorun;
166     }
167 
168     /**
169      * Set GTU colorer.
170      * @param colorer GTUColorer; GTU colorer
171      */
172     public final void setGtuColorer(final GTUColorer colorer)
173     {
174         this.gtuColorer = colorer;
175     }
176 
177     /**
178      * Returns the GTU colorer.
179      * @return returns the GTU colorer
180      */
181     public final GTUColorer getGtuColorer()
182     {
183         return this.gtuColorer;
184     }
185 
186     /** {@inheritDoc} */
187     @Override
188     public void check() throws Exception
189     {
190         Throw.when(this.seed < 0, IllegalArgumentException.class, "Seed should be positive");
191         Throw.when(this.warmupTime.si < 0.0, IllegalArgumentException.class, "Warm-up time should be positive");
192         Throw.when(this.simulationTime.si < 0.0, IllegalArgumentException.class, "Simulation time should be positive");
193         Throw.when(this.simulationTime.si < this.warmupTime.si, IllegalArgumentException.class,
194                 "Simulation time should be longer than warmp-up time");
195     }
196 
197     /**
198      * Starts the simulation.
199      * @throws Exception on any exception
200      */
201     public final void start() throws Exception
202     {
203         if (isAutorun())
204         {
205             this.simulator = new OTSSimulator(this.name);
206             final ScriptModel scriptModel = new ScriptModel(this.simulator);
207             this.simulator.initialize(this.startTime, this.warmupTime, this.simulationTime, scriptModel);
208             this.simulator.addListener(this, Replication.END_REPLICATION_EVENT);
209             double tReport = 60.0;
210             Time t = this.simulator.getSimulatorTime();
211             while (t.si < this.simulationTime.si)
212             {
213                 this.simulator.step();
214                 t = this.simulator.getSimulatorTime();
215                 if (t.si >= tReport)
216                 {
217                     System.out.println("Simulation time is " + t);
218                     tReport += 60.0;
219                 }
220             }
221             // sim.stop(); // end of simulation event
222             onSimulationEnd(); // TODO this is temporary for as long as stop() gives an exception
223             System.exit(0);
224         }
225         else
226         {
227             this.simulator = new OTSAnimator(this.name);
228             final ScriptModel scriptModel = new ScriptModel(this.simulator);
229             this.simulator.initialize(this.startTime, this.warmupTime, this.simulationTime, scriptModel);
230             OTSAnimationPanel animationPanel =
231                     new OTSAnimationPanel(scriptModel.getNetwork().getExtent(), new Dimension(800, 600),
232                             (OTSAnimator) this.simulator, scriptModel, getGtuColorer(), scriptModel.getNetwork());
233             setAnimationToggles(animationPanel);
234             animateNetwork(scriptModel.getNetwork());
235             setupDemo(animationPanel, scriptModel.getNetwork());
236             OTSSimulationApplication<ScriptModel> app = new OTSSimulationApplication<ScriptModel>(scriptModel, animationPanel)
237             {
238                 /** */
239                 private static final long serialVersionUID = 20190130L;
240 
241                 /** {@inheritDoc} */
242                 @Override
243                 protected void animateNetwork() throws OTSDrawingException
244                 {
245                     // override with nothing to prevent double toggles
246                 }
247 
248                 /** {@inheritDoc} */
249                 @Override
250                 protected void setAnimationToggles()
251                 {
252                     // override with nothing to prevent double toggles
253                 }
254             };
255             addTabs(this.simulator, app);
256             app.setExitOnClose(true);
257         }
258     }
259 
260     /** {@inheritDoc} */
261     @Override
262     public void notify(final EventInterface event) throws RemoteException
263     {
264         if (event.getType().equals(Replication.END_REPLICATION_EVENT))
265         {
266             // try
267             // {
268             // getSimulator().scheduleEventNow(this, this, "onSimulationEnd", null);
269             // }
270             // catch (SimRuntimeException exception)
271             // {
272             // throw new RuntimeException(exception);
273             // }
274             onSimulationEnd();
275             // solve bug that event is fired twice
276             AbstractSimulationScript.this.simulator.removeListener(AbstractSimulationScript.this,
277                     Replication.END_REPLICATION_EVENT);
278         }
279     }
280 
281     /**
282      * Returns the simulator.
283      * @return OTSSimulatorInterface; simulator
284      */
285     public final OTSSimulatorInterface getSimulator()
286     {
287         return AbstractSimulationScript.this.simulator;
288     }
289 
290     /**
291      * Returns the network.
292      * @return OTSNetwork; network
293      */
294     public final OTSRoadNetwork getNetwork()
295     {
296         return AbstractSimulationScript.this.network;
297     }
298 
299     // Overridable methods
300 
301     /**
302      * Creates animations for nodes, links and lanes. This can be used if the network is not read from XML.
303      * @param net OTSNetwork; network
304      */
305     protected void animateNetwork(final OTSNetwork net)
306     {
307         try
308         {
309             DefaultAnimationFactory.animateNetwork(net, net.getSimulator(), getGtuColorer());
310         }
311         catch (OTSDrawingException exception)
312         {
313             throw new RuntimeException("Exception while creating network animation.", exception);
314         }
315     }
316 
317     /**
318      * Adds tabs to the animation. May be overridden.
319      * @param sim OTSSimulatorInterface; simulator
320      * @param animation OTSSimulationApplication&lt;?&gt;; animation to add tabs to
321      */
322     protected void addTabs(final OTSSimulatorInterface sim, final OTSSimulationApplication<?> animation)
323     {
324         //
325     }
326 
327     /**
328      * Method that is called when the simulation has ended. This can be used to store data.
329      */
330     protected void onSimulationEnd()
331     {
332         //
333     }
334 
335     /**
336      * Method that is called when the animation has been created, to add components for a demo.
337      * @param animationPanel OTSAnimationPanel; animation panel
338      * @param net OTSNetwork; network
339      */
340     protected void setupDemo(final OTSAnimationPanel animationPanel, final OTSRoadNetwork net)
341     {
342         //
343     }
344 
345     /**
346      * Sets the animation toggles. May be overridden.
347      * @param animation OTSAnimationPanel; animation to set the toggle on
348      */
349     protected void setAnimationToggles(final OTSAnimationPanel animation)
350     {
351         AnimationToggles.setIconAnimationTogglesStandard(animation);
352     }
353 
354     // Abstract methods
355 
356     /**
357      * Sets up the simulation based on provided properties. Properties can be obtained with {@code getProperty()}. Setting up a
358      * simulation should at least create a network and some demand. Additionally this may setup traffic control, sampling, etc.
359      * @param sim OTSSimulatorInterface; simulator
360      * @return OTSNetwork; network
361      * @throws Exception on any exception
362      */
363     protected abstract OTSRoadNetwork setupSimulation(OTSSimulatorInterface sim) throws Exception;
364 
365     // Nested classes
366 
367     /**
368      * Model.
369      * <p>
370      * Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
371      * <br>
372      * BSD-style license. See <a href="http://opentrafficsim.org/node/13">OpenTrafficSim License</a>.
373      * <p>
374      * @version $Revision$, $LastChangedDate$, by $Author$, initial version 9 apr. 2018 <br>
375      * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
376      * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
377      * @author <a href="http://www.transport.citg.tudelft.nl">Wouter Schakel</a>
378      */
379     private class ScriptModel implements OTSModelInterface
380     {
381         /** */
382         private static final long serialVersionUID = 20180409L;
383 
384         /**
385          * @param simulator OTSSimulatorInterface; the simulator
386          */
387         @SuppressWarnings("synthetic-access")
388         ScriptModel(final OTSSimulatorInterface simulator)
389         {
390             AbstractSimulationScript.this.simulator = simulator;
391         }
392 
393         /** {@inheritDoc} */
394         @SuppressWarnings("synthetic-access")
395         @Override
396         public void constructModel() throws SimRuntimeException
397         {
398             Map<String, StreamInterface> streams = new LinkedHashMap<>();
399             StreamInterface stream = new MersenneTwister(getSeed());
400             streams.put("generation", stream);
401             stream = new MersenneTwister(getSeed() + 1);
402             streams.put("default", stream);
403             AbstractSimulationScript.this.simulator.getReplication().setStreams(streams);
404             AbstractSimulationScript.this.network =
405                     Try.assign(() -> AbstractSimulationScript.this.setupSimulation(AbstractSimulationScript.this.simulator),
406                             RuntimeException.class, "Exception while setting up simulation.");
407             try
408             {
409                 AbstractSimulationScript.this.simulator.addListener(AbstractSimulationScript.this,
410                         Replication.END_REPLICATION_EVENT);
411             }
412             catch (RemoteException exception)
413             {
414                 throw new SimRuntimeException(exception);
415             }
416         }
417 
418         /** {@inheritDoc} */
419         @SuppressWarnings("synthetic-access")
420         @Override
421         public OTSSimulatorInterface getSimulator()
422         {
423             return AbstractSimulationScript.this.simulator;
424         }
425 
426         /** {@inheritDoc} */
427         @SuppressWarnings("synthetic-access")
428         @Override
429         public OTSRoadNetwork getNetwork()
430         {
431             return AbstractSimulationScript.this.network;
432         }
433 
434         /** {@inheritDoc} */
435         @Override
436         public InputParameterMap getInputParameterMap()
437         {
438             return null;
439         }
440 
441         /** {@inheritDoc} */
442         @Override
443         public List<OutputStatistic<?>> getOutputStatistics()
444         {
445             return null;
446         }
447 
448         /** {@inheritDoc} */
449         @SuppressWarnings("synthetic-access")
450         @Override
451         public String getShortName()
452         {
453             return AbstractSimulationScript.this.name;
454         }
455 
456         /** {@inheritDoc} */
457         @SuppressWarnings("synthetic-access")
458         @Override
459         public String getDescription()
460         {
461             return AbstractSimulationScript.this.description;
462         }
463     }
464 
465 }