CreoOtkPluging/shell-analysis-enhancement-doc.md

Shell Analysis Optimization Solution

项目概述

MFC Creo DLL 的薄壳分析接口通过OTK真实几何API实现精确的内外结构识别，核心目标：去除内部结构，保留外表面。

核心问题与解决方案

Phase 1: 基础几何检测 (已完成)

• 零件外表面检测: 实现IsShellFeature + IsVisibleSurface算法
• 表面边界检测: 使用GetIsVisible(), GetInternalTraversal(), GetSurface2()
• 状态: ✅ 零件级别外表面识别基本正确

Phase 2: 装配体遮挡检测 (已修复)

原始错误: 计算组件与包含自己的装配体的干涉 → 逻辑错误 解决方案: 重新设计为计算目标组件与其他组件的真实遮挡关系

当前算法实现

1. 装配体遮挡检测算法

bool IsComponentOccludedAdvanced(pfcSolid_ptr targetComponent, pfcSolid_ptr assembly) {
    // 1. 获取装配体中所有组件
    pfcAssembly_ptr asmModel = pfcAssembly::cast(assembly);
    pfcFeatures_ptr allComponents = asmModel->ListFeaturesByType(xfalse, pfcFEATTYPE_COMPONENT);

    double targetVolume = targetComponent->GetMassProperty()->GetVolume();
    double totalOccludedVolume = 0.0;
    int occludingComponentsCount = 0;

    // 2. 逐一检查与其他组件的干涉
    for (each other component in assembly) {
        if (otherCompSolid == targetComponent) continue; // 跳过自比较

        double interferenceVolume = CalculateInterferenceVolume(targetComponent, otherCompSolid);
        if (interferenceVolume > 0.0) {
            totalOccludedVolume += interferenceVolume;
            occludingComponentsCount++;
        }
    }

    // 3. 动态几何阈值判断
    double occlusionRatio = totalOccludedVolume / targetVolume;

    if (occludingComponentsCount == 1) {
        return occlusionRatio > 0.5;        // 单组件干涉: 50%阈值
    } else if (occludingComponentsCount <= 3) {
        return occlusionRatio > 0.35;       // 多组件干涉: 35%阈值
    } else {
        return occlusionRatio > 0.25;       // 大量干涉: 25%阈值(内部)
    }
}

2. 干涉体积计算算法

double CalculateInterferenceVolume(pfcSolid_ptr target, pfcSolid_ptr occluder) {
    // 创建两个独立组件的选择集
    pfcSelection_ptr targetSel = pfcCreateModelItemSelection(pfcModelItem::cast(target), nullptr);
    pfcSelection_ptr occluderSel = pfcCreateModelItemSelection(pfcModelItem::cast(occluder), nullptr);

    // 计算真实干涉体积
    pfcSelectionPair_ptr selPair = pfcSelectionPair::Create(targetSel, occluderSel);
    pfcSelectionEvaluator_ptr evaluator = pfcCreateSelectionEvaluator(selPair);
    pfcInterferenceVolume_ptr interferenceVol = evaluator->ComputeInterference(true);

    return interferenceVol->ComputeVolume();
}

3. 零件外表面检测算法

bool IsShellFeature(pfcFeature_ptr feature, pfcSolid_ptr solid) {
    // 获取特征创建的所有表面
    pfcModelItems_ptr surfaces = solid->ListItems(pfcITEM_SURFACE);

    for (each surface) {
        if (surface->GetFeature() == feature) {
            if (IsVisibleSurface(surface)) {
                return true; // 特征创建可见外表面
            }
        }
    }
    return false; // 特征只创建内部表面
}

bool IsVisibleSurface(pfcSurface_ptr surface) {
    // 1. 基础可见性检查
    if (!surface->GetIsVisible()) return false;

    // 2. 轮廓分析
    pfcContours_ptr contours = surface->ListContours();
    for (each contour) {
        if (!contour->GetInternalTraversal()) { // 外轮廓
            // 3. 边界边检测
            pfcEdges_ptr edges = contour->ListElements();
            for (each edge) {
                if (edge->GetSurface2() == nullptr) {
                    return true; // 发现边界边 = 外表面
                }
            }
        }
    }
    return has_external_contour;
}

