Skip to main content

PQL47 (PQL Function Library - CPM 4.7)

PU_AVG

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

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).

Syntax
PU_AVG ( child_table, parent_table.column [, filter_expression] )

  • child_table: The table to which the aggregation result should be pulled. This can be:

  • parent_table.column: The column which should be aggregated for every row of the child_table.

  • filter_expression (optional): An optional filter expression to specify which values of the parent_table.column should be taken into account for the aggregation.

NULL handling

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

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

Output

caseTable

caseId : INT

companyCode : STRING

value : INT

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : STRING

country : STRING

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : STRING

Column2 : 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

Output

caseTable

caseId : INT

companyCode : STRING

value : INT

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : STRING

country : STRING

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

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

Output

caseTable

caseId : INT

companyCode : STRING

companyCode : STRING

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : STRING

country : STRING

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

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

Output

caseTable

caseId : INT

companyCode : STRING

value : INT

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : STRING

country : STRING

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : STRING

Column2 : FLOAT

'001'

200.0

'002'

30.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

Output

caseTable

caseId : INT

companyCode : STRING

value : INT

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

companyDetail

companyCode : STRING

country : STRING

'001'

'DE'

'002'

'DE'

'003'

'US'

Foreign Keys

caseTable.companyCode

companyDetail.companyCode

Result

Column1 : STRING

Column2 : 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

Output

A

B_KEY : INT

C_KEY : STRING

VALUE : INT

1

'A'

100

1

'B'

200

2

'C'

300

2

'D'

400

3

'E'

500

3

'F'

600

B

VALUE : INT

1

2

C

C_KEY : STRING

VALUE : INT

'A'

400

'A'

100

'A'

200

'B'

100

'C'

200

'D

500

Foreign Keys

C.C_KEY

A.C_KEY

B.B_KEY

A.B_KEY

Result

Column1 : INT

Column2 : 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

Output

caseTable

caseId : INT

companyCode : STRING

value : INT

1

'001'

600

2

'001'

400

3

'001'

200

4

'002'

300

5

'002'

300

6

'003'

200

Result

Column1 : INT

Column2 : FLOAT

1

400.0

2

400.0

3

400.0

4

300.0

5

300.0

6

200.0

See also: