F_VN_GetSampleCluster
Get the ID of the best-matching cluster of a single sample.
Syntax
Definition:
FUNCTION F_VN_GetSampleCluster : HRESULT
VAR_INPUT
ipClusterer : ITcVnMlModel;
ipSample : ITcUnknown;
END_VAR
VAR_IN_OUT
nCluster : DINT;
END_VAR
VAR_INPUT
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipClusterer |
Clusterer to be used | |
|
ipSample |
Container holding a single input sample (ContainerType_Vector_REAL or ContainerType_Vector_LREAL) | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
nCluster |
DINT |
Returns the ID of the cluster the sample has been assigned to |
Return valueWeiterführende Informationen
Die Funktion F_VN_GetSampleCluster ermittelt für ein Sample das am besten passende Cluster und gibt dessen ID zurück.
Parameter
Clusterer-Modell
Für die Zuordnung zu Clustern muss ein zuvor trainiertes Modell an ipClusterer übergeben werden.
Sample
Ein Container mit einem Sample wird an ipSample übergeben. Der Typ des Containers muss ContainerType_Vector_REAL oder ContainerType_Vector_LREAL sein.
Cluster-ID
Die ermittelte ID wird über nCluster zurückgegeben.
Expert-Parameter
Die Expert-Variante F_VN_GetSampleClusterExp enthält zusätzliche Parameter.
Anwendung
Die Zuordnung von einem Sample zu einem Cluster kann so berechnet werden:
hr := F_VN_GetSampleCluster(
ipClusterer := ipClusterer,
ipSample := ipSample,
nCluster := nCluster,
hrPrev := hr);
Verwandte Funktionen
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 |