ptolemy.actor

Interface Executable

All Superinterfaces:

Initializable

All Known Subinterfaces:

Actor, BranchActor, DDI, GTCompositeActor, PeriodicDirector, RefinementActor, TMActor, TypedActor, WirelessChannel

All Known Implementing Classes:

Absent, AbsoluteValue, AbstractCalInterpreter, AbstractDDI, AbstractPlaceableActor, AccessorOne, Accumulator, Accumulator, ActorRecursion, ActuatorSetup, AdaptiveMedian, AddSubtract, AddSubtract, AddSubtractAll, AFDXESs, AFDXSwitch, AlgebraicLoopDirector, Alloc, AnythingToDouble, ApplyFilterOverArray, ApplyFunction, ApplyFunctionOverSequence, ArrayAccumulate, ArrayAppend, ArrayAverage, ArrayContains, ArrayElement, ArrayElementAsMatrix, ArrayExtract, ArrayLength, ArrayLevelCrossing, ArrayMaximum, ArrayMinimum, ArrayOfRecordsExporter, ArrayOfRecordsRecorder, ArrayPeakSearch, ArrayPeakSearch, ArrayPlotter, ArrayPlotterXY, ArrayRemoveElement, ArraySort, ArraySum, ArrayToElements, ArrayToMatrix, ArrayToSequence, ArrayUpdate, ArrowKeyProbe, ArrowKeySensor, Assert, AtomicActor, AtomicActorMatcher, AtomicCommunicationAspect, AtomicExecutionAspect, AtomicWirelessChannel, AudioCapture, AudioPlayer, AudioPlayer, AudioReadBuffer, AudioReader, AudioWriteBuffer, AudioWriter, Autocorrelation, Autocorrelation, Average, Average, AverageOverTime, BackDropQueue, Backtrack, BandlimitedNoise, BarGraph, Barrier, Barrier, BaseMultipleMethodsActor, BasicSwitch, Bernoulli, BinaryNonStrictLogicGate, BinarySwitch, BitsToInt, BooleanMultiplexor, BooleanSelect, BooleanSelect, BooleanSwitch, BooleanSwitch, BooleanToAnything, BootstrapSampleDelay, BoundedBufferNondeterministicDelay, BoundedBufferTimedDelay, BoundingBox, Box2D, Box3D, Break, Buffer, Buffer, Bus, BusAssembler, BusDisassembler, ButtonTime, CA2DConvolution, CADirector, CalInterpreter, CanBus, CanBusPriority, CartesianToComplex, CartesianToPolar, Case, Case, CaseDirector, CAViewer, ChangePtr, Chop, Chop, ChordFollower, ChordParser, CIActor, CIDirector, CipherActor, CircularSweep3D, ClassWrapper, ClipPlayer, Clock, CollisionDetector, ColorFinder, ColtBeta, ColtBinomial, ColtBinomialSelector, ColtBreitWigner, ColtChiSquare, ColtExponential, ColtExponentialPower, ColtGamma, ColtHyperGeometric, ColtLogarithmic, ColtNegativeBinomial, ColtNormal, ColtPoisson, ColtPoissonSlow, ColtRandomSource, ColtStudentT, ColtVonMises, ColtZeta, Combine, CommunicationAspectMonitor, CommunicationRequestPort, CommunicationResponsePort, Commutator, Commutator, Comparator, CompiledCompositeActor, ComplexAddSubtract, ComplexToCartesian, ComplexToPolar, CompositeActor, CompositeActorMatcher, CompositeCommunicationAspect, CompositeExecutionAspect, CompositeOptimizer, CompositeOptimizer.OptimizerComposite, CompositeOptimizer.OptimizerDirector, CompositeProcessDirector, ComputeHistogram, ComputeHistogram, Concat, Cone3D, ConfigurationSelect, ConfigurationSwitch, Configurer, Const, ConstPlaceable, ConstraintsCalculator, ContinuousDirector, ContinuousIntegrator, ContinuousMerge, ContinuousTimeDelay, ContinuousTransferFunction, ControlActor, Converter, ConvolutionalCoder, Counter, Counter, CountTrues, Course, CrossbarSwitch, CryptographyActor, CSP, CSPActor, CSPBuffer, CSPDirector, CSPMultiSink, CSPMultiSource, CSPSieve, CSPSink, CSPSource, CSVReader, CSVWriter, Current, CurrentDate, CurrentMicrostep, CurrentTime, Cylinder3D, DatabaseInsert, DatabaseManager, DatabaseQuery, DatabaseSelect, Dataflow, DataflowWithRates, DatagramReader, DatagramWriter, DateConstructor, DateElements, DateToEvent, DateToModelTime, DB, DB, DCT2x2dc, DCT4x4dc, DCT8x8, DDEActor, DDEDirector, DDESink, DDF, DDFBooleanSelect, DDFDirector, DDFOrderedMerge, DDFSelect, DDFSingleTokenCommutator, DEActor, DEDirector, Default, DelayChannel, DelayLine, DelayLine, DelayStart, Derivative, Derivative, DeScrambler, DEThreadActor, DETransformer, Dictionary, Differential, Differential, DifferentialSystem, Director, DirectoryListing, Discard, DiscreteClock, DiscreteClock, DiscreteRandomSource, Display, DisplayAll, DistributedDirector, DistributedLineWriter, DistributedSDFDirector, DistributedTypedCompositeActor, Distributor, Distributor, DoNothingDirector, DotProduct, DoubleFork, DoubleMatrixToJAI, DoubleReader, DoubleReader, DoubleToFix, DoubleToMatrix, DownSample, DropSensorHandler, DTDirector, DummyDisplay, DummySource, DummyTransformer, DynamicCoreAssignmentScheduler, EDFScheduler, ElementsToArray, Ellipse2D, EmbeddedCodeActor, EmbeddedCodeActor.EmbeddedActor, EnabledComposite, EncoderHandler, Equals, ErasureChannel, EventButton, EventFilter, EventSource, EventToDate, Excel, Exec, ExecuteActor, ExecuteCompositeActor, ExecutionRequestPort, ExecutionResponsePort, ExecutionTime, Exit, Expression, Expression, ExpressionReader, ExpressionToToken, ExpressionWriter, FactorOracle, FactorOracleGenerator, FactorOracleTop, FCFSScheduler, FeedBackDelay, FFT, FFT, FileReader, FileWriter, FIR, FixComparator, FixConst, FixCounter, FixedPointDirector, FixedPriorityScheduler, FixSequence, FixToDouble, FixToFix, FixToString, FixTransformer, FMIDirector, FMU, FMUImport, FMUModelExchange, FmvAutomaton, FrontDropQueue, FSMActor, FSMDirector, FSMMatcher, Gaussian, Gaussian, GetCausalityInterface, GetCurrentMicrostep, GetProperties, GiottoDirector, GPInputHandler, GPOutputSetup, GRActor, GRActor2D, GRActor3D, GradientAdaptiveLattice, GradientAdaptiveLattice, GraphicalLocator, GRDirector, GRShadedShape, GRShape2D, GRTransform, GRTransform2D, HadamardCode, HammingCoder, HammingDecoder, HDFDirector, HDFFSMDirector, HistogramPlotter, HMMExponentialClassifier, HMMExponentialEstimator, HMMGaussianClassifier, HMMGaussianEstimator, HMMGaussianEstimator, HMMMultinomialClassifier, HMMMultinomialEstimator, HSMMGaussianEstimator, HSMMGenerator, HSMMParameterEstimator, HTMLModelExporter, HTMLPageAssembler, HttpActor, HttpGet, HttpPost, HttpPost, HttpPut, HttpPut, HttpRequestHandler, HttpSink, HTVQEncode, HuffmanBasic, HuffmanCoder, HuffmanDecoder, HybridModalDirector, IDCT4x4dc, IDCT8x8, IFFT, IFFT, IfThen, IfThenElse, IIR, IIR, Image2D, ImageContrast, ImageDisplay, ImageDisplay, ImagePartition, ImageReader, ImageRotate, ImageSequence, ImageToJAI, ImageToJMF, ImageToString, ImageUnpartition, ImageWriter, Inhibit, InputDevice, InstantaneousDialogGenerator, IntArrayToString, IntegerCounter, Integrator, Integrator, InteractiveShell, InterfaceAutomaton, Interpolator, Interpolator, IntToBits, InUnitsOf, IsPresent, IterateOverArray, IterateOverArray.IterateComposite, JAIAffineTransform, JAIBandCombine, JAIBandSelect, JAIBMPWriter, JAIBorder, JAIBoxFilter, JAIConstant, JAIConvolve, JAICrop, JAIDataConvert, JAIDCT, JAIDFT, JAIEdgeDetection, JAIIDCT, JAIIDFT, JAIImageReader, JAIInvert, JAIJPEGWriter, JAILog, JAIMagnitude, JAIMedianFilter, JAIPeriodicShift, JAIPhase, JAIPNGWriter, JAIPNMWriter, JAIPolarToComplex, JAIRotate, JAIScale, JAITIFFWriter, JAIToDoubleMatrix, JAITranslate, JAITranspose, JAIWriter, JavaScript, JopReadPort, JopSerialRead, JopSerialWrite, JopWatchDog, JopWritePort, Joystick, JSONToToken, KeyInput3D, KeyInput3DProbe, KeyReader, KeyStoreActor, KeyWriter, LabVIEWSimulator, Lattice, LazyTypedCompositeActor, LEDMatrix, LempelZivCoder, LempelZivDecoder, LevelCrossingDetector, LevinsonDurbin, LifeCycleManager, LimitedFiringSource, LimitedRangeChannel, Limiter, Line2D, LinearDifferenceEquationSystem, LinearDifferenceEquationSystem, LinearStateSpace, LineCoder, LineReader, LineWriter, LinkVisualizer, LiveSoundActor, LMSAdaptive, Load, LoadStore, Locator, LogicalNot, LogicalNot, LogicFunction, LogicFunction, LogicGate, LongToDate, LongToDouble, LookupTable, LuminarySensorHandler, MapFileStorage, MapWorker, MathFunction, MatrixJoin, MatrixSplit, MatrixToArray, MatrixToDouble, MatrixToSequence, MatrixViewer, Maximum, MaxIndex, Memory, MemoryAccess, Merge, Merge, MicaCompositeActor, MicaLeds, MicrostepDelay, MidiKeyToNote, Minimum, MirrorComposite, MirrorComposite.MirrorCompositeContents, MobileFunction, MobileModel, ModalController, ModalDirector, ModalModel, ModalModelMatcher, ModalRefinement, ModelCombine, ModelDisplay, ModelExecutor, ModelGenerator, ModelReference, ModelView, ModifyDate, ModularCodeGenLazyTypedCompositeActor, ModularCodeGenTypedCompositeActor, ModularCompiledSDFTypedCompositeActor, MoMLGenerator, MonitorImage, MonitorValue, MostRecent, MotorSetup, MouseInput3D, MovableViewScreen3D, MovieReader, MovieViewScreen2D, MovieViewScreen3D, MovieWriter, MovingAverage, MovingMaximum, MultiCompositeActor, MultiInstanceComposite, Multiplexor, Multiplexor, Multiplexor, Multiplier, MultiplyDivide, MultirateFSMDirector, MutualInformationCalculator, NCComponentBase, NCCompositeActor, NodeRandomizer, Noise, Noise, NondeterministicMerge, NonInterruptibleTimer, NonStrictAndGate, NonStrictDelay, NonStrictDisplay, NonStrictFSMDirector, NonStrictLogicFunction, NonStrictLogicGate, NonStrictOrGate, NonStrictTest, NonStrictThreeBitAdder, NonStrictXorGate, NoteParser, NoteToMidiKey, ObservationClassifier, Occupants, Optimizer, OptimizingSDFDirector, Or, OracleModel, OrderedMerge, OrderedMerge, OrderedRecordAssembler, OscReceiver, OscSender, OutputDevice, PacketDropFaultGenerator, ParameterEstimator, ParameterEstimator, ParameterSet, ParticleFilter, ParticleFilterRange, Pattern, Pause, PeriodicSampler, PetriNetActor, PetriNetDirector, PetriNetDisplay, PetriNetRecorder, PhaseUnwrap, PhaseUnwrap, PID, Place, PlaySound, Plotter, PlotterBase, PNDirector, PoissonClock, PoissonClock, PolarToCartesian, PolarToComplex, PolyCylinder3D, PowerLossChannel, Pre, Previous, PrivateKeyReader, ProcessDirector, ProcessDirector, ProxyActor, ProxySink, ProxySource, PSDFDirector, PSNR, PtalonActor, PtalonMatcher, PtalonMatcher.NestedPtalonActor, PteraController, PteraDirector, PteraModalModel, PthalesAddHeaderActor, PthalesAtomicActor, PthalesCompositeActor, PthalesDirector, PthalesDynamicCompositeActor, PthalesGenericActor, PthalesRemoveHeaderActor, PthalesWrapperCompositeActor, PtidesDirector, PtidesPlatform, PtidesPlatform.PtidesPlatformContents, PtinyOSCompositeActor, PtinyOSDirector, PublicKeyReader, Publisher, PublisherNonStrictTest, PublisherTest, Pulse, Pulse, PythonScript, QSSIntegrator, QSSVectorIntegrator, Quantizer, Queue, Queue, RaisedCosine, Ramp, Ramp, RandomInteger, RandomSource, RandomSource, Reader, RealTimeComposite, RealTimePlotter, RecordAssembler, RecordDisassembler, Recorder, Recorder, RecordToQueryString, RecordUpdater, Rectangle2D, RectangularFigure2D, RecursiveLattice, RecursiveLattice, ReduceWorker, Refinement, Refinement, ReflectComposite, ReflectComposite.ReflectCompositeContents, Region, Register, Register, RegisterSR, Remainder, RemoveNilTokens, RendezvousDirector, Repeat, Replacement, ResettableTimer, ResourcePool, ResourcePool, RESTGetHandler, Rician, ROM, Room, Rotate2D, Rotate3D, Round, RunCompositeActor, RunningMaximum, RunningMinimum, SaltAndPepper, SampleDelay, Sampler, Scale, Scale2D, Scale3D, Scrambler, SCRModel, SDF, SDFConverter, SDFDirector, SDFTransformer, SecretKey, SecretKeyReader, Select, Select, SendMail, SensorHandler, Sequence, Sequence, SequencedIntegrator, SequenceDirector, SequencedModelDirector, SequencedSharedMemoryActor, SequencedVariable, SequencePlotter, Sequencer, Sequencer, SequenceScope, SequenceSource, SequenceToArray, SequenceToMatrix, SequentialClock, SequentialClock, SerialComm, Server, SetProperties, SetVariable, SharedBufferTransformer, SharedQueue, SignatureActor, SignatureSigner, SignatureVerifier, Simulator, SingleEvent, SingleTokenCommutator, SingleTokenDistributor, Sink, SketchedSource, Sleep, Slice, Slicer, SliderSource, SMVLegacyCodeActor, SongWrapper, SoundActor, SoundPlayer, Source, SpeakerOutputDevice, Sphere3D, SplitReader, SQLStatement, SRDirector, Starver, StateMatcher, StaticSchedulingDirector, Stop, Store, StreamLoader, StringCompare, StringConst, StringFunction, StringIndexOf, StringLength, StringMatches, StringReplace, StringSimpleReplace, StringSplit, StringSubstring, StringToBoolean, StringToDate, StringToDouble, StringToInt, StringToIntArray, StringToKeyValue, StringToUnsignedByteArray, StringToXML, StuckAtFaultGenerator, SubMatrix, Subscriber, SubscriptionAggregator, SumofAbsoluteDifferences, SuppressSimultaneousEvents, SurgeVisualizer, Switch, Switch, SymmetricDecryption, SymmetricEncryption, Synchronizer, SynchronousFixTransformer, SysMLADirector, SysMLConcurrentDirector, SysMLSequentialDirector, SystemCommand, Task, TaskDirector, TaskPtDirector, TCPPacketReceiver, TCPPacketTransmitter, TDLActor, TDLController, TDLModule, TDLModuleDirector, TDLRefinement, TDLTask, TerrainProperty, Test, TestActorPortDepth, TesterDirector, TestExceptionHandler, TextString3D, ThreadDirector, ThreadedComposite, ThrowException, ThrowModelError, TimeCompare, TimedDelay, TimeDelay, TimedPlotter, TimedPNDirector, TimedScope, TimedSource, TimeGap, Timer, TimeTriggeredEncoderHandler, TMCompositeFacade, TMDirector, TokenReader, TokenToExpression, TokenToJSON, TopLevelCurrentTime, Torus3D, Transform.EmbeddedConfigurer, TransformationRule, TransformationRule.TransformationDirector, Transformer, Transition, TransitionRefinement, Translate2D, Translate3D, TransmitPropertyTransformer, TrellisDecoder, Triangular, Triangulator, TrigFunction, TriggeredClock, TrueGate, TTESwitch, TypedAtomicActor, TypedCompositeActor, TypeOpaqueCompositeActor, TypeTest, UnaryMathFunction, Undefined, Uniform, UnionDisassembler, UnionMerge, UnitsConverter, UnsignedByteArrayToString, UpSample, URLDirectoryReader, URLReader, URLToImage, VariableClock, VariableDelay, VariableDelaySwitch, VariableFIR, VariableLattice, VariableRecursiveLattice, VariableSleep, VectorAssembler, VectorDisassembler, VertxBusHandler, Video, VideoCamera, VideoPlayer, ViewScreen2D, ViewScreen3D, VisualModelReference, VisualSequenceDirector, ViterbiDecoder, VQDecode, WaitingTime, WallClockTime, Waveform, WebSocketReader, WebSocketWriter, When, While, Wire, Wire, WiredToWireless, WirelessComposite, WirelessDirector, WirelessToWired, Writer, XMLInclusion, XMPPGateway, XMPPSink, XMPPSource, XSLTransformer, XYPlotter, XYScope, ZeroOrderHold

public interface Executable
extends Initializable

This interface defines the action methods, which determine how an object can be invoked. It should be implemented by actors and directors. In an execution of an application, the preinitialize() and initialize() methods should be invoked exactly once, followed by any number of iterations, followed by exactly one invocation of the wrapup() method. An iteration is defined to be any number of invocations of prefire() and fire(), where fire() is invoked only if prefire() returns true, followed by exactly one invocation of the postfire() method. The postfire() method returns false if no further iterations should occur. The initialize(), fire() and postfire() methods may produce output data. The preinitialize() method runs before type resolution has been done, and is permitted to make changes in the topology of the model.

Since:

Ptolemy II 0.2

Version:

$Id: Executable.java 65763 2013-03-07 01:54:37Z cxh $

Author:

Mudit Goel, Edward A. Lee, Lukito Muliadi, Steve Neuendorffer

Accepted Rating:

Green (davisj)

Proposed Rating:

Green (eal)

Field Summary

Fields

Modifier and Type	Field and Description
static int	COMPLETED An indicator that the iterate() method completed successfully.
static int	NOT_READY An indicator that the iterate() method did not complete because the actor was not ready (prefire() returned false).
static int	STOP_ITERATING An indicator that the actor does not wish to be fired again.

Method Summary

Modifier and Type	Method and Description
void	fire() Fire the actor.
boolean	isFireFunctional() Return true if this executable does not change state in either the prefire() or the fire() method.
boolean	isStrict() Return true if this executable is strict, meaning all inputs must be known before iteration.
int	iterate(int count) Invoke a specified number of iterations of the actor.
boolean	postfire() This method should be invoked once per iteration, after the last invocation of fire() in that iteration.
boolean	prefire() This method should be invoked prior to each invocation of fire().
void	stop() Request that execution of this Executable stop as soon as possible.
void	stopFire() Request that execution of the current iteration complete.
void	terminate() Terminate any currently executing model with extreme prejudice.

