org.opentrafficsim.simulationengine

Class AbstractWrappableAnimation

java.lang.Object

org.opentrafficsim.simulationengine.AbstractWrappableAnimation

All Implemented Interfaces:

WrappableAnimation

public abstract class AbstractWrappableAnimation
extends Object
implements WrappableAnimation

Copyright (c) 2013-2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-12-29 03:56:14 +0100 (Tue, 29 Dec 2015) $, @version $Revision: 1668 $, by $Author: averbraeck $, initial version Jun 18, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	exitOnClose Use EXIT_ON_CLOSE when true, DISPOSE_ON_CLOSE when false on closing of the window.
protected OTSAnimationPanel	panel the tabbed panel so other tabs can be added by the classes that extend this class.
protected ArrayList<AbstractProperty<?>>	properties The properties exhibited by this simulation.
protected ArrayList<AbstractProperty<?>>	savedUserModifiedProperties The properties after (possible) editing by the user.

Constructor Summary

Constructors

Constructor and Description
AbstractWrappableAnimation()

Method Summary

Modifier and Type	Method and Description
SimpleAnimator	buildAnimator(org.djunits.value.vdouble.scalar.Time.Abs startTime, org.djunits.value.vdouble.scalar.Time.Rel warmupPeriod, org.djunits.value.vdouble.scalar.Time.Rel runLength, ArrayList<AbstractProperty<?>> userModifiedProperties, Rectangle rect, boolean eoc) Build the animation.
ArrayList<AbstractProperty<?>>	getProperties() Retrieve a list of visible properties of the simulation.
ArrayList<AbstractProperty<?>>	getUserModifiedProperties() Retrieve a list of properties as the user has modified them.
protected abstract Rectangle2D.Double	makeAnimationRectangle()
protected abstract JPanel	makeCharts()
protected abstract OTSModelInterface	makeModel(GTUColorer colorer)
SimpleSimulatorInterface	rebuildSimulator(Rectangle rect) Restart (rebuild) the simulation.
void	stopTimersThreads() Stop the timers and threads that are connected when disposing of this wrappable simulation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opentrafficsim.simulationengine.WrappableAnimation

description, shortName

Field Detail

properties

protected ArrayList<AbstractProperty<?>> properties

The properties exhibited by this simulation.

savedUserModifiedProperties

protected ArrayList<AbstractProperty<?>> savedUserModifiedProperties

The properties after (possible) editing by the user.

exitOnClose

protected boolean exitOnClose

Use EXIT_ON_CLOSE when true, DISPOSE_ON_CLOSE when false on closing of the window.

panel

protected OTSAnimationPanel panel

the tabbed panel so other tabs can be added by the classes that extend this class.

Constructor Detail

AbstractWrappableAnimation

public AbstractWrappableAnimation()

Method Detail

buildAnimator

public final SimpleAnimator buildAnimator(org.djunits.value.vdouble.scalar.Time.Abs startTime,
                                          org.djunits.value.vdouble.scalar.Time.Rel warmupPeriod,
                                          org.djunits.value.vdouble.scalar.Time.Rel runLength,
                                          ArrayList<AbstractProperty<?>> userModifiedProperties,
                                          Rectangle rect,
                                          boolean eoc)
                                   throws nl.tudelft.simulation.dsol.SimRuntimeException,
                                          NamingException,
                                          OTSSimulationException

Build the animation.

Specified by:

buildAnimator in interface WrappableAnimation

Parameters:

startTime - Time.Abs; the start time of the simulation

warmupPeriod - Time.Rel; the warm up period of the simulation (use new Time.Rel(0, SECOND) if you don't know what this is)

runLength - Time.Rel; the duration of the simulation

userModifiedProperties - ArrayList<AbstractProperty<?>>; the (possibly user-modified) properties. This list must contain all the properties returned by getProperties(); any additional properties may be ignored

rect - the x, y, width and height for the window to rebuild. Use null for maximized screen.

eoc - Use EXIT_ON_CLOSE when true, DISPOSE_ON_CLOSE when false on closing of the window.

Returns:

SimpleSimulation; the new simulation

Throws:

nl.tudelft.simulation.dsol.SimRuntimeException - on ???

NamingException - when context for the animation cannot be created

OTSSimulationException - when the construction of the simulation, the control panel, the animation, or the charts fails

makeCharts

protected abstract JPanel makeCharts()
                              throws OTSSimulationException

Returns:

the JPanel with the charts; the result will be put in the statistics tab. May return null; this causes no statistics tab to be created.

Throws:

OTSSimulationException - in case the chart, axes or legend cannot be generated

makeModel

protected abstract OTSModelInterface makeModel(GTUColorer colorer)
                                        throws OTSSimulationException

Parameters:

colorer - the GTU colorer to use.

Returns:

the demo model. Don't forget to keep a local copy.

Throws:

OTSSimulationException - in case the construction of the model fails

makeAnimationRectangle

protected abstract Rectangle2D.Double makeAnimationRectangle()

Returns:

the initial rectangle for the animation.

getProperties

public final ArrayList<AbstractProperty<?>> getProperties()

Retrieve a list of visible properties of the simulation.
The caller can modify the returned result. If the internal format is also an ArrayList it is highly recommended to make a protective copy and return that.

Specified by:

getProperties in interface WrappableAnimation

Returns:

ArrayList<AbstractProperty<?>>; the list of visible properties

rebuildSimulator

public final SimpleSimulatorInterface rebuildSimulator(Rectangle rect)
                                                throws nl.tudelft.simulation.dsol.SimRuntimeException,
                                                       NetworkException,
                                                       NamingException,
                                                       OTSSimulationException

Restart (rebuild) the simulation.

Specified by:

rebuildSimulator in interface WrappableAnimation

Parameters:

rect - the x, y, width and height for the window to rebuild. Use null for maximized screen.

Returns:

SimpleSimulation; the new simulation

Throws:

nl.tudelft.simulation.dsol.SimRuntimeException - on ???

NetworkException - on Network inconsistency

NamingException - when context for the animation cannot be created

OTSSimulationException - when the (re)construction of the simulation model fails

getUserModifiedProperties

public final ArrayList<AbstractProperty<?>> getUserModifiedProperties()

Retrieve a list of properties as the user has modified them.

Specified by:

getUserModifiedProperties in interface WrappableAnimation

Returns:

ArrayList<AbstractProperty<?>>; the list of visible properties

stopTimersThreads

public void stopTimersThreads()

Stop the timers and threads that are connected when disposing of this wrappable simulation.

Specified by:

stopTimersThreads in interface WrappableAnimation