AnsysLink/USAGE_GUIDE.md

CAE网格生成助手 - 使用指南

快速开始

方法1：快速启动（推荐）

python start.py

方法2：演示启动器

python scripts/demo_launcher.py

方法3：应用启动脚本

python scripts/run_app.py

方法4：开发模式

python app.py

系统要求

基本要求

• Python 3.8+
• 4GB+ RAM
• 1GB+ 可用磁盘空间

依赖包

pip install -r requirements.txt

可选组件

• ANSYS Mechanical 2023R1+ (用于真实网格生成)
• PyMechanical (ANSYS Python接口)

功能概览

1. 文件上传

• 支持格式：.step, .stp
• 最大文件大小：100MB
• 自动文件验证

2. 网格生成

• 自动几何识别
• 智能网格控制
• 实时进度监控

3. 质量检查

• 网格质量评估
• 详细质量报告
• 改进建议

4. 结果导出

• 网格文件下载
• 质量报告导出
• 可视化图像

详细使用步骤

步骤1：启动系统

1. 确保Python环境正确配置
2. 安装所需依赖包
3. 运行启动脚本
4. 在浏览器中访问 http://localhost:5000

步骤2：上传STEP文件

1. 点击上传区域或拖拽文件
2. 选择涡扇叶片STEP文件
3. 等待文件验证完成
4. 确认文件信息正确

步骤3：开始网格生成

1. 点击"开始生成"按钮
2. 观察处理进度和日志
3. 等待网格生成完成

步骤4：查看结果

1. 查看网格统计信息
2. 分析质量评估报告
3. 查看可视化结果
4. 下载所需文件

配置选项

环境变量

# Flask配置
export FLASK_ENV=development
export FLASK_DEBUG=1

# ANSYS配置
export ANSYS_VERSION=231
export ANSYS_ROOT="C:\Program Files\ANSYS Inc\v241"

配置文件

编辑 config.py 文件修改系统配置：

• 文件上传限制
• ANSYS设置
• 网格参数

故障排除

常见问题

1. 依赖包安装失败

# 升级pip
python -m pip install --upgrade pip

# 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

2. ANSYS连接失败

• 检查ANSYS是否正确安装
• 确认PyMechanical模块可用
• 检查许可证状态
• 尝试演示模式

3. 文件上传失败

• 确认文件格式正确
• 检查文件大小限制
• 验证文件完整性

4. 网格生成失败

• 检查几何文件质量
• 查看错误日志
• 尝试简单几何

日志查看

# 应用日志
tail -f app.log

# 错误日志
tail -f error.log

性能优化

系统优化

1. 确保足够的内存（推荐8GB+）
2. 使用SSD存储提高I/O性能
3. 关闭不必要的后台程序

文件优化

1. 使用高质量的STEP文件
2. 避免过于复杂的几何
3. 预处理几何文件

网格优化

1. 合理设置网格密度
2. 使用局部细化
3. 平衡质量和计算效率

API接口

文件上传

POST /api/upload
Content-Type: multipart/form-data

开始网格生成

POST /api/mesh/generate
Content-Type: application/json

查询状态

GET /api/mesh/status

获取结果

GET /api/mesh/result

开发指南

项目结构

cae-mesh-generator/
├── app.py              # Flask应用入口
├── config.py           # 配置文件
├── requirements.txt    # 依赖列表
├── backend/           # 后端代码
├── templates/         # HTML模板
├── static/           # 静态资源
└── test/             # 测试文件

开发环境设置

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动开发服务器
python app.py

测试

# 运行测试套件
python test_suite.py

# 运行集成测试
python test_integration.py

部署指南

开发部署

python run_app.py

生产部署

# 使用Gunicorn
pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 app:create_app()

# 使用uWSGI
pip install uwsgi
uwsgi --http :5000 --wsgi-file app.py --callable create_app()

Docker部署

FROM python:3.9
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "run_app.py"]

安全注意事项

1. 文件上传安全

   • 验证文件类型和大小
   • 扫描恶意内容
   • 隔离上传文件

2. 数据保护

   • 定期清理临时文件
   • 保护敏感配置信息
   • 使用HTTPS传输

3. 访问控制

   • 限制API访问频率
   • 实施用户认证
   • 记录操作日志

许可证

本项目采用MIT许可证。详见LICENSE文件。

支持与反馈

• 问题报告：创建GitHub Issue
• 功能建议：提交Pull Request
• 技术支持：查看文档或联系开发团队

---

祝您使用愉快！