| name | fixed_wing_shape_detail_runbook |
| description | 生成固定翼外形资产(翼型/机身剖面/网格预览/OpenVSP脚本)并支持外形候选搜索。当用户要产出可视化资产或做外形候选对比时调用。 |
| stage | class3_detailed |
| code_module | aircraft_design/class3_detailed/geometry_detailed.py, aircraft_design/class3_detailed/geometry_modeling.py |
| dependencies | ["fixed_wing_shape_detail_spec"] |
固定翼外形详细设计(Runbook)
角色定位(统一入口)
- “总体闭环计算与落盘”入口固定为
fixed_wing_overall_sizing_runbook(输出到 output/)。
- 本 Runbook 负责两类事情:
- 让总体入口在收敛后输出可复用外形资产(OpenVSP/OBJ/图表)
- 通过
scripts/shape_search.py 生成候选外形集合用于对比筛选(输出到 out/)
目标
- 从单一输入 JSON 出发,生成可复用外形资产与可视化
- 支持创成式外形搜索(候选集 + 每个候选的三视图预览)
- 支持 OpenVSP 脚本导出(若 OpenVSP/VSPAERO 可用则可进一步分析)
一键运行
1) 用总体入口生成外形资产(推荐)
python -m aircraft_design.run_sizing ./sizing_input.json --project-name "ShapeAssets"
产物(output/ShapeAssets_*/,收敛后才会进入扩展阶段输出资产):
design_report_v2.md:总体报告(Class I)
design_data.json:输入快照与输出汇总
geometry_3d.html:三视图预览(离线可打开)
geometry_mesh.json:网格 JSON
geometry.obj:OBJ 资产(网格导出)
model.vspscript:OpenVSP 脚本
model.obj:OBJ 导出目标(脚本包含导出指令)
interactive_charts.html:交互图表
technical_roadmap_report.md:扩展阶段技术报告(含图表引用)
2) 创成式外形搜索(候选集)
python ./scripts/shape_search.py ./examples/fixed_wing_ga_single.json --n 32 --seed 1
产物(out/):
shape_search_report.md:Top 候选表格(含 3D 链接)
shape_search_results.json:全部候选与可行集
shapes/shape_*.html:每个候选的三视图预览
GUI 关系说明
- 总体入口可选开启 GUI 做实时可视化;离线候选搜索不会推送到 GUI。
- 若希望 GUI 稳定显示 3D,请确保输入包含
geometry_shape(或提供 mesh 顶点/面片数据)。
输入片段示例(用于 GUI 兼容)
{
"geometry_shape": {
"fuselage": {
"axis": {"length_m": 10.0},
"profile": {"mode": "parametric", "max_radius_m": 1.2}
},
"wing": {
"planform": {
"s_ref_m2": 24.0,
"aspect_ratio": 6.0,
"taper_ratio": 0.5,
"sweep_quarter_chord_deg": 15.0
}
}
}
}
验证
python -m unittest discover -s tests