Applies to:  CELONIS 4.0 CELONIS 4.2 CELONIS 4.3 CELONIS 4.4 CELONIS 4.5 CELONIS 4.6 

Description

Calculates the average of the specified column for each element of the given child table.

Like the regular AVG operator, the column can either be an INT or FLOAT column. The data type of the result is always a FLOAT (Since:  CELONIS 4.5).

If no value in the parent table exists for the element in the child table (either because all values of the parent table column are filtered out, or because no corresponding value exists in the first place), NULL will be returned.

Syntax

PU_AVG ( child_table, parent_table.column [, filter_expression] )
PU_AVG ( DOMAIN_TABLE ( column1,...,columnN ), parent_table.column [, filter_expression] )

Examples


[1] Calculate the average of the case table values for each company code:

Query
Column1
"companyDetail"."companyCode"
Column2
PU_AVG("companyDetail", "caseTable"."value")
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
companyDetail
companyCode : STRINGcountry : STRING
'001''DE'
'002''DE'
'003''US'

Foreign Keys
caseTable.companyCodecompanyDetail.companyCode
Output
Result
Column1 : STRINGColumn2 : FLOAT
'001'
400.0
'002'
300.0
'003'
200.0



[2] PU functions can be used in a FILTER. In this example, the company codes are filtered such that the corresponding average case table value is smaller than 300:

Query
Filter
FILTER PU_AVG ( "companyDetail", "caseTable"."value" ) < 300
Column1
"companyDetail"."companyCode"
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
companyDetail
companyCode : STRINGcountry : STRING
'001''DE'
'002''DE'
'003''US'

Foreign Keys
caseTable.companyCodecompanyDetail.companyCode
Output
Result
Column1 : STRING
'003'



[3] PU functions can be used inside another aggregation function. In this example, the maximum value of all average case table values for each company code is calculated:

Query
Column1
MAX ( PU_AVG ( "companyDetail", "caseTable"."value" ) )
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
companyDetail
companyCode : STRINGcountry : STRING
'001''DE'
'002''DE'
'003''US'

Foreign Keys
caseTable.companyCodecompanyDetail.companyCode
Output
Result
Column1 : FLOAT
400.0



[4] Calculate the average of the case table values for each company code. Only consider cases with an ID larger than 2:

Query
Column1
"companyDetail"."companyCode"
Column2
PU_AVG("companyDetail", "caseTable"."value", "caseTable"."caseID" > 2)
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
companyDetail
companyCode : STRINGcountry : STRING
'001''DE'
'002''DE'
'003''US'

Foreign Keys
caseTable.companyCodecompanyDetail.companyCode
Output
Result
Column1 : STRINGColumn2 : FLOAT
'001'
200.0
'002'
300.0
'003'
200.0



[5] Calculate the sum of the case table values for each company code. Only consider cases with an ID larger than 3. All case table values for companyCode '001' are filtered out, which means that in this case, NULL is returned.

Query
Column1
"companyDetail"."companyCode"
Column2
PU_AVG("companyDetail", "caseTable"."value", "caseTable"."caseID" > 3)
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
companyDetail
companyCode : STRINGcountry : STRING
'001''DE'
'002''DE'
'003''US'

Foreign Keys
caseTable.companyCodecompanyDetail.companyCode
Output
Result
Column1 : STRINGColumn2 : FLOAT
'001'
null
'002'
300.0
'003'
200.0



[6] Example over three tables: For each entry in table B, calculate the average of the values that are larger than 100 in table C. Tables B and C do not have a direct connection, but are connected via table A:

Query
Column1
"B"."B_KEY"
Column2
PU_AVG("B", "C"."VALUE", "C"."VALUE" >100)
Input
A
B_KEY : INTC_KEY : STRINGVALUE : INT
1
'A'
100
1
'B'
200
2
'C'
300
2
'D'
400
3
'E'
500
3
'F'
600
B
B_KEY : INT
1
2
C
C_KEY : STRINGVALUE : INT
'A'
400
'A'
100
'A'
200
'B'
100
'C'
200
'D'
500

Foreign Keys
C.C_KEYA.C_KEY
B.B_KEYA.B_KEY
Output
Result
Column1 : INTColumn2 : FLOAT
1
300.0
2
350.0



[7] For each case ID, calculate the average of the case table values for the associated company code using DOMAIN_TABLE:

Query
Column1
"caseTable"."caseId"
Column2
PU_AVG(DOMAIN_TABLE("caseTable"."companyCode"), "caseTable"."value")
Input
caseTable
caseId : INTcompanyCode : STRINGvalue : INT
1
'001'
600
2
'001'
400
3
'001'
200
4
'002'
300
5
'002'
300
6
'003'
200
Output
Result
Column1 : INTColumn2 : FLOAT
1
400.0
2
400.0
3
400.0
4
300.0
5
300.0
6
200.0


  • No labels