FreeCAD CAM 圆形孔加工改进路线Circular Holes Improvement Epic链接移动、目标排序与固定循环重构全解析【免费下载链接】FreeCADOfficial source code of FreeCAD, a free and opensource multiplatform 3D parametric modeler.项目地址: https://gitcode.com/GitHub_Trending/fr/FreeCAD本文围绕 FreeCAD CAM 工作台路线图中的 Circular Holes Improvement 史诗 展开深入解析其在链接移动linking moves生成、圆形孔目标选择与管理、基类重构、后处理器固定循环canned cycles支持、螺旋/螺纹铣削进给率计算等方面的改进规划并结合 CircularHoleBase.py、Base.py、DrillCycleExpander.py 等源码说明现状实现与演进方向。读者可以借此理解 FreeCAD CAM 中钻孔、螺旋铣削、螺纹铣削等圆形孔操作的整体架构以及社区规划这些改进背后的工程动机。一、史诗背景为什么圆形孔加工是优先事项在 FreeCAD 的 CAM 路线图Roadmap README中Improve Circular Holes被列为Active状态的主动项目。其目标明确写为“改善圆形孔操作的用户体验与效率”Improve the user experience and efficiency of Circular holes operations。该史诗文档状态为PROPOSED从四个层面论证了其优先级链接移动的复杂性在圆形孔目标之间移动linking move比其它操作具有更高的复杂度。解决圆形孔操作中链接移动的缺陷后这套逻辑可以复用到其它操作中。目标选择的泛化价值圆形孔的目标选择处理可以被泛化到其它操作并且与 SanityCAM 操作参数检查功能存在功能重叠。模拟器需要特殊处理圆形孔会生成更复杂的路径命令这些命令需要模拟器simulator特殊处理。后处理器逻辑集中化后处理器post-processor的重构应考虑将圆形孔命令的处理与分解逻辑集中化。从源码结构看这四个方向的判断与现状高度吻合圆形孔操作目前由独立的基类 CircularHoleBase.py 支撑而链接移动配置、后处理固定循环展开等逻辑散落在 Base.py 与 Post 目录中确实存在集中化与复用的空间。二、范围界定做什么与不做什么史诗文档用 In/Out 表格明确划定了边界这是该改进项目控制范围的关键In纳入范围Out明确排除创建链接移动生成器linking move generator新增圆形孔操作类型如铰孔 Bore、扩孔 reaming 等改进目标选择与管理target selection and management改进模拟器以可视化圆形孔加工过程重构圆形孔基类使其使用链接生成器改进基础后处理器使其生成固定循环canned cycles改进螺旋helix与螺纹铣削threadmill的进给率计算在目标列表中添加目标顺序列target order column这一表格传递了两个关键工程信息聚焦存量而非增量本次改进的核心是“重构与通用化”而不是新增功能。铰孔、扩孔等新操作被明确排除在外避免范围蔓延scope creep。模拟器改进被推迟虽然优先级理由中提到圆形孔命令需要模拟器特殊处理但模拟器可视化改进明确不在本史诗范围内说明该项会作为后续独立工作。三、链接移动生成器从“各操作各自实现”到“通用复用”史诗的第一项 In 范围工作是“创建链接移动生成器”。所谓链接移动是指刀具完成一个孔的加工后、移动到下一个孔目标之前的过渡路径——通常包含抬刀retract到安全高度、横向快速移动rapid、再下刀plunge三段。3.1 现状链接配置已存在于操作基类从源码看FreeCAD CAM 的链接移动配置已经具备基础框架。Base.py 中定义了操作特性标志位FeatureLinking 0x0080 # Linking而 CircularHoleBase.py 的opFeatures()方法将FeatureLinking与刀具、深度、高度、冷却液等特性合并返回return ( PathOp.FeatureTool | PathOp.FeatureDepths | PathOp.FeatureHeights | PathOp.FeatureBaseFaces | self.circularHoleFeatures(obj) | PathOp.FeatureCoolant | PathOp.FeatureLinking )当操作特性包含FeatureLinking时addLinking()见 Base.py会为操作对象添加CollisionAvoidanceStrategy与CollisionClearance两个属性属性可选值 / 说明CollisionAvoidanceStrategyClearance Height无碰撞检测按安全间隙高度快速移动、Retract Height无碰撞检测按安全高度快速移动、Line of Sight最快检查路径中心线、Tool Diameter均衡按刀具直径检查间隙、Tool Shape最安全按刀具横截面检查间隙CollisionClearance碰撞检测的距离App::PropertyLength这五种策略从“无检测、纯高度控制”到“按刀具横截面做最安全检测”形成一个安全性与速度的梯度。史诗提出的“链接移动生成器”正是希望将这种配置驱动的链接逻辑抽离为独立生成器供圆形孔乃至其它操作复用避免每个操作各自实现一套孔间移动逻辑。3.2 为什么圆形孔对链接移动最敏感钻孔类操作在孔与孔之间反复执行“抬刀—移动—下刀”循环孔位数量越多、分布越散链接移动占总路径长度的比重越大。若链接策略选择不当例如使用最慢但最安全的Tool Shape策略整个加工时间会显著增加。因此链接移动生成器的设计质量直接影响钻孔循环的加工效率与安全性。四、目标选择与管理改进4.1 现状基于几何特征的目标收集圆形孔操作的“目标”来自几何特征圆形边、圆柱面、顶点与手动Locations列表。opExecute()见 CircularHoleBase.py的流程如下遍历baseShapes(obj)中的每个基体与子元素通过isHoleEnabled()过滤Disabled列表中被禁用的孔通过holePosition()计算每个孔的中心坐标x、yZ 归零通过holeDiameter()计算孔径圆形边取Curve.Radius * 2圆柱面取底部圆形边的直径其它形状退化为包围盒 X 方向长度并给出“因曲面细分导致孔径可能不准”的警告合并位置重复的孔同一位置存在多个孔径时保留较大孔径并自动将较小孔径写入Disabled追加Locations属性中手动指定的坐标点若SortingMode Automatic调用PathUtils.sort_locations_tsp()以旅行商问题TSP算法进行自动排序。4.2 目标排序的现状实现initOperation()为圆形孔操作注册了排序相关属性见 CircularHoleBase.py属性类型说明SortingMode枚举Automatic默认或Manual控制孔加工顺序StartPoint向量自动排序起点仅使用 x、y忽略 zUseEndPoint布尔是否使用终点约束自动排序EndPoint向量自动排序终点仅使用 x、y从代码注释看TSP 排序使用了 C 实现以提升性能“Use the c implementation of the TSP sorting algorithm for better performance”。此外onDocumentRestored()中还包含SortingMode、StartPoint、UseEndPoint、EndPoint的旧文档迁移逻辑说明这些属性是逐步演进加入的。4.3 史诗的改进点目标顺序列与通用化史诗规划的改进有两处增加目标顺序列在目标列表中新增“target order column”让用户在界面上直观看到并可手动调整每个孔的执行顺序弥补当前仅靠 TSP 自动排序、缺少人工干预入口的不足。目标选择逻辑泛化将目标选择/管理与 Sanity操作参数检查中重叠的功能统一使其能被其它操作复用。从源码看Base.py 的opFeatures/addBaseProperty机制已经具备“特性驱动属性注入”的通用框架泛化的落点很可能是将圆形孔的Drillable.getDrillableTargets()目标发现能力见findAllHoles()提升为通用 CAM 能力。五、圆形孔基类重构接入链接生成器史诗要求“重构圆形孔基类以使用链接生成器”。当前的基类结构是CircularHoleBase.py 定义ObjectOp作为所有圆形孔操作代理对象的基类提供opFeatures、initOperation、opExecute、holePosition、holeDiameter、findAllHoles、onDocumentRestored等通用能力子类只需实现两个钩子方法circularHoleFeatures(obj)返回操作特有的特性标志与circularHoleExecute(obj, holes)真正生成孔加工路径以及可选的initCircularHoleOperation(obj)。这一“模板方法”设计已经在源码注释中明确强调“Do not overwrite, implement circularHoleFeatures(obj) instead”、“Do not overwrite, implement circularHoleExecute(obj, holes) instead”。在此基础上重构方向是把当前嵌入在路径生成流程中的链接逻辑孔间抬刀、快速移动、下刀抽离成独立的链接生成器组件让基类通过组合方式调用。这样做的收益有三点圆形孔操作钻孔、螺旋、螺纹铣削等共享同一套经过优化的链接策略其它非圆形孔操作也能接入该生成器链接策略的单元测试可以脱离具体操作独立编写。六、后处理器固定循环Canned Cycles的生成与分解6.1 现状循环展开器已存在史诗的 In 范围包含“改进基础后处理器以生成固定循环”。固定循环如 G81/G82/G73/G83 钻孔循环可以大幅压缩 G 代码长度是数控加工中的标准做法。当前仓库已具备固定循环的“展开expand”能力DrillCycleExpander.py 提供了将Path.Command形式的钻孔循环展开为基本 G 代码移动的独立 API核心方法包括expand_command(command, strictFalse)展开单个钻孔循环命令_expand_drill_cycle()按参数完整性检查展开前置条件require_previous即展开循环需要此前命令已建立相关参数_expand_g81_g82()与_expand_g73_g83()分别处理不同循环类型的展开expand_commands(commands)与expand_path(path)批量/整路径展开。也就是说当前实现更偏向“把循环展开为基本移动”供模拟器或简化后处理使用而史诗要求的“生成固定循环”是相反方向——在基础后处理器如 LinuxCNC、GRBL 等中直接输出 G81/G83 等循环指令以缩短代码并提升机床执行效率。这与后处理器集中化处理/分解圆形孔命令的目标相辅相成。6.2 集中化处理圆形孔命令优先级理由第 4 条指出“后处理器重构应考虑集中化处理与分解圆形孔命令”。从 Post 目录结构看后处理框架已包含 Processor.py、Command.py、GcodeProcessingUtils.py 等基础设施将圆形孔命令的识别、循环生成、参数映射集中到统一模块可以避免每个后处理器重复实现钻孔循环逻辑也便于维护 G 代码方言差异。七、进给率计算改进螺旋与螺纹铣削史诗还明确将“改进螺旋helix和螺纹铣削threadmill的进给率计算”纳入范围。Helix.py 是圆形孔操作族的典型成员其ObjectHelix继承自PathCircularHoleBase.ObjectOp并实现了circularHoleFeatures、initCircularHoleOperation创建螺旋专属属性等钩子。从源码结构看螺旋加工同时存在两个方向的运动——绕孔中心的圆周进给与沿 Z 轴的下降进给其合成进给率必须同时考虑圆周速度与轴向螺距螺纹铣削则还需要匹配螺纹导程pitch。这正是进给率计算比其他铣削操作复杂、值得专项改进的原因。当前仓库中FeedsAndSpeeds.mdEpics/FeedsAndSpeeds.md是另一条相关史诗两者的进给率改进可能存在协同。八、相关史诗与 Helix Work 的联动史诗文档在末尾列出了唯一一条相关史诗Helix Work。这印证了前文的判断——螺旋加工既是圆形孔操作族中最依赖进给率计算的成员其路径生成逻辑又与链接移动、目标排序深度耦合。Helix Work 与 Circular Holes Improvement 两个项目需要协同推进避免接口与行为在重构期间发生冲突。从路线图首页Roadmap README的优先级表格可以看出 FreeCAD CAM 社区的评审导向回归 bug 修复 本类倡议项目相关变更 其它 bug 修复 其它新功能。这意味着如果读者希望参与本史诗提交与链接移动、目标排序、固定循环、进给率相关的补丁会获得更高的评审优先级而范围外的新功能例如新增铰孔操作将受到更严格的审视。九、参与方式与验证路径该史诗是 FreeCAD 社区协作项目任何开发者都可以通过 Pull Request 参与。参与前建议先熟悉以下关键文件它们既是本史诗的直接改造对象也是验证重构行为是否回归的基准CircularHoleBase.py圆形孔操作基类目标收集、排序、直径/位置计算Base.py操作特性标志与链接属性注入FeatureLinking、addLinkingHelix.py、Drilling.py、ThreadMilling.py具体的圆形孔操作实现DrillCycleExpander.py钻孔循环展开的现有实现是固定循环生成重构的参考PathUtils.pysort_locations_tsp等工具函数测试目录 CAMTests 与 tests/src用于验证路径生成与后处理输出的回归测试。十、小结Circular Holes Improvement 史诗的核心工程思想可以概括为四个字通用化重构。它不是要新增钻孔功能而是把圆形孔操作中已经存在但散落各处的优质逻辑——链接移动、目标选择与排序、固定循环处理、进给率计算——抽离、集中、复用并补齐目标顺序列等人机交互短板。从仓库源码看这一重构的基础设施特性驱动的属性注入、模板方法基类、循环展开器、TSP 排序均已就位史诗的价值在于将这些能力提升为整个 CAM 工作台共享的通用组件。【免费下载链接】FreeCADOfficial source code of FreeCAD, a free and opensource multiplatform 3D parametric modeler.项目地址: https://gitcode.com/GitHub_Trending/fr/FreeCAD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考