F_VN_GetBatchClustersExp
Get the IDs of the best-matching clusters of a batch of samples.
Syntax
Definition:
FUNCTION F_VN_GetBatchClustersExp : HRESULT
VAR_INPUT
ipClusterer : ITcVnMlModel;
ipSamples : ITcUnknown;
ipClusters : Reference To ITcVnContainer;
ipNovelties : Reference To ITcVnContainer;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipClusterer |
Clusterer to be used | |
|
ipSamples |
Container holding a batch of input samples (ContainerType_Vector_Vector_REAL or ContainerType_Vector_Vector_LREAL) | |
|
ipClusters |
Reference To ITcVnContainer |
Returns the cluster IDs (ContainerType_Vector_DINT) |
|
ipNovelties |
Reference To ITcVnContainer |
Returns the degree of novelty (0.0 if a sample is completely known; > 0.0 otherwise) of each sample (ContainerType_Vector_REAL; optional, set to 0 if not required) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Die Funktion F_VN_GetBatchClustersExp ist die Expert-Variante von F_VN_GetBatchClusters. Sie enthält zusätzliche Parameter.
Parameter
Clusterer-Modell
Für die Zuordnung zu Clustern muss ein zuvor trainiertes Modell an ipClusterer übergeben werden.
Samples
Ein Container mit den Samples wird an ipSamples übergeben. Der Typ des Containers muss ContainerType_Vector_Vector_REAL oder ContainerType_Vector_Vector_LREAL sein.
Cluster-IDs
Ein Container mit den ermittelten IDs wird über die Referenz ipClusters zurückgegeben.
Anomalie-Stärken
Ein Container mit den Anomalie-Stärken jedes Samples wird über die Referenz ipNovelties zurückgegeben. Die Anomalie-Stärke gibt an, wie stark sich ein Sample von den Clustern unterscheidet. Eine Anomalie-Stärke von 0 gibt an, dass ein Sample exakt im Zentrum eines Clusters liegt.
Anwendung
Die Zuordnung von Samples zu Clustern inklusive der Anomalie-Stärken kann so berechnet werden:
hr := F_VN_GetBatchClustersExp(
ipClusterer := ipClusterer,
ipSamples := ipSamples,
ipClusters := ipClusters,
ipNovelties := ipNovelties,
hrPrev := hr);Verwandte Funktionen
Required License
TC3 Vision Machine Learning
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.59 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |