ptolemy.domains.csp.lib
Class CSPMultiSink

java.lang.Object
  ptolemy.kernel.util.NamedObj
      ptolemy.kernel.InstantiableNamedObj
          ptolemy.kernel.Entity
              ptolemy.kernel.ComponentEntity
                  ptolemy.actor.AtomicActor
                      ptolemy.actor.TypedAtomicActor
                          ptolemy.domains.csp.kernel.CSPActor
                              ptolemy.domains.csp.lib.CSPMultiSink

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Actor, Executable, FiringsRecordable, Initializable, TypedActor, BranchActor, Changeable, Debuggable, DebugListener, Derivable, Instantiable, ModelErrorHandler, MoMLExportable, Moveable, Nameable

public class CSPMultiSink
extends CSPActor

A CSPMultiSink actor accepts a token from any channel connected to its input. It uses a conditional do (CDO) construct to always be ready to accept a new token. The channels it can accept from are set at the start of each firing.

Since:

Ptolemy II 0.2

Version:

$Id: CSPMultiSink.java 57040 2010-01-27 20:52:32Z cxh $

Author:

Neil Smyth

See Also:

CSPActor, Serialized Form

Accepted Rating:

Red (nsmyth)

Proposed Rating:

Red (nsmyth)

Nested Class Summary

Nested classes/interfaces inherited from class ptolemy.kernel.Entity

Entity.ContainedObjectsIterator

Field Summary

private int[]	_branchCount Array storing the number of times each branch rendezvoused.
TypedIOPort	input This actor's input port.

Fields inherited from class ptolemy.actor.AtomicActor

_actorFiringListeners, _initializables, _notifyingActorFiring, _stopRequested

Fields inherited from class ptolemy.kernel.util.NamedObj

_changeListeners, _changeLock, _changeRequests, _debugging, _debugListeners, _elementName, _isPersistent, _verbose, _workspace, ATTRIBUTES, CLASSNAME, COMPLETE, CONTENTS, DEEP, FULLNAME, LINKS

Fields inherited from interface ptolemy.actor.Executable

COMPLETED, NOT_READY, STOP_ITERATING

Constructor Summary

CSPMultiSink()
Construct a CSPMultiSink in the default workspace with an empty string as its name.

CSPMultiSink(TypedCompositeActor container, java.lang.String name)
Construct a CSPMultiSink with the specified container and name.

Method Summary

void	fire() Execute this actor by consuming tokens through the input port.
boolean	postfire() Return false indicating that iteration of this actor should not continue.
void	wrapup() Discontinue the execution of this actor.

Methods inherited from class ptolemy.domains.csp.kernel.CSPActor

_cancelDelay, _continue, _waitForDeadlock, chooseBranch, clone, delay, getBranchController, initialize, terminate

Methods inherited from class ptolemy.actor.TypedAtomicActor

_addPort, _fireAt, _fireAt, attributeTypeChanged, clone, newPort, typeConstraintList, typeConstraints

Methods inherited from class ptolemy.actor.AtomicActor

_actorFiring, _actorFiring, addActorFiringListener, addInitializable, connectionsChanged, createReceivers, declareDelayDependency, getCausalityInterface, getDirector, getExecutiveDirector, getManager, inputPortList, isFireFunctional, isStrict, iterate, newReceiver, outputPortList, prefire, preinitialize, pruneDependencies, recordFiring, removeActorFiringListener, removeDependency, removeInitializable, setContainer, stop, stopFire

Methods inherited from class ptolemy.kernel.ComponentEntity

_adjustDeferrals, _checkContainer, _getContainedObject, _propagateExistence, getContainer, instantiate, isAtomic, isOpaque, moveDown, moveToFirst, moveToIndex, moveToLast, moveUp, propagateExistence, setName

Methods inherited from class ptolemy.kernel.Entity

_description, _exportMoMLContents, _removePort, _validateSettables, connectedPortList, connectedPorts, containedObjectsIterator, getAttribute, getPort, getPorts, linkedRelationList, linkedRelations, portList, removeAllPorts, setClassDefinition, uniqueName

Methods inherited from class ptolemy.kernel.InstantiableNamedObj

_setParent, exportMoML, getChildren, getElementName, getParent, getPrototypeList, isClassDefinition, isWithinClassDefinition

Methods inherited from class ptolemy.kernel.util.NamedObj

_addAttribute, _adjustOverride, _attachText, _cloneFixAttributeFields, _debug, _debug, _debug, _debug, _debug, _getIndentPrefix, _isMoMLSuppressed, _markContentsDerived, _propagateValue, _recordDecoratedAttributes, _removeAttribute, _splitName, _stripNumericSuffix, addChangeListener, addDebugListener, attributeChanged, 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, setDisplayName, setModelErrorHandler, setPersistent, setSource, sortContainedObjects, toplevel, toString, validateSettables, workspace

Methods inherited from class java.lang.Object

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

Methods inherited from interface ptolemy.actor.Actor

createReceivers, getCausalityInterface, getDirector, getExecutiveDirector, getManager, inputPortList, newReceiver, outputPortList

Methods inherited from interface ptolemy.actor.Executable

isFireFunctional, isStrict, iterate, prefire, stop, stopFire

Methods inherited from interface ptolemy.actor.Initializable

addInitializable, preinitialize, removeInitializable

Methods inherited from interface ptolemy.kernel.util.Nameable

description, getContainer, getDisplayName, getFullName, getName, getName, setName

Methods inherited from interface ptolemy.kernel.util.Derivable

getDerivedLevel, getDerivedList, propagateValue

Field Detail

input

public TypedIOPort input

This actor's input port.

_branchCount

private int[] _branchCount

Array storing the number of times each branch rendezvoused.

Constructor Detail

CSPMultiSink

public CSPMultiSink()

Construct a CSPMultiSink in the default workspace with an empty string as its name. The actor is created with a single input port named "input".

CSPMultiSink

public CSPMultiSink(TypedCompositeActor container,
                    java.lang.String name)
             throws IllegalActionException,
                    NameDuplicationException

Construct a CSPMultiSink with the specified container and name. The actor is created with a single input port named "input". The name of the actor must be unique within the container or a NameDuplicationException is thrown. The container argument must not be null, or a NullPointerException will be thrown.

Parameters:

container - The container of this actor.

name - The name of this actor.

Throws:

IllegalActionException - If the port cannot be contained by this actor.

NameDuplicationException - If the port name coincides with a port already in this actor.

Method Detail

fire

public void fire()
          throws IllegalActionException

Execute this actor by consuming tokens through the input port. Use a conditional do (CDO) construct for token consumption.

Specified by:

fire in interface Executable

Overrides:

fire in class AtomicActor

Throws:

IllegalActionException - If thrown by the super class.

postfire

public boolean postfire()

Return false indicating that iteration of this actor should not continue.

Specified by:

postfire in interface Executable

Overrides:

postfire in class CSPActor

Returns:

false Indicating that iteration of this actor should should not continue.

wrapup

public void wrapup()

Discontinue the execution of this actor.

Specified by:

wrapup in interface Initializable

Overrides:

wrapup in class AtomicActor