Morphology

_CleanBinary, _CloseBinary, _ConnectEndings, _Contour, _CutBranches, _DetectBranching, _DetectEnding, _DilateBinary, _ErodeBinary, _FillHoles, _OpenBinary, _VanishObjects, CloseBinary, CloseBinaryND, ConnectEndings, Contour, ContourND, CutBranches, DetectBranching, DetectBranchingND, DetectEnding, DetectEndingND, DilateBinary, DilateBinaryND, ErodeBinary, ErodeBinaryND, FillHoles, FillHolesND, OpenBinary, OpenBinaryND, VanishObjects

CloseBinary

Interactive command to this function: Binary > Close

Description 

 CloseBinary(
   int  Count,
   int  MatrixType
);

This function transforms current binary image by morphological closing. An interactive equivalent is the _CloseBinary function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

Note

Morphological closing is a dilation followed by an erosion of the same amount. This transformation is used for a binary image filtration. Small holes are filled and closely neighboring objects are connected.

CloseBinaryND

Description 

 CloseBinaryND(
   int  Count,
   int  MatrixType,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function transforms binary layers of the current ND document by morphological closing.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

Note

Morphological closing is a dilation followed by an erosion of the same amount. This transformation is used for a binary image filtration. Small holes are filled and closely neighboring objects are connected.

ConnectEndings

Description 

 ConnectEndings(
   int  ConnectEndingsEnergy,
   int  UseGaborInstead,
   int  NDDimension
);

This function connects branch-endings on a skeletonized image.

Parameters

int ConnectEndingsEnergy

Sensitivity of the function. <1,200> A relative value which determines how many connections will be created.

int UseGaborInstead

0

Leave the image as is and evaluate edge strength.

1

Apply Gabor edge detection to the image before evaluating the edge strength.

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Contour

Interactive command to this function: Binary > Contour

Description 

 Contour();

This function transforms the binary image to its contour.

Note

The binary image is transformed to its contour. It is the inner contour e.g. the binary image after transformation is a subset of the original image.

See Also 
ContourND, _Contour, FillHoles, FillHolesND, _FillHoles, CloseHolesBinary, CloseHolesBinaryND, _CloseHolesBinary, _Contour

ContourND

Description 

 ContourND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function transforms the binary image to its contour.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

Note

The binary image is transformed to its contour. It is the inner contour e.g. the binary image after transformation is a subset of the original image.

See Also 
Contour, _Contour, FillHoles, FillHolesND, _FillHoles, CloseHolesBinary, CloseHolesBinaryND, _CloseHolesBinary, _Contour

CutBranches

Description 

 CutBranches(
   int  CutBranchesLength,
   int  NDDimension
);

On a skeletonized binary image, branches (free endings) shorter than the defined length will be removed.

Parameters

int CutBranchesLength

Branch length limit [px].

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

DetectBranching

Description 

 DetectBranching();

Creates 1pixel seeds out of a skeletonized binary image which mark positions of the branching points.

DetectBranchingND

Description 

 DetectBranchingND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

Runs the DetectBranching function on an ND image.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

DetectEnding

Description 

 DetectEnding();

Creates 1pixel seeds out of a skeletonized binary image which mark positions of line-endings.

DetectEndingND

Description 

 DetectEndingND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

Applies the DetectEnding function to an ND image.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

DilateBinary

Interactive command to this function: Binary > Dilate

Description 

 DilateBinary(
   int  Count,
   int  MatrixType
);

This function performs morphologic dilation on a binary image. An interactive equivalent is the _DilateBinary function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

DilateBinaryND

Description 

 DilateBinaryND(
   int  Count,
   int  MatrixType,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function performs morphologic dilation on binary images of the current ND document.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

ErodeBinary

Interactive command to this function: Binary > Erode

Description 

 ErodeBinary(
   int  Count,
   int  MatrixType
);

This function transforms current binary image by morphological erosions. An interactive equivalent is the _ErodeBinary function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

ErodeBinaryND

Description 

 ErodeBinaryND(
   int  Count,
   int  MatrixType,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function transforms binary images of the current ND document by morphological erosions.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

FillHoles

Interactive command to this function: Binary > Fill Holes

Description 

 FillHoles();

This function fills holes in the binary image.

See Also 
FillHolesND, _FillHoles, CloseHolesBinary, CloseHolesBinaryND, _CloseHolesBinary, Contour, ContourND, _Contour, _FillHoles

FillHolesND

Description 

 FillHolesND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function fills holes in the binary image.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

See Also 
FillHoles, _FillHoles, CloseHolesBinary, CloseHolesBinaryND, _FillHoles

OpenBinary

Interactive command to this function: Binary > Open

Description 

 OpenBinary(
   int  Count,
   int  MatrixType
);

This function transforms current binary image by morphological opening. An interactive equivalent is the _OpenBinary function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

Note

Morphological opening is erosion followed by a dilation by the same amount. It removes small objects and fine structures from the binary image while larger structures are not significantly affected.

OpenBinaryND

Description 

 OpenBinaryND(
   int  Count,
   int  MatrixType,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function transforms binary images of the current ND document by morphological opening.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

Note

Morphological opening is erosion followed by a dilation by the same amount. It removes small objects and fine structures from the binary image while larger structures are not significantly affected.

VanishObjects

Description 

 VanishObjects(
   int  VanishObjectsEquiDia,
   int  UseGaborInstead,
   int  VN_MaxMeanInt,
   int  NDDimension
);

On a skeletonized image, circular (enclosed) objects with equivalent diameter (VanishObjectsEquiDia) smaller than the defined value will be deleted. Concurrently objects with their border stronger than the defined value (VN_MaxMeanInt) will be kept.

Parameters

int VanishObjectsEquiDia

Equivalent diameter of a circular object. Objects with a smaller than the defined value will be deleted.

int UseGaborInstead

0

Leave the image as is and evaluate edge strength.

1

Apply Gabor edge detection to the image before evaluating the edge strength.

int VN_MaxMeanInt

Threshold value for deletion.

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

_CleanBinary

This function runs the Binary > Clean command.

Description 

 _CleanBinary();

The function displays the Clean on Binary Image dialog box.

See Also 
CleanBinary, CleanBinaryND, SmoothBinary, SmoothBinaryND, _SmoothBinary

_CloseBinary

This function runs the Binary > Close command.

Description 

 _CloseBinary();

This function displays the Close on Binary Image dialog box.

_ConnectEndings

Description 

 _ConnectEndings();

Connects branch peaks on a skeletonized image.

_Contour

This function runs the Binary > Contour command.

Description 

 _Contour();

This function equals the Contour function except when performed on ND2 document you will be prompt to select whether to process the current image, selected dimension, or the whole ND document.

Note

The binary image is transformed to its contour. It is the inner contour e.g. the binary image after transformation is a subset of the original image.

See Also 
ContourND, FillHoles, FillHolesND, _FillHoles, CloseHolesBinary, CloseHolesBinaryND, _CloseHolesBinary

_CutBranches

Description 

 _CutBranches();

Removes branches (free endings) shorter than the defined length on a skeletonized binary image.

_DetectBranching

Description 

 _DetectBranching();

Creates 1pixel seeds out of a skeletonized binary image which mark branching points. A dialog window appears if the current document is of ND type.

_DetectEnding

Description 

 _DetectEnding();

Creates 1pixel seeds out of a skeletonized binary image which mark positions of the binary line-endings. A dialog window appears if the current document is of ND type.

_DilateBinary

This function runs the Binary > Dilate command.

Description 

 _DilateBinary();

This function displays the Dilate on Binary Image dialog box.

_ErodeBinary

This function runs the Binary > Erode command.

Description 

 _ErodeBinary();

This function displays the Erode on Binary Image dialog box.

_FillHoles

This function runs the Binary > Fill Holes command.

Description 

 _FillHoles();

This function equals the FillHoles function except when performed on ND2 document you will be prompt to select whether to process the current image, selected dimension, or the whole ND document.

See Also 
FillHoles, FillHolesND, CloseHolesBinary, CloseHolesBinaryND, _CloseHolesBinary, Contour, ContourND, _Contour

_OpenBinary

This function runs the Binary > Open command.

Description 

 _OpenBinary();

This function displays Open binary Image dialog box.

_VanishObjects

Description 

 _VanishObjects();

Opens the Vanish Objects dialog window.