org.opentrafficsim.simulationengine

Class AbstractWrappableSimulation

java.lang.Object

org.opentrafficsim.simulationengine.AbstractWrappableSimulation

All Implemented Interfaces:

WrappableSimulation

public abstract class AbstractWrappableSimulation
extends Object
implements WrappableSimulation

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 ArrayList<AbstractProperty<?>>	properties The properties exhibited by this simulation.

Constructor Summary

Constructors

Constructor and Description
AbstractWrappableSimulation()

Method Summary

Modifier and Type	Method and Description
SimpleSimulator	buildSimulator(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) Build the simulation.
ArrayList<AbstractProperty<?>>	getProperties() Retrieve a list of visible properties of the simulation.
protected abstract OTSModelInterface	makeModel()

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.WrappableSimulation

description, shortName

Field Detail

properties

protected ArrayList<AbstractProperty<?>> properties

The properties exhibited by this simulation.

Constructor Detail

AbstractWrappableSimulation

public AbstractWrappableSimulation()

Method Detail

buildSimulator

public final SimpleSimulator buildSimulator(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)
                                     throws nl.tudelft.simulation.dsol.SimRuntimeException,
                                            NamingException,
                                            OTSSimulationException

Build the simulation.

Specified by:

buildSimulator in interface WrappableSimulation

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

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

makeModel

protected abstract OTSModelInterface makeModel()
                                        throws OTSSimulationException

Returns:

the model.

Throws:

OTSSimulationException - when the construction of the model fails

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 WrappableSimulation

Returns:

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