Skip to main content Skip to complementary content

STEYX - chart function

STEYX() returns the aggregated standard error when predicting y-values for each x-value in a linear regression given by a series of coordinates represented by paired numbers in the expressions given by y_value and x_value.

Syntax:  

STEYX([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] y_value, x_value)

Return data type: numeric

Arguments:  

Arguments
ArgumentDescription
y_valueThe expression or fieldcontaining the range of known y-values to be measured.
x_valueThe expression or field containing the range of known x-values to be measured.
SetExpressionBy default, the aggregation function will aggregate over the set of possible records defined by the selection. An alternative set of records can be defined by a set analysis expression.
DISTINCTIf the word DISTINCT occurs before the function arguments, duplicates resulting from the evaluation of the function arguments are disregarded.
TOTAL

If the word TOTAL occurs before the function arguments, the calculation is made over all possible values given the current selections, and not just those that pertain to the current dimensional value, that is, it disregards the chart dimensions.

By using TOTAL [<fld {.fld}>], where the TOTAL qualifier is followed by a list of one or more field names as a subset of the chart dimension variables, you create a subset of the total possible values.

Defining the aggregation scope

Limitations:  

The parameter of the aggregation function must not contain other aggregation functions, unless these inner aggregations contain the TOTAL qualifier. For more advanced nested aggregations, use the advanced function Aggr, in combination with a specified dimension.

Text values, NULL values and missing values in any or both pieces of a data-pair result in the entire data-pair being disregarded.

Examples and results:  

Add the example script to your app and run it. Then build a straight table with KnownY and KnownX as dimension and Steyx(KnownY,KnownX) as measure

Totals should be enabled in the properties of the table.

Example Result

Trend:

LOAD * inline [

Month|KnownY|KnownX

Jan|2|6

Feb|3|5

Mar|9|11

Apr|6|7

May|8|5

Jun|7|4

Jul|5|5

Aug|10|8

Sep|9|10

Oct|12|14

Nov|15|17

Dec|14|16

] (delimiter is '|');

The result of the STEYX(KnownY,KnownX) calculation is 2.071 (If number formatting is set to 3 decimal places.)

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!