Extract Ellipse

## Extract Ellipse

Find points that meet the gradient response value, then use the RANSAC algorithm to fit an ellipse.

## Parameter Configuration Description

### Main Interface Parameters
![](/media/202602/2026-02-13_162916_1241500.14189901035436547.png)

**[Gradient Threshold]** The grayscale gradient of the edge position along the scanning direction; points greater than this threshold are retained.
*   For clear images with obvious edges: Set a higher value (>40).
*   For blurry images or indistinct edges: Set a lower value (10-30).
![](/media/202601/tidu_1769763100.png)

**[Ellipse Scanning Direction]** Scan from inside out or from outside in, indicated by the arrow on the ROI.

**[Polarity]**:
*   **Black to White:** Along the ROI arrow, pointing from a low grayscale area to a high grayscale area.
*   **White to Black:** Along the ROI arrow, pointing from a high grayscale area to a low grayscale area.
*   **All:** Can detect both black-to-white and white-to-black transitions.

**[Fitting Point Selection]**:
*   **All Points:** Use all detected edge points.
*   **Strongest Point:** Use the edge point with the maximum gradient value encountered along the scanning direction.
*   **First Row Points:** Use the first edge point encountered along the scanning direction.
*   **Last Row Points:** Use the last edge point encountered along the scanning direction.

**[Ellipse Filtering]**:
*   **Optimal Fit:** Comprehensively considers the best-fitted ellipse.
*   **Most Fitting Points:** The ellipse with the highest number of qualifying fitting points among all fitted ellipses.
*   **Strongest Fit:** The ellipse with the strongest gradient values for its fitting points among all fitted ellipses.
*   **First Ellipse:** The first ellipse fitted along the scanning direction.
*   **Last Ellipse:** The last ellipse fitted along the scanning direction.
*   **Specified ID Ellipse:** Filters out the ellipse with the specified ID along the scanning direction.

### Advanced Parameters
![](/media/202601//1767690915.1024215.png)

**Filtering Parameters:**

**[Gaussian Filter Threshold]** The σ in the Gaussian function, which can be understood as half the width of the transition region pixels. (A larger value reduces noise impact but blurs edges; a smaller value retains more detail but increases noise impact.)
![](/media/202602/滤波阈值_1770111631.png)

**[Sampling Points Count]** The number of uniform divisions of the ROI along the 360° direction.

**[Sampling Point Width]** Based on the center points divided evenly by the sampling points count, take the sampling point width to form small rectangular regions. Calculate and judge along the scanning direction within these small rectangular regions to check for qualifying edge points.

**[Fitting Points Count]** The minimum number of fitting points required for ellipse fitting. If the count is less than this value, the fitting is considered failed.

**[Distance Threshold]** Edge response points whose distance to the fitted ellipse is less than this value are considered fitting points (also known as inliers).

**[Maximum Iterations]** The maximum number of iterations required. If an ellipse meeting the conditions is fitted early, the fitting process can stop prematurely.

**[Iterations Without Improvement]** Stop iteration if the ellipse fitting effect does not continue to improve during the fitting process.

**[Score Threshold]** The final score used to judge the ellipse. If the score is less than this threshold, the fitting is considered failed. The range is 0-1. When all fitting points lie exactly on the fitted ellipse, the score is 1.

**Other Parameters:**

**[Size Conversion]** Two options: Scale and Calibration, used to calculate the lengths of the ellipse's semi-major and semi-minor axes.
*   If **Calibration** is selected, an additional port will be added to import the calibration file.
*   If **Scale** is selected, enter the scale value in the subsequent box.

**[Major Radius Compensation]** Used to compensate for the major radius of the fitted ellipse.

**[Minor Radius Compensation]** Used to compensate for the minor radius of the fitted ellipse.

**[Major Radius Filtering]** When this judgment condition is enabled, if the major radius length of the fitted ellipse is not within the specified range, the fitting is considered failed.

**[Minor Radius Filtering]** When this judgment condition is enabled, if the minor radius length of the fitted ellipse is not within the specified range, the fitting is considered failed.

### ROI Settings
![](/media/202601//1767690915.3532205.png)

**[ROI Type]** The default ROI type for the detection area is an Elliptical Ring.

**[ROI Source]**
*   **Manual ROI:** Allows manual dragging of the ROI position and size in the window.
*   **Referenced ROI:** Allows connecting to an external ROI via a port.

**[Position Correction]** Selecting pose correction allows connection to a coordinate system, enabling the ROI area to move with the coordinate system. (Can connect to coordinate systems from Blob and Mask).

**[Position Adjustment]** Adjust the position and size of the ROI.

## Output Description
*   **Run Result:** Outputs `True` if successful; outputs `False` if failed.
*   **Fitting Error:** The average error of the edge points used for ellipse fitting relative to the ellipse.
*   **Fitting Count:** The number of edge points used for ellipse fitting.
*   **Ellipse Major Radius:** The major radius of the detected ellipse.
*   **Ellipse Minor Radius:** The minor radius of the detected ellipse.
*   **Ellipse Angle:** The angle of the detected ellipse.
*   **Ellipse Center Output:** The center point of the detected ellipse.
*   **Ellipse Output:** The detected ellipse.
*   **Elliptical Ring ROI:** The ROI used for detection.
*   **Fitting Points Array:** The set of edge points used for arc fitting.
![](/media/202602/2026-02-13_163350_1017110.980254147479891.png)

---

Click here to jump to the corresponding Chinese manual page: [Extract Ellipse](/doc/88)