Home : Supported Variable Configurations for Interface Q12447 - Advanced Settings
Q12467 - HOWTO: Supported Variable Configurations for Interface Q12447 - Advanced Settings

The advanced settings pertain to the variable Statistic and how the value is calculated. GE Proficy Historian enables various methodologies to gather data from its archives, and these settings apply most of those capabilities.

 

1. Changing Sampling and/or Calculation Modes:

The Q12447 inteface uses dot notation in the STATISTIC field. This field can be extended to include sampling mode and calculated mode (when applicable). The format for this is: STATISTIC.SAMPLINGMODE.CALCULATIONMODE. The text entered here is not case sensitive so average.trend is the same as AVERAGE.TREND. Let's look at how we set this up. NOTE: INVENTORY and RAINGAUGE use sampling mode "RawByTime" and cannot be changed.

First, select the Statistic you want for this variable from the drop down list, for example: AVERAGE.

Second, type a dot "." after the statistic and type in the Sampling Mode (from the list below) that you want to use. If you want the Average of the Trend sampling mode, your variable Statistic would look like this: AVERAGE.Trend (as shown below)

Third, and optionally, you can define Calculation Mode if you selected Calculated for the Sampling Mode. Simply add a dot "." after the Sampling Mode and enter one of the Calculation Mode's listed below. If you want the Average of the Calculated Maximum, you would enter the following in the Statistic field: Average.Calculated.Maximum.

NOTE: If you want to import data other than the default sampling mode of 'Lab' you need to specify in the Collector what other types of sampling modes you are interested in. If in the Variable Configuration for the Interface you configure a variable to use a sampling mode 'Interpolated' no results will be returned unless you check 'Interpolated' in the Collector. Also, the more sampling and calculation modes you select in the Collector, the more slowly it will run (i.e. if you select 4 sampling modes the Collector will have to process 4 times as much data as if you just selected the default sampling mode 'Lab')

2. Sampling Modes:

Sampling Mode is the mode of sampling from the archive. The following is supported sampling modes, their definition, and a sample of the query using the statistic AVERAGE for example:

SAMPLING MODE

DEFINITION

AVERAGE.INTERPOLATED Retrieves evenly spaced interpolated values based on NumberOfSamples and the time frame criteria.
AVERAGE.RAWBYTIME Retrieves raw archive values based on time frame criteria.
AVERAGE.RAWBYNUMBER Retrieves raw archive values based on the StartTime criteria, the NumberOfSamples, and Direction criteria. Note the EndTime criteria is ignored for this Sampling mode.
AVERAGE.CALCULATED Retrieves evenly spaced calculated values based on NumberOfSamples, the time frame criteria, and the CalculationMode criteria.
AVERAGE.LAB Returns actual collected values without interpolation.
AVERAGE.TREND Returns the raw minimum and raw maximum value for each specified interval. Use the Trend sampling mode to maximize performance when retrieving data points for plotting.

 

3. Calculation Mode - The CalculationMode column only applies if the SamplingMode is set to Calculated. It represents the type of calculation to perform on archive data. The following is supported calculation modes:

CALCULATION MODE

AVERAGE.CALCULATED.AVERAGE
AVERAGE.CALCULATED.COUNT
AVERAGE.CALCULATED.MAXIMUM
AVERAGE.CALCULATED.MINIMUM
AVERAGE.CALCULATED.STANDARDDEVIATION
AVERAGE.CALCULATED.TOTAL
AVERAGE.CALCULATED.RAWAVERAGE
AVERAGE.CALCULATED.RAWSTANDARDDEVIATION
AVERAGE.CALCULATED.RAWTOTAL
AVERAGE.CALCULATED.TIMEGOOD

 

4. Default Settings:

This interface has default settings depending on the statistic selected.

By default SAMPLINGMODE is set to LAB for all statistics except INVENTORY and RAINGAUGE which use RAWBYTIME.

If SAMPLINGMODE is set to CALCULATED, then the following rule is set by default (but can be changed):

If STATISTIC is,

then CALCULATION MODE is

MINIMUM.Calculated

MINIMUM

MAXIMUM.Calculated

MAXIMUM

COUNT.Calculated, CYCLE.Calculated, TIMELT.Calculated,
TIMEGT.Calculated, and TIMEEQ.Calculated

COUNT

[ All Others ].Calculated

AVERAGE

This means if you only specify MINIMUM.CALCULATED then the CALCULATION MODE will be set to MINIMUM.  

Related Articles
No Related Articles Available.

Article Attachments
No Attachments Available.

Related External Links
No Related Links Available.
Help us improve this article...
What did you think of this article?

poor 
1
2
3
4
5
6
7
8
9
10

 excellent
Tell us why you rated the content this way. (optional)
 
Approved Comments...
No user comments available for this article.
Created on 7/30/2009 2:29 PM.
Last Modified on 11/2/2010 9:40 AM.
Last Modified by No Author Name Available!.
Article has been viewed 3507 times.
Rated 0 out of 10 based on 0 votes.
Print Article
Email Article