CreoOtkPluging/shell-analysis-enhancement-doc.md

Shell Analysis API Enhancement Documentation

项目背景

MFC Creo DLL 的薄壳分析接口通过OTK几何API实现真正的边界检测算法，将准确率从40%提升到75%+。

核心OTK API发现

1. 干涉检测 API

#include <pfcInterference.h>
#include <pfcSelect.h>

// 全局干涉分析
pfcGlobalEvaluator_ptr global = pfcCreateGlobalEvaluator(assembly);
pfcGlobalInterferences_ptr results = global->ComputeGlobalInterference();

// 选择集创建与距离计算
pfcSelection_ptr sel = pfcCreateModelItemSelection(item, path);
pfcSelectionPair_ptr pair = pfcSelectionPair::Create(sel1, sel2);
pfcSelectionEvaluator_ptr eval = pfcCreateSelectionEvaluator(pair);

// 干涉和距离分析
pfcClearanceData_ptr clear = eval->ComputeClearance();
double distance = clear->GetDistance();
bool interfering = clear->GetIsInterfering();

pfcInterferenceVolume_ptr vol = eval->ComputeInterference(true);
double interference = vol->ComputeVolume();

2. 质量属性 API

#include <pfcSolid.h>

pfcMassProperty_ptr mass = solid->GetMassProperty();
double volume = mass->GetVolume();
double area = mass->GetSurfaceArea();
pfcPoint3D_ptr center = mass->GetGravityCenter();
double density = mass->GetDensity();

3. 表面边界检测 API

#include <pfcGeometry.h>

// 关键API：表面可见性
bool visible = surface->GetIsVisible();  // true=外表面

// 表面分析
pfcOutline3D_ptr bbox = surface->GetXYZExtents();
pfcContours_ptr contours = surface->ListContours();
double area = surface->EvalArea();

// 轮廓判断
bool external = !contour->GetInternalTraversal();

// 边界边检测
pfcEdges_ptr edges = contour->ListElements();
bool is_boundary = (edge->GetSurface2() == nullptr);

核心算法实现

1. 表面边界检测

bool IsSurfaceOnBoundary(pfcSurface_ptr surface) {
    if (!surface->GetIsVisible()) return false;

    pfcContours_ptr contours = surface->ListContours();
    for (int i = 0; i < contours->getarraysize(); i++) {
        if (!contours->get(i)->GetInternalTraversal()) {
            return true;  // 发现外轮廓
        }
    }
    return false;
}

2. 干涉遮挡分析

bool IsOccluded(pfcSolid_ptr target, pfcSolid_ptr occluder) {
    pfcSelection_ptr s1 = pfcCreateModelItemSelection(target, nullptr);
    pfcSelection_ptr s2 = pfcCreateModelItemSelection(occluder, nullptr);
    pfcSelectionEvaluator_ptr eval = pfcCreateSelectionEvaluator(
        pfcSelectionPair::Create(s1, s2));

    pfcInterferenceVolume_ptr inter = eval->ComputeInterference(true);
    if (inter) {
        double ratio = inter->ComputeVolume() /
                      target->GetMassProperty()->GetVolume();
        return ratio > 0.3;  // 30%遮挡阈值
    }
    return false;
}

3. 集成到现有代码

// 替换 CreoManager.cpp 中的函数
bool AnalyzeFeatureGeometryEnhanced(pfcFeature_ptr feature, pfcSolid_ptr solid) {
    pfcModelItems_ptr surfaces = solid->ListItems(pfcITEM_SURFACE);

    for (int i = 0; i < surfaces->getarraysize(); i++) {
        pfcSurface_ptr surf = pfcSurface::cast(surfaces->get(i));
        if (surf && surf->GetFeature() == feature) {
            if (IsSurfaceOnBoundary(surf)) return true;
        }
    }
    return false;
}

API 类型修正

错误用法	正确用法
pfcGeomItems_ptr	pfcModelItems_ptr
pfcBoundingBox_ptr	pfcOutline3D_ptr
surface->GetBoundingBox()	surface->GetXYZExtents()
pfcTransform3D::create()	pfcTransform3D::Create()

其他有用API

// 表面高级分析
pfcSurfaceType type = surface->GetSurfaceType();
pfcPoint3D_ptr closest = surface->EvalClosestPoint(point);
pfcCurvatureData_ptr curve = surface->EvalPrincipalCurv(uv);

// 轮廓分析
double area = contour->EvalArea();
pfcContour_ptr parent = contour->FindContainingContour();

// 坐标变换
pfcTransform3D_ptr tf = pfcTransform3D::Create();
pfcPoint3D_ptr new_pt = tf->TransformPoint(point);

集成步骤

1. 添加必需头文件：pfcInterference.h, pfcSelect.h, pfcGeometry.h, pfcSolid.h
2. 替换 AnalyzeFeatureGeometry 为增强版本
3. 更新 IsComponentOccludedByOthers 使用真实干涉检测
4. 增强 CalculateFeatureVolumeImpact 使用质量属性

预期效果

• 准确率: 40% → 75%+
• 核心改进: 从启发式规则转向真实几何分析
• 工业可用: 满足实际工程精度要求

---

高级OTK API发现 (2025-01-18)

1. 高精度干涉检测API

基于OTK文档调研发现的新API，可显著提升装配体分析准确性：

#include <pfcInterference.h>

// 全局干涉分析器
pfcGlobalEvaluator_ptr CreateGlobalEvaluator(pfcModel_ptr assembly);
pfcGlobalInterferences_ptr ComputeGlobalInterference();

// 选择集评估器
pfcSelectionEvaluator_ptr CreateSelectionEvaluator(pfcSelectionPair_ptr pair);
pfcClearanceData_ptr ComputeClearance();        // 间隙分析
pfcInterferenceVolume_ptr ComputeInterference(true); // 干涉体积
double ComputeVolume();                         // 精确体积计算

// 间隙数据分析
double GetDistance();                           // 最短距离
bool GetIsInterfering();                        // 是否干涉
pfcPoint3Ds_ptr GetNearestPoints();            // 最近点对

2. WFC扩展体积分析API

WebToolkit for Creo提供的高级体积分析功能：

#include <wfcPart.h>
#include <wfcSolid.h>

// 连通体积分析
wfcVolumeInfo_ptr GetVolumeInfo();              // 多连通体积信息
wfcBoundingSurfaceInfo_ptr GetSurfaceIds();     // 边界表面ID列表
wfcVolumeSurfaceInfo_ptr GetSurfaceInfos();     // 体积表面详细信息

// 表面网格化分析
wfcSurfaceTessellationData_ptr GetSurface();    // 表面细分数据
wfcEdgeVertexData_ptr GetSurfaces();           // 边邻接表面信息

3. 表面几何增强API

更精确的表面边界和法向量分析：

#include <pfcGeometry.h>

// 表面法向量与曲率
pfcSurfXYZData_ptr Eval3DData(pfcUVParam_ptr uv);
pfcVector3D_ptr GetNormal();                    // 表面法向量
pfcCurvatureData_ptr EvalPrincipalCurv(pfcUVParam_ptr uv);

// 边界几何分析
pfcEdges_ptr ListElements();                    // 轮廓边列表
pfcVector3D_ptr GetDirection(pfcSurface_ptr surf); // 边方向
pfcOutline3D_ptr GetExtents();                  // 几何范围

开发路线图

Phase 2: 干涉检测API集成 (目标: 75% → 85%)

目标: 将真实干涉检测集成到装配体分析中

2.1 新增函数

// CreoManager.h 新增声明
bool IsComponentOccludedAdvanced(pfcSolid_ptr component, pfcSolid_ptr assembly);
double CalculateInterferenceRatio(pfcSolid_ptr target, pfcSolid_ptr occluder);
pfcGlobalInterferences_ptr AnalyzeGlobalInterferences(pfcModel_ptr assembly);

2.2 算法升级

• 精确遮挡检测: 使用ComputeInterference()替代几何推断
• 体积比例分析: 通过ComputeVolume()量化遮挡程度
• 全局干涉分析: 使用ComputeGlobalInterference()批量检测

Phase 3: 体积分析API增强 (目标: 装配体分析优化)

目标: 集成WFC高级体积分析API

3.1 连通体积分析

// 新增高级体积分析函数
wfcVolumeInfo_ptr GetVolumeInfoEnhanced(wfcWPart_ptr part);
std::vector<int> GetBoundingSurfaceIds(wfcVolumeInfo_ptr info);
double CalculateVolumeImpactAdvanced(pfcFeature_ptr feature, wfcVolumeInfo_ptr info);

3.2 表面边界优化

• 表面ID追踪: 使用GetSurfaceIds()精确定位边界表面
• 多连通体支持: 通过GetVolumeInfo()处理复杂几何
• 表面信息详化: 集成GetSurfaceInfos()提供详细分析

Phase 4: 表面法向量验证 (目标: 外表面识别提升)

目标: 通过法向量分析提升外表面识别准确性

4.1 法向量验证函数

// 表面朝向验证
pfcVector3D_ptr GetSurfaceNormalEnhanced(pfcSurface_ptr surface, pfcUVParam_ptr uv);
bool IsOutwardFacing(pfcVector3D_ptr normal, pfcPoint3D_ptr centroid);
double CalculateSurfaceOrientation(pfcSurface_ptr surface);

4.2 几何验证增强

• 法向量方向: 使用GetNormal()验证表面朝向
• 曲率分析: 通过EvalPrincipalCurv()识别特征表面
• 边界增强: 结合GetDirection()和GetExtents()优化边界检测

API集成优先级

优先级	API类别	预期提升	实现复杂度
P0	干涉检测API	75%→85%	中等
P1	体积分析API	装配体优化	高
P2	表面法向量API	外表面识别	低

实施原则

核心哲学

• 直接实现: 立即暴露问题，快速失败
• 单一方案: 不要后备方案，出错就暴露
• 最小变更: 影响最小、风险最低的方案

技术要求

1. 渐进式集成: 按Phase顺序逐步实施，每个Phase独立验证
2. 性能基准: 建立性能测试确保响应时间不劣化
3. 用户可配: 通过参数控制是否启用高级API