F_VN_ContainerAverage

Syntax

Definition:

FUNCTION F_VN_ContainerAverage : HRESULT
VAR_INPUT
    ipSrcContainer : ITcVnContainer;
END_VAR
VAR_IN_OUT
    fAverage       : LREAL;
END_VAR
VAR_INPUT
    hrPrev         : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcContainer	ITcVnContainer	Source container (Arithmetic, point and vector element types are supported. For points and vectors, the euclidean norm is used.)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
fAverage	LREAL	Returns the calculated average value

Return value

HRESULT

Further information

The table below shows which functions can be used for which container type:

Types of containers	Usable functions
Containers of elements	F_VN_ContainerAverage F_VN_ContainerAverageVariance
Containers of vectors, each with 2 elements	F_VN_ContainerAverageElementwise2 F_VN_ContainerAverageVarianceElementwise2
Containers of vectors, each with 3 elements	F_VN_ContainerAverageElementwise3 F_VN_ContainerAverageVarianceElementwise3
Containers of vectors, each with 4 elements	F_VN_ContainerAverageElementwise4 F_VN_ContainerAverageVarianceElementwise4

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.54 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision