New... - Displays a dialog to name a new event and then creates a new settings page.
Remove - Enabled when an Event is selected. Clicking removes the event configuration and data from the event database.
Settings - A setting page is created for each event configured. Changing any setting for the event will clear the previous events from the event database and begin checking the data for new events with the updated settings when applied.
Description - A text field describing the event.
Source - Required. Minimum requirement is a View on the local machine. This could be the local Historian or an Asset Model view.
If all the tags used in the configuration are from the same DataSet or Asset then this could be added to the source, separated by a period; View.DataSet.
Asset Type - Optional for local Historian View. When the source is an Asset Model then this field is a defined Asset Type within the model. An Asset Type will search through all instances of this asset type.
Start Trigger/End Trigger - This is an expression that evaluates to True or False. If the Start Trigger evaluates to TRUE, then this is defined as the beginning of an event. Then the End Trigger is evaluated on the data to find where an event ends. If the End Trigger Expression is empty, the reverse of the Start Trigger Expression becomes the End Trigger. An expression may look like [DO] > 6.0. This expression will evaluate the data stream of the tag looking for the DO tag value to be above 6.0. For tag values the names must be enclosed within square brackets [ ]. The tag is read from the specified View. The full tag name is the Source Path or Asset Instance with the tag name from the expression appended to the end.
Multiple tags can be incorporated into the expression: [DO] > 6.1 && [Cycle] < 150
Quality and Property values can also be used in expressions. Functions are used to access these values. An expression to get the quality of the current value may look like Quality('Tag001'). Properties are expressed as Property('Tag001', 'Property Name'). Since the function is not accessing the value the tag name is enclosed in single quotes ' ' and the parameters are included within the parenthesis ( ).
The AND and OR functions can be used to evaluate multiple expressions. For instance AND([Tag001], [Tag002], [Tag0003]), would evaluate to TRUE only when all the tag values do not equal 0.
Expression - The evaluation process is case sensitive
- Logical Operators: or, ||, and, &&
- Relational Operators: =, ==, !=, <>, <, <=, >, >=
- Math Operators: +, -, *, /, %
- Bitwise Operators:& (bitwise and), | (bitwise or), ^(bitwise xor), << (left shift), >>(right shift)
- Unary Operators: !, not, -, ~ (bitwise not)
- Primary Operators: ( )
- Values:Integers, Floating point numbers, Scientific notation, Dates and Times, Booleans, Strings
- Functions: Abs, Acos, Asin, Atan, Ceiling, Cos, Exp, Floor, IEEERemainder, Log, Log10, Max, Min, Pow, Round, Sign, Sin, Sqrt, Tan, Truncate, Quality, Property, AND, OR
Start Time-Shift/End Time-Shift - The start and end time shifts only apply to the way the event is viewed in Axiom. This is how much data will be shown on the trend graph before (start time shift) and after (end time shift) the duration of the event.
Min Duration - If "00:00:00" (hh:mm:ss) all events found will be reported. If set, the event must last for the minimum duration before it will be reported. The input can be 00:10:00 for a 10-minute duration, or 10m.
Notify Email - This requires SMTP Server and email addresses to be setup under Messages > Configuration > Email. When a Start Trigger evaluates to TRUE and the Min Duration has elapsed (an event has occurred), an email will be sent to the email recipients.
Backfill Duration - Events are processed on real time data from the time you save the event config until you disable or delete it. Backfilling is an additional feature that if configured (backfill duration > 0) upon save of the config, the software will save any events that have occurred in the past by loading data from the historian from NOW – Backfill duration until NOW.
Properties - Properties allow for additional raw values or the result of calculations (equations) to be stored with the event.
Name - A text field describing the property.
Equation - The library that we use supports all of the functions in System.Math (https://msdn.microsoft.com/en-us/library/system.math_methods(v=vs.110).aspx).
It also supports simple math operators (+, -, *, /). Full documentation on this library can be found here: https://github.com/MichaelAguilar/NCalc.
Operators supported: https://github.com/ncalc/ncalc/wiki/Operators.
In addition to those, we have also exposed our aggregate function names from the views service such as TimeAverage2().
Ex. Property Name: CombinedAveragePressures. Equation: TimeAverage2([PressureTag1]) + TimeAverage2([PressureTag2])
In the property equations, tag names must be surrounded by square brackets. This also applies to the start and end expressions.
Associated Tags - A list of tags related to the event. They may include tags used in the expressions above or additional tags which can be added to Axiom when viewing the event.