F_VN_PredictSampleVectorExp
Compute a vectorial prediction for a single sample. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
FUNCTION F_VN_PredictSampleVectorExp : HRESULT
VAR_INPUT
    ipRegressor  : ITcVnMlModel;
    ipSample     : ITcUnknown;
    ipPrediction : Reference To  ITcVnContainer;
    fNovelty     : Reference To  REAL;
    hrPrev       : HRESULT;
END_VAR
          
 Inputs
| 
                   Name  | 
                   Type  | 
                   Description  | 
|---|---|---|
| 
                   ipRegressor  | 
                   Regressor to be used  | |
| 
                   ipSample  | 
                   Container holding a single input sample (ContainerType_Vector_REAL or ContainerType_Vector_LREAL)  | |
| 
                   ipPrediction  | 
                   Reference To ITcVnContainer  | 
                   Returns the predicted output (ContainerType_Vector_REAL or ContainerType_Vector_LREAL, depending on ipSample)  | 
| 
                   fNovelty  | 
                   Reference To REAL  | 
                   Returns the degree of novelty (0.0 if a sample is completely known; > 0.0 otherwise) of the presented sample (optional, set to 0 if not required)  | 
| 
                   hrPrev  | 
                   HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)  | 
Weiterführende Informationen
Die Funktion F_VN_PredictSampleVectorExp ist die Expert-Variante von F_VN_PredictSampleVector. Sie enthält zusätzliche Parameter.
Parameter
Regressionsmodell
Das zuvor trainierte Regressionsmodell muss an ipRegressor übergeben werden.
Sample
Der Sample-Container wird als ipSample übergeben. Der Typ des Containers muss entweder ContainerType_Vector_REAL oder ContainerType_Vector_LREAL sein.
Prädiktion
Der berechnete Prädiktionsvektor wird über die Referenz ipPrediction als Container zurückgegeben. Der Container-Typ wird von ipSamples übernommen.
Anomalie-Stärke
Die Anomalie-Stärke des Sample wird über fNovelty zurückgegeben.
Anwendung
Der Prädiktionsvektor eines Samples kann z.B. so berechnet werden:
hr := F_VN_PredictSampleVectorExp(
    ipRegressor := ipRegressor,
    ipSample    := ipSample,
    ipPrediction:= ipPrediction,
    fNovelty    := fNovelty,
    hrPrev      := hr);Verwandte Funktionen
Required License
TC3 Machine Learning Realtime Inference
System Requirements
Development environment  | Target platform  | PLC libraries to include  | 
|---|---|---|
TwinCAT V3.1.4024.59 or later  | PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU  | Tc3_Vision  | 
 Return value