All Packages Class Hierarchy This Package Previous Next Index
java.lang.Object | +----jDisco.Linkage | +----jDisco.Link | +----jDisco.Reporter
In one or more subclasses of class Reporter the user may define actions for gathering information about the model's behaviour.
Each object of class Reporter may automatically have its user-defined actions executed with a specified frequency, namely either
Note that all state changes should be restricted to Process- and Continuous-objects. Class Reporter must not be used for any kind of state change.
public Reporter()
protected void actions()
public jDisco.Reporter setFrequency(double f)
The frequency may be changed as often as necessary. The frequency of each Reporter-object is zero until its setFrequency-method is called.
setFrequency may be called not only when the object is active, but also when it is inactive. However, it may only be called by a discrete process. Violating this rule leads to the error message
Illegal call of setFrequency (class Reporter)after which the simulation is stopped.
setFrequency returns a reference to this Reporter-object. This allows the user to write as follows:
new Plotter.setFrequency(0.1).start();where Plotter is a subclass of class Reporter.
public double getFrequency()
public double getReportTime()
For an active Reporter-object with a positive frequency, reportTime denotes the time when the next regular execution of the object's user-defined actions will take place. Executions due to discrete event occurrences are not taken into account.
reportTime may be viewed as a counterpart to the Process-method evTime.
If the object is inactive, the value of reportTime is of no interest to the user and is not updated. The initial value of reportTime is zero.
public boolean isActive()
public jDisco.Reporter start()
The object is inserted into one of the three lists of active Reporter-objects. The list the object is placed in is determined by the value of frequency - positive, zero, or negative. The first object of the three lists is denoted firstPosReporter, firstZeroReporter and firstNegReporter, respectively.
Calling start when the object is already active has no effect.
Note that each object is inactive until its start-procedure is called.
start may only be called by a discrete process. Violating this rule leads to the error message
Illegal call of start (class Reporter)after which the simulation is stopped.
public void stop()
stop removes the object from the list of active Reporter-objects.
Calling stop has no effect unless the object is active.
stop may only be called by a discrete process. Violating this rule leads to the error message
Illegal call of stop (class Reporter)
after which the simulation is stopped.
All Packages Class Hierarchy This Package Previous Next Index