ptolemy.actor.lib.gui
Class TimedScope
java.lang.Object
ptolemy.kernel.util.NamedObj
ptolemy.kernel.InstantiableNamedObj
ptolemy.kernel.Entity
ptolemy.kernel.ComponentEntity
ptolemy.actor.AtomicActor
ptolemy.actor.TypedAtomicActor
ptolemy.actor.lib.gui.PlotterBase
ptolemy.actor.lib.gui.Plotter
ptolemy.actor.lib.gui.TimedPlotter
ptolemy.actor.lib.gui.TimedScope
- All Implemented Interfaces:
- java.io.Serializable, java.lang.Cloneable, Actor, Executable, FiringsRecordable, Placeable, Initializable, TimedActor, TypedActor, Changeable, Configurable, Debuggable, DebugListener, Derivable, Instantiable, ModelErrorHandler, MoMLExportable, Moveable, Nameable
public class TimedScope
- extends TimedPlotter
A signal plotter that plots in an oscilloscope style, meaning that the
horizontal axis is wrapped and that there is finite persistence. This
plotter contains an instance of the Plot class from the Ptolemy plot
package as a public member. Data at the input, which can consist of
any number of channels, are plotted on this instance. Each channel is
plotted as a separate data set. The input is of type DoubleToken.
The horizontal axis represents time. The width parameter is
a double that gives the width of the plot. The horizontal axis will be
labeled from 0.0 to width. It defaults to 10.0.
If the persistence parameter is positive, then it specifies
the amount of time into the past that points are shown. It also
defaults to 10.0, so any point older than 10.0 time units is erased and
forgotten.
- Since:
- Ptolemy II 1.0
- Version:
- $Id: TimedScope.java 57040 2010-01-27 20:52:32Z cxh $
- Author:
- Edward A. Lee
- See Also:
- Serialized Form
- Accepted Rating:
- Proposed Rating:
Fields inherited from class ptolemy.actor.lib.gui.PlotterBase |
_base, _container, _frame, _plotSize, _source, _tableau, _text, _windowProperties, automaticRescale, fillOnWrapup, legend, plot |
Fields inherited from class ptolemy.kernel.util.NamedObj |
_changeListeners, _changeLock, _changeRequests, _debugging, _debugListeners, _elementName, _isPersistent, _verbose, _workspace, ATTRIBUTES, CLASSNAME, COMPLETE, CONTENTS, DEEP, FULLNAME, LINKS |
Constructor Summary |
TimedScope(CompositeEntity container,
java.lang.String name)
Construct an actor with the given container and name. |
Method Summary |
void |
attributeChanged(Attribute attribute)
Notify this that an attribute has changed. |
void |
initialize()
Initialize this actor. |
boolean |
postfire()
Call the base class postfire() method, then yield this
thread so that the event thread gets a chance. |
Methods inherited from class ptolemy.actor.lib.gui.PlotterBase |
_exportMoMLContents, _implementDeferredConfigurations, _newPlot, _propagateValue, configure, getConfigureSource, getConfigureText, place, preinitialize, setContainer, setDisplayName, setName, wrapup |
Methods inherited from class ptolemy.actor.AtomicActor |
_actorFiring, _actorFiring, addActorFiringListener, addInitializable, connectionsChanged, createReceivers, declareDelayDependency, fire, getCausalityInterface, getDirector, getExecutiveDirector, getManager, inputPortList, isFireFunctional, isStrict, iterate, newReceiver, outputPortList, prefire, pruneDependencies, recordFiring, removeActorFiringListener, removeDependency, removeInitializable, stop, stopFire, terminate |
Methods inherited from class ptolemy.kernel.ComponentEntity |
_adjustDeferrals, _checkContainer, _getContainedObject, _propagateExistence, getContainer, instantiate, isAtomic, isOpaque, moveDown, moveToFirst, moveToIndex, moveToLast, moveUp, propagateExistence |
Methods inherited from class ptolemy.kernel.Entity |
_description, _removePort, _validateSettables, connectedPortList, connectedPorts, containedObjectsIterator, getAttribute, getPort, getPorts, linkedRelationList, linkedRelations, portList, removeAllPorts, setClassDefinition, uniqueName |
Methods inherited from class ptolemy.kernel.util.NamedObj |
_addAttribute, _adjustOverride, _attachText, _cloneFixAttributeFields, _debug, _debug, _debug, _debug, _debug, _getIndentPrefix, _isMoMLSuppressed, _markContentsDerived, _recordDecoratedAttributes, _removeAttribute, _splitName, _stripNumericSuffix, addChangeListener, addDebugListener, attributeList, attributeList, deepContains, depthInHierarchy, description, description, event, executeChangeRequests, exportMoML, exportMoML, exportMoML, exportMoML, exportMoMLPlain, getAttribute, getAttributes, getChangeListeners, getClassName, getDecoratorAttribute, getDecoratorAttributes, getDerivedLevel, getDerivedList, getDisplayName, getFullName, getModelErrorHandler, getName, getName, getSource, handleModelError, isDeferringChangeRequests, isOverridden, isPersistent, lazyContainedObjectsIterator, message, propagateValue, propagateValues, removeChangeListener, removeDebugListener, requestChange, setClassName, setDeferringChangeRequests, setDerivedLevel, setModelErrorHandler, setPersistent, setSource, sortContainedObjects, toplevel, toString, validateSettables, workspace |
Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
width
public Parameter width
- The width of the X axis (a double).
persistence
public Parameter persistence
- The amount of data displayed at any one time (a double).
This has units of the X axis.
TimedScope
public TimedScope(CompositeEntity container,
java.lang.String name)
throws IllegalActionException,
NameDuplicationException
- Construct an actor with the given container and name.
- Parameters:
container
- The container.name
- The name of this actor.
- Throws:
IllegalActionException
- If the actor cannot be contained
by the proposed container.
NameDuplicationException
- If the container already has an
actor with this name.
attributeChanged
public void attributeChanged(Attribute attribute)
throws IllegalActionException
- Notify this that an attribute has changed. If either parameter
is changed, then this actor updates the configuration of the
visible plot.
- Overrides:
attributeChanged
in class Plotter
- Parameters:
attribute
- The attribute that changed.
- Throws:
IllegalActionException
- If the expression of the
attribute cannot be parsed or cannot be evaluated.
initialize
public void initialize()
throws IllegalActionException
- Initialize this actor. This method configures the plotter
using the current parameter values.
- Specified by:
initialize
in interface Initializable
- Overrides:
initialize
in class TimedPlotter
- Throws:
IllegalActionException
- If the parent class throws it.
postfire
public boolean postfire()
throws IllegalActionException
- Call the base class postfire() method, then yield this
thread so that the event thread gets a chance. This is necessary,
because otherwise the swing thread may be starved and accumulate a
large number of points waiting to be plotted.
- Specified by:
postfire
in interface Executable
- Overrides:
postfire
in class TimedPlotter
- Returns:
- True if it is OK to continue.
- Throws:
IllegalActionException
- If there is no director,
or if the base class throws it.