Methods inherited from interface ptolemy.actor.Initializable

addInitializable, initialize, preinitialize, removeInitializable, wrapup

Field Detail

COMPLETED

static final int COMPLETED

An indicator that the iterate() method completed successfully.

See Also:

Constant Field Values

NOT_READY

static final int NOT_READY

An indicator that the iterate() method did not complete because the actor was not ready (prefire() returned false).

See Also:

Constant Field Values

STOP_ITERATING

static final int STOP_ITERATING

An indicator that the actor does not wish to be fired again.

See Also:

Constant Field Values

Method Detail

fire

void fire()
   throws IllegalActionException

Fire the actor. This may be invoked several times between invocations of prefire() and postfire(). Output data may (and normally will) be produced. Typically, the fire() method performs the computation associated with an actor. This method is not required to have bounded execution. However, after endFire() is called, this method should return in bounded time.

Throws:

IllegalActionException - If firing is not permitted.

isFireFunctional

boolean isFireFunctional()

Return true if this executable does not change state in either the prefire() or the fire() method. A class that returns true is said to obey the actor abstract semantics. In particular, such an actor can be used in domains that have a fixed point semantics and may repeatedly fire the actor before committing to state changes.

Returns:

True if this executable only updates its states during an iteration in the postfire() method.

isStrict

