When monitoring deformation, timely alerts to movement can be very important. Measurand’s SAACR_raw2data can trigger alarms based on a variety of settings. A triggered alarm can play a sound, send an email, or send an SMS message.


Alarm settings are configured and enabled through Measurand’s SAAView application after the raw data from the ShapeArrays being monitored has been converted with SAACR_raw2data. The process of configuring alarm settings in SAAView will generate an ArrayAlarmSaa.mat file in the project folder which is used by SAACR_raw2data during the conversion process.



Step 1 - Convert Raw ShapeArray Data


Before any alarms can be set, the raw data collected from a ShapeArray must first be converted using SAACR_raw2data. For more information on converting raw data, please refer to the SAACR_raw2data How-To Guide.



Step 2 - Open Converted ShapeArray Data in SAAView


To configure alarms, you must open the converted data from the ShapeArray in SAAView. For more information on how to use SAAView, please refer to the Using SAAView to Visualize ShapeArray Data guide.



Step 3 - Open the Alarm Setup Window


Figure 1: The AlarmSet button in SAAView


Click on the AlarmSet button to begin configuring alarms. This will open the Alarm Setup window. In this window there are two sections of information presented. The top, green section will contain a listing of all ShapeArrays in the project and provide a brief summary of their alarm status. The bottom, yellow section will contain a listing of all non-ShapeArray sensors in the project.


Figure 2: The Alarm Setup window in SAAView


The information presented in these sections includes the following:

  • SaaSernum / SensorSernum: The serial number of the ShapeArray or non-ShapeArray sensor respectively is listed in these columns.
  • Level: The level for which the alarms settings apply is listed in this column. For ShapeArrays, there are eight separate levels of alarms that can be configured. The level displayed will match the level selected in the AlarmLevel dropdown box.
  • ParamsSet: Whether or not alarm parameters have been set for the selected level is displayed. When set, this column will contain the value SET.
  • Copy Of: Often you will want to use the same alarm settings for multiple ShapeArrays within your project. You can copy the settings from one ShapeArray to another. The CopyOf field defines the ShapeArray from which the alarm settings were copied. If the settings were copied from another ShapeArray’s alarm settings, then the serial number of that ShapeArray will appear in this column; otherwise, a question mark (?) will be displayed.
  • On/Off: This column will indicate whether the alarm settings are enabled. When enabled, a value of ON will be displayed; otherwise, a value of off will be displayed.



Step 4 - Open Alarm Parameters Window


In the Alarm Setup window, select a ShapeArray from the listing and select a level from the AlarmLevel dropdown box. Click the Param button to open the Alarm Parameters window.


Figure 3: The AlarmLevel dropdown and Param button in SAAView's Alarm Setup window


The Alarm Parameters window is where you will configure the triggering condition for the alarms. Alarm trigger conditions are defined by a comparison between “old” and “new” data for a specified variable.


Figure 4: The Alarm Parameters window in SAAView



Step 5 - Configure the Alarm Variable


For ShapeArrays, the variable being monitored for alarms is absolute shape (cumulative deviation). You can select one of the following options for comparing cumulative deviation in the Variable field.

  • var - var(1): The cumulative deviation in the first frame of data is subtracted from each other reading to provide displacement
  • Rate: The change in cumulative deviation over time. The time period is calculated based on the interval between readings in the data collected. If the collection period is not stable, alarms based on rate can have anomalous results.
  • var: The cumulative deviation with nothing subtracted from it


Figure 5: The Variable, Comparison("Old") Data, and DelayDays fields from the Alarm Parameters window in SAAView


Step 6 - Configure the Comparison Data


The comparison data, also known as the “old” data, is the basis for the comparison used to determine the alarm’s trigger condition. Comparison data can be selected using one of the following options in the Comparison(“Old”) Data field, shown in the figure above.

  • Avg of n: The comparison data will be the average of n samples. The number of samples is selected with the n dropdown box. The samples being averaged will be the n samples preceding the current sample unless both Comparison(“Old”) Data and CurrentData are set to Avg of n. Refer to step 7 for more information.
  • Selected Time: The comparison data will be the value at a selected time. A time is selected by dragging the dotted yellow line to the desired sample, right clicking on the dotted yellow line, and then clicking the Select this time option.
  • Current - 1: The comparison data will be the sample taken immediately before the current sample.


