FB_VN_SSIM
This FB provides the structural similarity (SSIM) functionality. First, set the reference image. Afterwards, the Compute method can be executed.
Do not call the main FB directly. Only use the available methods.
Methods
|
Name |
Description |
|---|---|
|
Compute the structural similarity (SetReference must have been called before). | |
|
Sets the reference image, used by the SSIM method. |
Weiterführende Informationen
Der Funktionsblock FB_VN_SSIM berechnet die strukturelle Ähnlichkeit von zwei Graustufenbildern. Als Referenz wird von einem störungsfreien Bild ausgegangen.
Parameter
Eingangsbilder
Das Referenz- und Eingangsbild muss ein 1-kanaliges Bild mit Element-Typ USINT (8 Bit) sein. Zuerst muss das Referenz-Bild mit der Methode SetReference übergeben werden. Danach kann die Ausführung mit Aufruf der Compute Methode erfolgen, der das Eingangsbild übergeben wird.
Ausgangsbild (Rückgabewert)
Das Ausgangsbild ist vom Typ Real und auf den Wertebereich von 0-1 skaliert. Eine 1 bedeutet Übereinstimmung und 0 eine maximale Abweichung.
Anwendung
Die Ausführung besteht aus 2 Schritten. Zuerst muss das Referenz-Bild gesetzt werden. Danach kann die Compute Methode aufgerufen werden, der das aktuell zu vergleichende Eingangsbild übergeben wird.
Zur weiteren Analyse des Ergebnisbilds z. B. mit der F_VN_DetectBlobs Funktion ist es notwendig, das Bild in ein USINT zu konvertieren. Dazu kann die Funktion F_VN_ConvertElementTypeExp verwendet werden. Über die Funktionen F_VN_ImageAverage oder F_VN_MinPixelValue kann direkt auf Basis des Ergebnisbilds ein Übereinstimmungswert ermittelt werden.
// Set reference image first
hr := fbSSIM.SetReference(ipImage := ipRefImage);
// Check if successful, set imput image and compute the result
IF SUCCEEDED(hr) and ipRefImage <> 0 THEN
hr := fbSSIM.Compute(ipSrcImage:= ipImageIn, ipSSIM:= ipResultImage);
// Convert and scale the result image to USINT
hr := F_VN_ConvertElementTypeExp(ipResultImage, ipResult2Image, ETcVnElementType.TCVN_ET_USINT, (255.0/1.0), 0, hr);
END_IF | Hohe Speicherauslastung bei großen Bildern Da die Funktion im Hintergrund viele Berechnungen mit Real-Werten durchführt, wird in Abhängigkeit zur Bildgröße entsprechend mehr Router Speicher und Rechenleistung benötigt. |
Required License
TC3 Vision Matching
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 |