boolean isStrict()
          throws IllegalActionException

Return true if this executable is strict, meaning all inputs must be known before iteration. Normally, classes that implement this interface are strict, so this method will return true. However, some classes can perform an iteration even if some inputs are not known (i.e., these classes tolerate a return value of false from the isKnown() method of Receiver).

Returns:

True if this executable is strict, meaning all inputs must be known before iteration.

Throws:

IllegalActionException - Thrown by subclass.

iterate

int iterate(int count)
     throws IllegalActionException

Invoke a specified number of iterations of the actor. An iteration here is equivalent to invoking prefire(), fire(), and postfire(), in that order. In an iteration, if prefire() returns true, then fire() will be called once, followed by postfire(). Otherwise, if prefire() returns false, fire() and postfire() are not invoked, and this method returns NOT_READY. If postfire() returns false, then no more iterations are invoked, and this method returns STOP_ITERATING. Otherwise, it returns COMPLETED.

An implementation of this method is not required to actually invoke prefire(), fire(), and postfire(). An implementation of this method must, however, perform the equivalent operations.

Note that this method for iterating an actor should be used only in domains where a single invocation of prefire() and fire() is sufficient in an iteration.

Parameters:

count - The number of iterations to perform.

Returns:

NOT_READY, STOP_ITERATING, or COMPLETED.