Figure 6: Drag and then right click on the dotted yellow line to select a specific time in the Alarm Parameters window


Step 7 - Configure the Current Data


Current data, also known as “new” data, will be compared with the old data configured in step 6. Current data is selected using one of the following options from the CurrentData field.

  • Non-avg Single: The most recent sample will be used as the current data.
  • Avg of n: The average the most recent n samples will used as the current data. The number of samples is selected with the n dropdown box.


NOTE: If the Comparison(“Old”) Data field and the CurrentData field are both set to Avg of n, then the DelayDays field will be enabled. DelayDays specifies a number of days between the two averaged ranges used for comparison. This creates a moving window for comparison.


Figure 7: The CurrentData, Limits, Units/Value, and Action fields from the Alarm Parameters window in SAAView


Step 8 - Select Limits and Units/Value Options


The Limits field, shown in the figure above, allows you to trigger the alarm if the new data being monitored increases or decreases beyond the setting specified in the Units/Value field. The limit being monitored can be set to Upper, Lower, or Both to create upper and/or lower boundaries.


The Units/Value field, also shown in the figure above, allows you to define the comparison being made between the new data and the old data. Comparison values are specified in the text field immediately below this field. The following selections can be made in the Units/Value field.

  • Limits(Units): Compares the current value to a specified limit. No comparison is made to old data.
  • Change(%): Compares the new data and old data. Triggers an alarm if the new data is greater than a specified percentage of the old data.
  • Change(Units): Compares the new data and the old data. Triggers an alarm if the new data is greater than a specified number of units of the old data.


Once you have selected the Limits and Unit/Value options, enter the comparison value in the text field, click on the grey space in the window, and then click the Apply button.



Step 9 - Configure Alarm Actions


Once you have configured alarm settings, you need to configure the action that will be taken when the alarm is triggered. Click on the Settings button in the Action section, shown in the figure above, to open the Alarm Action Settings window, shown in the figure below. 


Figure 8: The Alarm Action Settings window in SAAView


Select the checkbox next to the actions you wish to be triggered and then configure their settings. The following actions are available:


Sound

Click the Browse button and navigate to a .wav sound file. By default, the path to the ding.wav sound file included in the C:\Measurand Inc\SAA3D folder is defined.


Email

Configure the settings for sending an email in the following text fields.

  • From: The address from which the email will be sent
  • To: The addresses to which the email will be sent (Multiple addresses are separated by commas)
  • Server: The address of the email (SMTP) server that will be used to send the email
  • Port: The TCP/IP port on the email (SMTP) server that will be used to send the email
  • Username: The username of a user authorized to send email on the email (SMTP) server
  • Password: The password for the user defined in the Username field


SMS

SMS messages are supported only through services which accept an email to send an SMS message to a subscriber. The fields for configuring SMS actions are the same as those for email actions.

  • From: The address from which the email will be sent
  • To: The addresses to which the email will be sent are defined in this field (Multiple addresses are separated by commas)
  • Server: The address of the email (SMTP) server that will be used to send the email
  • Port: The TCP/IP port on the email (SMTP) server that will be used to send the email
  • Username: The username of a user authorized to send email on the email (SMTP) server
  • Password: The password for the user defined in the Username field


Any of the settings can be tested by clicking the corresponding Test button. Once you have configured the appropriate actions and settings to be triggered, click the Save button to close the Alarm Actions Settings window and click the Save button again to close the Alarm Parameters window.



Step 10 - Optional, Configure More Alarms in the Project


If you wish to have multiple levels of alarms, or alarms for multiple sensors in the project, you can repeat steps 4 through 9 by selecting a different level in the Level dropdown box or by selecting a different sensor in the green or yellow sections of the Alarm Setup window. Once you have configured alarms for the desired sensors and levels, click on the Save button to save the configuration. The next time SAACR_raw2data runs on the raw data files in the project folder, alarms will be triggered when the configured conditions are met and the appropriates actions will be taken.