F_VN_Granulometry

Syntax

Definition:

FUNCTION F_VN_Granulometry : HRESULT
VAR_INPUT
    ipImage          : ITcVnImage;
    ipIntensityDiffs : Reference To  ITcVnContainer;
    eMorphType       : ETcVnMorphologicalOperator;
    nMinSize         : UDINT;
    nMaxSize         : UDINT;
    nStep            : UDINT;
    hrPrev           : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipImage	ITcVnImage	Source image (1 channel)
ipIntensityDiffs	Reference To ITcVnContainer	Returns the intensity differences between successive structuring element sizes (CTcVnContainer_Vector_LREAL), which can be used as features for texture description.
eMorphType	ETcVnMorphologicalOperator	Only opening or closing are supported.
nMinSize	UDINT	Min structuring element size (odd, >= 3)
nMaxSize	UDINT	Max structuring element size (>= nMinSize)
nStep	UDINT	Step, by which nMinSize is incremented until nMaxSize is exceeded (even, >= 2).
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_Granulometry berechnet die granulometrischen Eigenschaften eines Bildes. Diese Werte geben einen Hinweis auf die Größenverteilung verschiedener Bildbereiche.

Parameter

Bild

Das Eingangsbild ipImage.

Merkmale

Die granulometrischen Merkmale werden als Container über die Referenz ipIntensityDiffs zurückgegeben.

Operator-Typ

Der Typ der morphologischen Operatoren wird über eMorphType als TCVN_MO_OPENING oder als TCVN_MO_CLOSING festgelegt.

Operator-Größe

Die Größe der morphologischen Operatoren wird über das Minimum nMinSize, das Maximum nMaxSize und die Schrittgröße nStep festgelegt. Die Operatoren müssen eine ungerade Größe haben und die Schrittweite muss gerade sein.

Anwendung

Die Berechnung von granulometrischen Merkmalen mit Closing-Operatoren in den Größen von drei, sieben und elf sieht z.B. so aus:

hr := F_VN_Granulometry(
    ipImage             :=  ipImage,
    ipIntensityDiffs    :=  ipIntensityDiffs,
    eMorphType          :=  TCVN_MO_CLOSING,
    nMinSize            :=  3,
    nMaxSize            :=  11,
    nStep               :=  4,
    hrPrev              :=  hr);

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