Throws:

IllegalActionException - If iterating is not permitted, or if prefire(), fire(), or postfire() throw it.

postfire

boolean postfire()
          throws IllegalActionException

This method should be invoked once per iteration, after the last invocation of fire() in that iteration. The postfire() method should not produce output data on output ports of the actor. It returns true if the execution can proceed into the next iteration, false if the actor does not wish to be fired again. This method typically wraps up an iteration, which may involve updating local state or updating displays.

Returns:

True if the execution can continue.

Throws:

IllegalActionException - If postfiring is not permitted.

prefire

boolean prefire()
         throws IllegalActionException

This method should be invoked prior to each invocation of fire(). It returns true if the fire() method can be invoked, given the current status of the inputs and parameters of the actor. Thus this method will typically check preconditions for a firing, if there are any. In an opaque, non-atomic entity, it may move data into an inner subsystem.

Returns:

True if the iteration can proceed.

Throws:

IllegalActionException - If prefiring is not permitted.

stop

void stop()

Request that execution of this Executable stop as soon as possible. An implementation of this method should pass on the request to any contained executable objects. An implementation should also return false from postfire() to indicate to the caller that no further execution of this Executable is appropriate. After this method is called, the executable object should not be fired again. The stopFire() method, by contrast, requests that the current iteration be completed, but not that the entire execution be stopped. I.e., the Executable may be fired again after stopFire() is called.

stopFire

void stopFire()

Request that execution of the current iteration complete. If an iteration is always a finite computation (the usual case), i.e. the fire() method always returns in finite time, then nothing needs to be done in this method, except possibly to pass on the request to any contained executable objects. This method is used to request that an unbounded computation suspend, returning control to the caller. Thus, if the fire() method does not normally return in finite time, then this method is used to request that it return. It should suspend execution in such a way that if the fire() method is called again, execution will resume at the point where it was suspended. However, it should not assume the fire() method will be called again. It is possible that the wrapup() method will be called next.

terminate

void terminate()

Terminate any currently executing model with extreme prejudice. This method is not intended to be used as a normal route of stopping execution. To normally stop execution, call the finish() method instead. This method should be called only when execution fails to terminate by normal means due to certain kinds of programming errors (infinite loops, threading errors, etc.).

After this method completes, all resources in use should be released and any sub-threads should be killed. However, a consistent state is not guaranteed. The topology should probably be recreated before attempting any further operations. This method should not be synchronized because it must happen as soon as possible, no matter what.