Inspection API

对活跃原生几何执行常规测量时使用 Shape。需要从 STEP 文件或兼容 Shape 获取结构化证据时，使用 cadflow.inspect.brep。

from cadflow.inspect import brep

summary = brep.inspect_step_rsummary("input/part.step")
inspection = brep.inspect_step_rbrepinspection("input/part.step")

数据模型

类型	作用
BRepModel	索引 Shape 与单次运行内稳定的实体表
BRepInspection	全局属性、拓扑、实体与证据
BRepComparison	两个 Shape 或 STEP 的结构化差异
SliceSpec / SliceComparison	平面截面定义与对比
EntityInspectionParity	实体检查与重建几何的一致性
BRepEntityError	实体引用无效或不可用

加载与索引

load_step_rshape 返回兼容几何；load_step_rbrepmodel 同时创建索引检查模型；index_shape_rbrepmodel 为内存中的 Shape 创建同类模型。STEP Loader 会缓存重复检查使用的模型，可用 clear_step_model_cache_rnone 显式释放。

实体索引只属于一个 Indexed Model。没有执行对比时，不要把索引直接用于重建或修改后的 Shape。

局部检查

公共函数可检查 Point、Entity、Face Boundary、Topology Neighborhood、Nearby Entity、Difference Region 或选定 Region。Section 辅助函数以显式 Plane 与几何相交，返回适合自动对比的 Descriptor。

调查已知差异时优先使用窄查询；完整 Inspection 可能生成更大的数据和渲染输出。

对比

Comparison 函数覆盖 Global Property、Material Evidence、Section、Boundary Distance、完整 Shape、STEP 文件与 Model-to-Inspection Parity。结果记录 Tolerance 和 Evidence；哪些偏差可接受由调用应用决定。

渲染

render_shape_views_rpath、render_step_views_rpath、Entity Map、彩色 Component View 与 Region Renderer 会写入诊断图片。它们是证据产物，不是几何导出。应提供明确输出路径并验证文件。

执行边界

执行外部 I/O 或诊断渲染的 Inspection 函数应放在活动 Model Recording 之外。输入文件按不可信数据处理：由应用限制大小、处理解析错误，并保留来源 Hash 以便追踪。

全部符号见 47 个 Inspection API。