Event Information
Overview
Use the Event Information operator to view and manipulate captured values in events.Operator ports
Input Any: Any sample type. The connection is not limited to one type of signal.Output Event values: Floating point values
This is a Constant output, which does not output a signal, but a single value. A constant output does not have a sample frequency and is therefore recognized by Polybench to be a constant. Many calculations can be performed on constants as well as signals (or a combination of both). If another operator performs a calculation on constants only, it becomes a constant operator itself.
Constants and any other data source are allowed to be mixed without synchronization (link).
In a schematic, connectors that are connected to constant outputs are always colored black, while connections from other data sources may be colored differently.
Properties
Find more information about changing properties here: linkEventCode
type: See descriptionName of the event marker that this operator makes available for information to the project.
SyncID
type: See descriptionSynchronization code to synchronize the data cursor with other viewers
Caption
type: Word or phraseThe name of the object in the project. This name must not contain '.' or '$' characters.
Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.
Documentation
type: See descriptionOptional documentation of this object.
It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.
Variable Parameters
Find more information about Variable Parameters here: linkTimeStamp
type: See description [this value cannot be changed]The time stamp of the event marker that is currently shown, expressed as a time value.
TimeStampSeconds
type: See description [this value cannot be changed]The time stamp of the event marker that is currently shown, expressed in seconds.
Values
type: Parameter list (see link)All the values in the event marker that is currently shown.
SequenceNumber
type: See descriptionSequence number of the current event in the row of events with the specified code that have occurred in the past (starting with 0).
Details
Which event is the current event in the Event Information operator, depends on its input connection.If the operator is connected to a live data stream, then the last event in that stream that has the Event Code as set in the properties is the current event.
If the operator is connected to a Storage or Replay operator, in a way that stored data are accessible (so only Preparation operators may be in between), then there are two options to control which event is read from the data store:
1) by using the Data Cursor. You then have to specify a SyncID, which should be the same as one in an object that can change the Data Cursor. For example a Y-T Reviewer, or an Event Viewer, both that need to have an equal SyncID.
2) by using the SequenceNumber variable parameter. This refers to the sequence of events. You must leave the SyncID property empty if you want to use the sequence numbers!
Examples
Example: Event Information Demo
Demonstrates how the Event Information is used to find specific event markers in a signal file, and display some details about the event marker. In this demo, the Event Information operator works in the Sequence Number mode, so which event is displayed depends on the sequence number variable.The Marker Viewer in this example does nothing; it is there just to show all events for your information.
If events contain one or more values, the values are displayed in the List Viewer to the right.
Examples\DF0600014_001_Event_Information_Demo.xmc