# kcs **Repository Path**: sqqfly/kcs ## Basic Information - **Project Name**: kcs - **Description**: Tribon内建函数 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 0 - **Created**: 2022-04-24 - **Last Updated**: 2026-05-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # kcs Tribon 船舶设计软件的 Python 二次开发库 ## 项目介绍 本项目是针对 Tribon M3 船舶设计系统的 Python 二次开发库，提供了丰富的 API 接口用于自动化船舶设计流程，包括管子设计、结构件设计、模型管理、焊缝处理等功能。 本项目主要是将文档中的接口提取出来，提供了 Python 类的封装，方便开发者调用。方便作为基础库投喂给人工智能模型。 ## 环境要求 - Python 2.3.3 - wxPythonWIN32-2.4.2.4-Py23 - pywin32-218.win32-py2.3 - ctypes-1.0.2.win32-py2.3 - pysqlite-2.3.3.win32-py2.3-AMT ## 项目结构 ``` kcs/ ├── Lib/ # 基础类库（Tribon对象封装） │ ├── # 基础几何类 │ ├── KcsPoint2D.py # 2D点类 │ ├── KcsPoint3D.py # 3D点类 │ ├── KcsVector2D.py # 2D矢量类 │ ├── KcsVector3D.py # 3D矢量类 │ ├── KcsLine2D.py # 2D线类 │ ├── KcsLine3D.py # 3D线类 │ ├── KcsArc2D.py # 2D圆弧类 │ ├── KcsArc3D.py # 3D圆弧类 │ ├── KcsCircle2D.py # 2D圆类 │ ├── KcsCircle3D.py # 3D圆类 │ ├── KcsEllipse2D.py # 2D椭圆类 │ ├── KcsConic2D.py # 2D圆锥曲线类 │ ├── KcsPolygon2D.py # 2D多边形类 │ ├── KcsPolygon3D.py # 3D多边形类 │ ├── KcsRectangle2D.py # 2D矩形类 │ ├── KcsPlane3D.py # 3D平面类 │ ├── KcsContour2D.py # 2D轮廓类 │ ├── KcsGeoContour3D.py # 3D几何轮廓类 │ ├── KcsTransformation2D.py # 2D变换类 │ ├── KcsTransformation3D.py # 3D变换类 │ ├── │ ├── # 管子相关类 │ ├── KcsPipeProp.py # 管子属性类 │ ├── KcsPipeSpoolProp.py # 管段属性类 │ ├── KcsPipePartProp.py # 管子零件属性类 │ ├── KcsPipeMaterial.py # 管子材料类 │ ├── KcsPipeName.py # 管子命名类 │ ├── KcsPipeRoute.py # 管子路径类 │ ├── KcsPipeCheck.py # 管子检查类 │ ├── KcsPipeCheckSettings.py# 管子检查设置类 │ ├── KcsPipeJointAddCriteria.py # 管子接头添加条件类 │ ├── KcsPipePartAddCriteria.py # 管子零件添加条件类 │ ├── KcsResultPipeCheck.py # 管子检查结果类 │ ├── KcsResultPipeStructConn.py # 管子结构连接结果类 │ ├── │ ├── # 结构件相关类 │ ├── KcsShPlateProp.py # 板材属性类 │ ├── KcsShStiffProp.py # 加强筋属性类 │ ├── KcsProfSymb.py # 型材符号类 │ ├── │ ├── # 焊接相关类 │ ├── KcsWeld.py # 焊缝类 │ ├── KcsWeldTable.py # 焊缝数据表类 │ ├── KcsWeldedJoint.py # 焊接接头类 │ ├── │ ├── # 体素/实体类 │ ├── KcsVolPrimitiveBase.py # 体素基类 │ ├── KcsVolPrimitiveBlock.py # 方块体素类 │ ├── KcsVolPrimitiveGeneralCylinder.py # 通用圆柱体素类 │ ├── KcsVolPrimitiveRevolution.py # 回转体素类 │ ├── KcsVolPrimitiveSphericalCap.py # 球帽体素类 │ ├── KcsVolPrimitiveTorusSegment.py # 圆环体素类 │ ├── KcsVolPrimitiveTruncatedCone.py # 圆锥台体素类 │ ├── KcsBox.py # 盒子类 │ ├── KcsCone.py # 圆锥类 │ ├── KcsTorus.py # 圆环类 │ ├── KcsGencylinder.py # 通用圆柱类 │ ├── KcsCap.py # 球帽类 │ ├── │ ├── # 装配与文档类 │ ├── KcsAssembly.py # 装配类 │ ├── KcsAssemblyKeyInItem.py # 装配录入项类 │ ├── KcsDocumentReference.py # 文档引用类 │ ├── │ ├── # 模型与对象类 │ ├── KcsModel.py # 模型类 │ ├── KcsModelObjectRevision.py # 模型对象版本类 │ ├── KcsObject.py # 对象基类 │ ├── KcsObjectCriteria.py # 对象条件类 │ ├── KcsCommonProperties.py # 通用属性类 │ ├── │ ├── # 显示与视图类 │ ├── KcsColour.py # 颜色类 │ ├── KcsLinetype.py # 线型类 │ ├── KcsLayer.py # 图层类 │ ├── KcsSymbol.py # 符号类 │ ├── KcsSymbollist.py # 符号列表类 │ ├── KcsText.py # 文本类 │ ├── KcsHighlightSet.py # 高亮集类 │ ├── KcsLineTypeDisplaySettings.py # 线型显示设置类 │ ├── KcsBodyPlanViewOptions.py # 型线图视图选项类 │ ├── KcsShellXViewOptions.py # 曲面展开视图选项类 │ ├── │ ├── # 选择与交互类 │ ├── KcsElementHandle.py # 元素句柄类 │ ├── KcsCursorType.py # 光标类型类 │ ├── KcsButtonState.py # 按钮状态类 │ ├── │ ├── # 表格与列表类 │ ├── KcsStringlist.py # 字符串列表类 │ ├── KcsDrawTable.py # 绘图表格类 │ ├── KcsGaugedList.py # 测量列表类 │ ├── KcsDiminutionList.py # 缩减列表类 │ ├── KcsPredictList.py # 预测列表类 │ ├── │ ├── # 搜索与查询类 │ ├── KcsSpecSearch.py # 规格搜索类 │ ├── KcsTMList.py # 模板列表类 │ ├── KcsTMResult.py # 模板结果类 │ ├── │ ├── # 选项与配置类 │ ├── KcsPrintOptions.py # 打印选项类 │ ├── KcsRunModeOptions.py # 运行模式选项类 │ ├── KcsCopyPanOptions.py # 复制板架选项类 │ ├── KcsMovePanOptions.py # 移动板架选项类 │ ├── KcsSplitPanOptions.py # 分离板架选项类 │ ├── KcsPanHoleOptions.py # 板架孔选项类 │ ├── KcsPanelSchema.py # 板架模式类 │ ├── KcsConfNoteRec.py # 配置记录类 │ ├── KcsProjectCopyArg.py # 项目复制参数类 │ ├── │ ├── # 辅助工具类 │ ├── KcsPythonUtil.py # Python工具类 │ ├── KcsUtilPan.py # 板架工具类 │ ├── KcsUtilDexPan.py # DEX板架工具类 │ ├── KcsUtilPanSch.py # 板架模式工具类 │ ├── KcsUtilPos.py # 位置工具类 │ ├── KcsContourOperations.py # 轮廓操作类 │ ├── KcsCPanDist.py # 板架距离计算类 │ ├── KcsCaptureRegion2D.py # 2D捕获区域类 │ ├── KcsConnection.py # 连接类 │ ├── KcsVolConnection.py # 体素连接类 │ ├── KcsInterpretationObject.py # 解释对象类 │ ├── KcsPictWinExt.py # 图像窗口扩展类 │ ├── KcsDate.py # 日期类 │ ├── KcsTime.py # 时间类 │ ├── KcsDateTime.py # 日期时间类 │ ├── KcsRline2D.py # 2D参考线类 │ ├── KcsRline3D.py # 3D参考线类 │ ├── KcsModelDrawAssyCriteria.py # 模型绘图装配条件类 │ ├── KcsStat_point2D_req.py # 2D统计点请求类 │ ├── KcsStat_point3D_req.py # 3D统计点请求类 │ ├── │ ├── # 异常类 │ ├── KcsTbBaseException.py # 基础异常类 │ ├── │ ├── # 钩子函数（Tribon Hook） │ ├── _TBhook_AutoPanelName.py # 板架自动命名钩子 │ ├── _TBhook_ConfigNote.py # 配置记录钩子 │ ├── _TBhook_CustBracket.py # 自定义支架钩子 │ ├── _TBhook_CustHole.py # 自定义孔钩子 │ ├── _TBhook_CustNotch.py # 自定义切口钩子 │ ├── _TBhook_CustPartName.py # 自定义零件命名钩子 │ ├── _TBhook_Formula.py # 公式钩子 │ ├── _TBhook_PPanScheme.py # 板架模式钩子 │ ├── │ └── # 其他工具类 │ ├── CommonSample.py # 公共示例 │ ├── Defaults.py # 默认配置 │ ├── cCoordRef.py # 坐标参考类 │ ├── cPanel.py # 板架类 │ ├── stringutils.py # 字符串工具类 │ └── KcsTBDVitDef.py # TBD视图定义类 ├── └── # 高层API模块（业务接口） ├── kcs_assembly.py # 装配管理模块 ├── kcs_att.py # 属性管理模块 ├── kcs_cable.py # 电缆管理模块 ├── kcs_chm.py # CHM文档模块 ├── kcs_db.py # 数据库操作模块 ├── kcs_dex.py # DEX数据交换模块 ├── kcs_draft.py # 绘图模块 ├── kcs_equip.py # 设备管理模块 ├── kcs_gui.py # GUI界面模块 ├── kcs_hullpan.py # 船体板架模块 ├── kcs_ic.py # 干涉检查模块 ├── kcs_model.py # 模型管理模块 ├── kcs_modelstruct.py # 模型结构模块 ├── kcs_pipe.py # 管子/通风管模块 ├── kcs_placvol.py # 放置体素模块 ├── kcs_spec.py # 规格管理模块 ├── kcs_struct.py # 结构件模块 ├── kcs_ui.py # UI界面模块 ├── kcs_util.py # 工具函数模块 ├── kcs_vol.py # 体素操作模块 └── kcs_weld.py # 焊缝处理模块 ``` ## 主要模块说明 ### 1. kcs_model.py - 模型管理 - 干涉检查功能 - 模型属性设置 - 模型状态管理（设计/制造/装配/物料控制） ### 2. kcs_pipe.py - 管子/通风管 - 管子创建、激活、删除、复制 - 管段管理（Spool） - 零件添加、编辑、连接 - 焊接间隙设置 - 管子校核与小票图生成 ### 3. kcs_struct.py - 结构件 - 舾装件创建、激活、删除 - 型材创建（通过两点或轮廓） - 板材创建 - 孔创建 - 标准件调入与管理 ### 4. kcs_weld.py - 焊缝处理 - 板缝生成 - 焊缝数据获取与更新 - 焊缝删除 ### 5. kcs_util.py - 工具函数 - UI 响应值常量 - 应用模块状态检测 - 环境变量操作 - 坐标转换（绝对坐标/相对坐标/板架坐标） - 工作空间管理 ## 使用示例 ```python import kcs_pipe import kcs_struct # 创建管子 kcs_pipe.pipe_new("PIPE-001", "RED") # 创建舾装件 kcs_struct.struct_new("STRUCT-001", "MODULE-01", "BLUE") # 检查模型干涉 result = kcs_model.model_hull_interference_check(model, "pipe", 0.1) ``` ## 注意事项 1. 本库需要在 Tribon M3 环境中运行 2. 需要正确配置 Tribon 环境变量 3. 部分操作需要激活相应的应用模块 4. 建议在操作前调用 `kcs_util.clean_workspace()` 清理工作空间