F_VN_InverseFeatureScalingExp

Apply the inverse of feature scaling to one or more sample(s). [fA, fB] should be used if the scaling has been performed using TCVN_FST1_MINMAX with a predetermined output range.. (expert function)

Syntax

Definition:

FUNCTION F_VN_InverseFeatureScalingExp : HRESULT
VAR_INPUT
    ipSamples        : ITcVnContainer;
    ipScales         : ITcVnContainer;
    ipInverseSamples : Reference To  ITcVnContainer;
    fA               : LREAL;
    fB               : LREAL;
    hrPrev           : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSamples	ITcVnContainer	Container holding one or more input sample(s) (ContainerType_Vector_REAL, ContainerType_Vector_LREAL, ContainerType_Vector_Vector_REAL, or ContainerType_Vector_Vector_LREAL)
ipScales	ITcVnContainer	Container with the scaling parameters of each feature (type ContainerType_Vector_REAL or ContainerType_Vector_LREAL).
ipInverseSamples	Reference To ITcVnContainer	Returns the inversed sample(s) using the scaling type and parameters of ipScales. It has the same type of ipSamples. If the same container ipSamples is used, the source data will be replaced.
fA	LREAL	represents the lower bound of the range for TCVN_FST1_MINMAX
fB	LREAL	represents the upper bound of the range for TCVN_FST1_MINMAX
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Weiterführende Informationen

Die Funktion F_VN_InverseFeatureScalingExp ist die Expert-Variante von F_VN_InverseFeatureScaling. Sie enthält zusätzliche Parameter.

Parameter

Samples

Ein oder mehrere Samples müssen als Container an ipSamples übergeben werden.

Skalierung

Ein Container mit dem Skalierungstyp und den entsprechenden Skalierungsparametern muss an ipScales übergeben werden. Der Container kann durch die Funktion F_VN_GetFeatureScales berechnet oder nach dem dort beschriebenen Aufbau selbst erstellt werden.

Skalierte Samples

Die invers skalierten Samples werden über die Referenz ipInverseSamples zurückgegeben.

Festlegen des Ausgabebereichs

Wenn der Skalierungstyp TCVN_FST1_MINMAX verwendet wird, kann über fA und fB zusätzlich der Wertebereich der Ausgabewerte vorgegeben werden.

Anwendung

Eine inverse Merkmalsskalierung, bei der die Skalierung vorher durch F_VN_FeatureScalingExp berechnet wurde, mit einem Ausgabewertebereich von 0,1 bis 0,9 sieht z.B. so aus:

hr := F_VN_FeatureScalingExp(ipSamples, ipScales, ipSamplesScaled, 0.1, 0.9, hr);

hr := F_VN_InverseFeatureScalingExp(
    ipSamples       := ipSamplesScaled,
    ipScales        := ipScales,
    ipInverseSamples:= ipSamplesInvertedScaling,
    fA              := 0.1,
    fB              := 0.9,
    hrPrev          := hr);

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