F_VN_TrainSampleCluster

Train a clusterer with a single sample and return the ID of the cluster the sample has been assigned to, if requested. The clusterer must be online trainable.

Syntax

Definition:

FUNCTION F_VN_TrainSampleCluster : HRESULT
VAR_INPUT
    ipClusterer : ITcVnMlModel;
    ipSample    : ITcUnknown;
    nCluster    : Reference To  DINT;
    hrPrev      : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipClusterer	ITcVnMlModel	Clusterer to be used
ipSample	ITcUnknown	Container holding a single input sample (ContainerType_Vector_REAL or ContainerType_Vector_LREAL)
nCluster	Reference To DINT	Returns the ID of the cluster the sample has been assigned to (If the pointer is 0, no cluster ID is requested.)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Further information

The function F_VN_TrainSampleCluster trains a clusterer model with a sample and returns the corresponding cluster ID of the sample.

Parameter

Clusterer model

The previously created Clusterer model must be transferred to ipClusterer.

Sample

The sample container is transferred as ipSample. The type of container must be ContainerType_Vector_REAL or ContainerType_Vector_LREAL.

Cluster

The cluster ID associated with the sample is returned via nCluster.

Application

For example, a Clusterer model can be trained with a single sample as follows:

hr := F_VN_TrainSampleCluster(
    ipClusterer     := ipClusterModel,
    ipSample        := ipSample,
    nCluster        := nCluster,
    hrPrev          := hr);

Related functions

Required License

TC3 Vision Machine Learning

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