4. 决策逻辑算法

// 基于真实遮挡分析的决策逻辑
if (component_occluded && !is_shell_feature) {
    confidence = 90.0;  // 内部组件的内部特征 = 最高删除置信度
    recommendation = "DELETE";
} else if (component_occluded && is_shell_feature) {
    confidence = 65.0;  // 内部组件的外表面特征 = 中等删除置信度
    recommendation = "DELETE";
} else if (!component_occluded && !is_shell_feature) {
    confidence = 80.0;  // 外部组件的内部特征 = 标准删除置信度
    recommendation = "DELETE";
} else {
    confidence = 10.0;  // 外部组件的外表面特征 = 强制保留
    recommendation = "KEEP";
}

关键API调用序列

装配体分析流程

1. assembly->ListFeaturesByType(pfcFEATTYPE_COMPONENT) - 获取组件列表
2. IsComponentOccludedAdvanced(compSolid, assemblySolid) - 遮挡检测
3. solid->ListFeaturesByType(xfalse) - 获取组件特征
4. IsShellFeature(feature, solid) - 外表面特征检测

干涉检测流程

1. pfcCreateModelItemSelection(pfcModelItem::cast(solid), nullptr) - 创建选择集
2. pfcCreateSelectionEvaluator(pfcSelectionPair::Create(sel1, sel2)) - 创建评估器
3. evaluator->ComputeInterference(true) - 计算干涉体积
4. interferenceVol->ComputeVolume() - 获取干涉数值

表面检测流程

1. solid->ListItems(pfcITEM_SURFACE) - 获取表面列表
2. surface->GetIsVisible() - 基础可见性
3. surface->ListContours() - 获取轮廓
4. contour->GetInternalTraversal() - 判断内外轮廓
5. contour->ListElements() - 获取边列表
6. edge->GetSurface2() - 边界边检测

算法修复历史

❌ 原始错误 (Phase 2初版)

// 错误: 组件与包含自己的装配体计算干涉
bool IsComponentOccludedAdvanced(pfcSolid_ptr component, pfcSolid_ptr assembly) {
    pfcSelection_ptr compSelection = pfcCreateModelItemSelection(component, nullptr);
    pfcSelection_ptr asmSelection = pfcCreateModelItemSelection(assembly, nullptr); // 错误!
    // interferenceVolume ≈ componentVolume (无意义)
}

✅ 修复后算法 (Phase 2修复版)

// 正确: 目标组件与其他组件逐一计算干涉
bool IsComponentOccludedAdvanced(pfcSolid_ptr targetComponent, pfcSolid_ptr assembly) {
    for (each otherComponent in assembly) {
        if (otherComponent == targetComponent) continue; // 跳过自比较
        interferenceVolume = CalculateInterferenceVolume(targetComponent, otherComponent);
    }
}

技术规格

必需头文件

#include <pfcInterference.h>    // 干涉检测API
#include <pfcSelect.h>          // 选择集API
#include <pfcGeometry.h>        // 几何分析API
#include <pfcAssembly.h>        // 装配体API
#include <pfcSolid.h>           // 实体质量属性API

核心API依赖

• OTK 5.0.0.0: 基础几何和干涉检测
• pfcCreateModelItemSelection: 选择集创建
• pfcCreateSelectionEvaluator: 干涉计算评估器
• ComputeInterference(true): 体积干涉计算

准确率预期

• Phase 1 (基础): 40% → 75%
• Phase 2 (修复): 75% → 85%+
• 核心改进: 从几何推断转向真实干涉检测，修复根本性算法错误

实施状态

• ✅ 零件外表面检测: 基本正确
• ✅ 装配体遮挡检测: 已修复根本性错误
• ✅ 动态几何阈值: 替代硬编码30%
• ✅ API类型转换: 所有编译错误已修复
• ✅ 算法完整性: 真正实现"去除内部结构，保留外表面"核心需求