Baffalo Modeling

第二步：阅读参考文档

用户确认核心类后，阅读参考文档 reference.md（与本文件同目录），了解该类的 input、params、output 字段定义及含义。

文档按包分组，每个核心类都有完整的字段表格。阅读后即可掌握该类需要哪些输入参数、有哪些可调参数、以及输出结果的结构。

第三步：阅读源码和案例

在了解字段定义的基础上，按以下优先级阅读源文件以获取精确的 API 用法：

阅读顺序（按优先级排列）

1. 案例文件（最高优先级） — 先阅读 Testing/ 下对应的 Demo 文件，了解完整的使用流程和参数传递方式
2. 构造函数 — 阅读类的构造函数 .m 文件（与类同名的 .m），了解对象的创建方式和参数
3. 核心方法 — 使用 SearchCodebase 搜索类名下的方法，了解可用的操作

检索方法

使用 SearchCodebase 工具搜索相关代码，例如：

• 搜索类定义："classdef ClassName"
• 搜索方法："function result = MethodName"
• 使用 Grep 搜索特定模式

第四步：编写代码

编码规范

1. 网格输出约定 — 组件的 output 中通常包含 Surface（Surface2D）、SolidMesh（Mesh）、Assembly（Assembly）三个字段
2. 路径设置 — 使用前需运行 setBaffaloPath 设置 ANSYS/Simpack/ParaView 路径

代码风格

• 不添加注释（除非用户要求）
• 遵循 MATLAB 包命名约定（+ 前缀目录）
• 使用链式调用风格（方法返回对象本身）
• 数值单位默认为 mm（长度）、MPa（应力）、kg（质量）

第五步：验证

编写完成后，建议用户：

1. 在 MATLAB 中运行 setBaffaloPath
2. 运行生成的代码
3. 检查 Plot3D / Plot2D 输出是否正确
4. 如需 ANSYS 求解，确认 ANSYS 路径已设置

注意事项

• 编写代码前必须先检索并阅读源码，不要凭记忆猜测 API
• 如果模块索引表中没有覆盖用户需求，使用 SearchCodebase 在整个项目中搜索
• 优先参考 Testing 目录中的案例文件，它们展示了最准确的用法