cvHoughCircles¶

MLModule¶

author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`MLOpenCVModules`
definition	MLOpenCVModules.def

Purpose¶

The cvHoughCircles performs the OpenCV 2D “Hough circles” algorithm.

It detects circles on each 2D slice of the given volume and generates markers with the centers and radii of the detected circles. The radius is stored in the direction component of the vector, orthogonal to the 2D slice. The markers are stored in world coordinates. A good way to visualize the markers is to use a SoView2DMarkerEditor with drawMode set to Disc, as shown in the example module.

Internally, the module only supports the uint8 data type; all input data is rescaled to the range 0-255.

Windows¶

Default Panel¶

../../../Modules/ML/MLOpenCVModules/mhelp/Images/Screenshots/cvHoughCircles._default.png

Input Fields¶

input0¶

name: input0, type: Image¶

Output Fields¶

outCircles¶

name: outCircles, type: XMarkerList(MLBase)¶: For accessing this object via scripting, see the Scripting Reference: MLXMarkerListWrapper.

Parameter Fields¶

Field Index¶

Accumulator Ratio: Double

Accumulator Threshold: Double

Apply: Trigger

Canny Threshold: Double

Max Radius: Integer

Min Distance: Double

Min Radius: Integer

Visible Fields¶

Min Distance¶

name: minDistance, type: Double, default: 10¶: Sets the minimum distance between detected circle centers.

Min Radius¶

name: minRadius, type: Integer, default: 0¶: Sets the minimum radius of detected circles.

Max Radius¶

name: maxRadius, type: Integer, default: 0¶

Sets the maximum radius of detected circles.

A value of 0 means the maximum radius is not limited.

Canny Threshold¶

name: cannyThreshold, type: Double, default: 100¶: Sets the threshold for the canny edge detection (in rescaled 8-bit range).

Accumulator Ratio¶

name: accumulatorRatio, type: Double, default: 1¶

Sets the resolution of the accumulator.

A value of 0.5 means the accumulator has half the resolution of the image.

Accumulator Threshold¶

name: accumulatorThreshold, type: Double, default: 100¶

Sets the accumulator threshold for detecting a circle.

The smaller the value, the more false circles may be detected. Circles corresponding to larger accumulator values will be returned first.

Apply¶

name: apply, type: Trigger¶: When pressed, circle detection is applied.