F_VN_Granulometry

F_VN_Granulometry 1:

Computes the granulometry of a textured image using morphological operations.

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

F_VN_Granulometry 2: 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.)

F_VN_Granulometry 3: 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);

Verwandte Funktionen

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