Line-Line Caliper

## Line-Line Caliper

Find edge points that meet the gradient response value, use the RANSAC algorithm to fit two straight lines, and calculate the distance between them.

## Parameter Configuration Description

### Main Interface Parameters
![](/media/202602/2026-02-11_110838_4011150.7547040388424769.png)

**[Line Settings]**
*   **Line 1:** Select to configure parameters for Line 1.
*   **Line 2:** Select to configure parameters for Line 2.

**[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_1769762616.png)

**[Line Scanning Direction]** Scan from top to bottom or from bottom to top, indicated by the arrow on the ROI.

**[Line Polarity]**:
*   **Black to White:** Along the rectangular arrow, pointing from a low grayscale area to a high grayscale area.
*   **White to Black:** Along the rectangular arrow, pointing from a high grayscale area to a low grayscale area.
*   **All:** Can detect both black-to-white and white-to-black transitions.
![](/media/202601/jixing_1769766940.png)

**[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.
![](/media/202602/拟合点选择_1770083578.png)

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

### Advanced Parameters
![](/media/202602/2026-02-11_110939_0167280.24950672875106517.png)

**Filtering Parameters:**

**[Synchronize Line 1 and 2 Modifications]** When checked, modifying the parameters for either line will automatically update the parameters for the other line.

**[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)

**[Angle Range Relative to ROI]** The allowable deviation angle for the fitted line relative to the ROI. As shown in the figure below, if the "Angle Range Relative to ROI" is set to 16, and the difference between the Line Angle and ROI Angle is 9 (which is within 16), the line is considered valid.
![](/media/202602/与 ROI 角度_1770110521.png)

**[Sampling Points Count]** The number of uniform divisions perpendicular to the ROI scanning line direction.
![](/media/202602/采样点数_1770016300.png)

**[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.
![](/media/202602/采样点宽度_1770017004.png)

**[Fitting Points Count]** The minimum number of fitting points required for line fitting. If the count is less than this value, the fitting is considered failed. As shown in the figure below, with the fitting points count set to 5, there are a total of 6 points marked by white circles.
![](/media/202602/最少拟合点数_1770111223.png)

**[Distance Threshold]** Edge points whose perpendicular distance to the fitted line is less than this value will be used for line fitting. As shown in the figure below, detected edge points with a distance to the line less than the distance threshold are displayed in blue, while those greater than the threshold are displayed in red.
![](/media/202602/距离阈值_1770630645.png)

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

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

**[Score Threshold]** The final score used to judge the line. If the score is less than this threshold, the fitting is considered failed. The range is 0-1. The score is calculated by summing the perpendicular distances from all edge points to the fitted line; the smaller the sum, the higher the score. When all fitting points lie exactly on the fitted line, the score is 1.

**Distance Parameters:**

**[Standard Value]** The theoretical target value.

**[Offset Value]** A calibration amount to correct for fixed system errors or process deviations.

**[Lower Deviation]** The maximum allowable amount below the standard value.

**[Upper Deviation]** The maximum allowable amount above the standard value.
*   **Formula:** `Measured Value + Offset Value` must be within `[Standard Value + Lower Deviation, Standard Value + Upper Deviation]`.

**[Size Conversion]**
*   **Disable:** No size conversion is performed.
*   **Scale:** Manually enter a value to convert image coordinates to real-world coordinates.
*   **Calibration:** Connect to calibration data to convert image coordinates to real-world coordinates.

### ROI Settings
![](/media/202602/2026-02-11_112623_9470530.7222533323260001.png)

**[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.

**[ROI Count]** Options for one or two ROIs:
*   **One ROI:** When extracting two lines, they share the same ROI.
*   **Two ROIs:** Each ROI corresponds to the extraction of one specific line.

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

## Output Description
*   **Run Result:** Outputs `True` if successful; outputs `False` if failed.
*   **Distance:** The measured distance between the two detected lines.
*   **Distance Segment:** The line segment representing the perpendicular distance between the two lines.
*   **Distance Segment Midpoint:** The midpoint of the perpendicular distance segment between the two lines.
*   **Extracted Line 1:** The detected Line 1.
*   **Extracted Line 2:** The detected Line 2.
*   **Skewed Rectangle ROI 1:** The ROI used for detecting Line 1.
*   **Skewed Rectangle ROI 2:** The ROI used for detecting Line 2.
![](/media/202602/2026-02-11_112930_7305930.737260548936928.png)

---

Click here to jump to the corresponding Chinese manual page: [Line-Line Caliper](/doc/95)