测量
圆拟合
用最小二乘或 Huber、Tukey 稳健加权对离散点集拟合圆，输出圆心、半径、拟合误差与可直接作 ROI 的圆CircleFitter · v1.0 · by system
输入参数 5
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 点集 | points | vec_double | [] | 是 | 待拟合的离散点坐标序列，按 [x0,y0,x1,y1,...] 成对排列；长度须为偶数，点数少于 3 个或类型不符时返回失败 |
| 拟合方法 | fitMethod | enum | 0 | 否 | 圆拟合采用的加权策略，可选最小二乘、Huber 或 Tukey；决定如何按残差调整各点权重，各选项含义见释义 |
| 剔除比例 | removeRatio | double | 0 | 否 | 按残差从大到小剔除离群点的比例，取值被限制在 0~0.9；设为 0 时不按比例剔除，比例越大保留的点越少 |
| 剔除距离 | removeDist | double | 3 | 否 | 最小二乘模式下判定离群点的残差门槛，以残差分布标准差的倍数计；残差超过该倍数乘标准差的点被剔除，非正数时不启用 |
| 迭代次数 | iterations | int | 10 | 否 | Huber 与 Tukey 稳健拟合中加权与重拟合的轮数，至少取 1；最小二乘方法只做一次剔除，不随该值迭代 |
输出参数 7
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=拟合成功并输出圆心与半径；-1=缺少点集、点集类型或长度不合法、点数不足 3 个，此时不产出拟合结果 |
| 运行信息 | resultInfo | string | — | 否 | 成功时固定为 Success；失败时给出具体原因，如缺少点集输入、点集类型不匹配或至少需要 3 个点 |
| 中心X | centerX | double | — | 否 | 拟合圆的圆心 X 坐标，采用与输入点集一致的图像坐标系；与中心 Y、半径同属一次拟合结果 |
| 中心Y | centerY | double | — | 否 | 拟合圆的圆心 Y 坐标，采用与输入点集一致的图像坐标系，与中心 X 对应同一次拟合 |
| 半径 | radius | double | — | 否 | 拟合圆的半径，量纲与输入坐标一致；点集近似共线等退化情形下改用质心到各点的平均距离 |
| 拟合误差 | fitError | double | — | 否 | 参与拟合的各点到拟合圆周距离的均方根误差，量纲同坐标；数值越小表示点与圆越贴合，无有效点时记 0 |
| 拟合圆 | roiCircleOut | roi | — | 否 | 拟合出的圆按 [1,cx,cy,r] 格式输出，可直接作为其他工具的圆形 ROI 输入；半径为 0 时不输出该项 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