Skip to main content
Glama

HydroStar MCP

简体中文 English

Tests Python 3.10+ MIT

从参数、型值表和 CAD 建立水动力模型,完成面元质量检查、静力平衡、HydroStar 原生求解与六自由度结果验收。项目面向研究生课程、方法研究及明确假设下的工程简化分析,提供 Windows 本地 MCP 和命令行接口。

在线计算报告可旋转实际求解网格,切换构型、浪向、幅值、相位及动态场量。快速开始介绍安装与复算,建模说明给出参数和质量要求。

复杂建模展示另提供贯通月池浮体、曲线站位船体及带升沉板 Spar 的网格与响应图,在线报告对应章节可逐项查看。

计算对象与求解网格

曲线船体由本项目原创型值表重建,采用沿站位与剖面的四边形网格带。湿面包含 2018 个四边形和 11 个端部三角形,另有 844 个水线面元,全体合计 2873 个面元。在默认预算内完成 231 个频率点和 13 个浪向的真实计算,几何与六项原生执行门禁全部通过。

以下为 HydroStar 自带 Visu5D 直接打开实际求解 HST 后保存的湿面网格原图。点击任一图片可看完整分辨率。来源、导出步骤与哈希随算例保存。

原创曲线船体

半潜平台

曲线船体 Visu5D 原图

半潜平台 Visu5D 原图

集装箱船

丰满油船

集装箱船 Visu5D 原图

丰满油船 Visu5D 原图

四种构型的 ParaView 配套湿面网格总览

蓝色为势流湿表面,灰色为平台干结构和细杆背景。几何倍率为 1,各视图独立取景。

计算对象

全体总面元,含水线面

频率范围与间隔(rad/s)

频率点与浪向数

原创曲线船体

2873

0.05–1.20,0.005

231 × 13

集装箱船

1710

0.05–0.80,0.005

151 × 13

丰满油船

1732

0.05–0.60,0.005

111 × 13

半潜平台

1782

0.02–1.20,0.005

237 × 13

三类资料参照构型使用公开主尺度与本项目明确的形状假设,节点和面元由项目生成器建立。来源说明保存了尺度引用、重建方法与物理模型。

展示图按生成工具标注。月池网格首图是 Visu5D 自带查看器直接保存的原生软件图;ParaView、Gnuplot 生成的图为配套工具出图,分别保留 HydroStar 原生数值来源。

Related MCP server: LS-PrePost-MCP

压力、波面与运动静态图

四种构型均提供表面压力、总波面和散射波面的同相位静态原图。共同入射波幅为 0.50 m,浪向为 60°;各自选定频率、物理周期和水深如下。

计算对象

角频率(rad/s)

物理周期(s)

水深(m)

曲线船体

0.65

9.666

80

半潜平台

0.80

7.854

200

集装箱船

0.50

12.566

80

丰满油船

0.40

15.708

80

下方三联配套图的左图显示平均湿表面的随体一阶动态压力(kPa),中图为总波面与刚体运动,右图为包含绕射和运动诱导辐射的散射波面(m)。运动和波高各采用 6 倍观察倍率,压力图几何倍率为 1。各组三联图采用同一物理相位,色标在整个周期内固定。

曲线船体。 查看所选相位下船体湿面压力、总波面、散射波面与六自由度运动的对应关系。

曲线船体动态压力、总波面和散射波面

半潜平台:HyView 湿面压力云图。 在 HydroStar 自带 HyView 中回放 60°、周期 7.9 s、波幅 0.50 m、水深 200 m 的规则波,隐藏自由面后保存原生录制并提取静帧。颜色从紫到黄对应 −0.56 至 +0.56 m 水柱(约 −5.63 至 +5.63 kPa)的显示范围。图中为随体一阶扰动压力;结构应力需另行计算。

HyView 原生录制静帧:半潜平台一阶湿面压力

半潜平台动态压力、总波面和散射波面

集装箱船。 参照构型包含平行中体、圆舭、球鼻艏和艉封板,静图使用该构型自身的计算结果。

集装箱船动态压力、总波面和散射波面

丰满油船。 展示丰满中体和连续收缩艏艉所对应的湿表面压力与外部波场。

丰满油船动态压力、总波面和散射波面

配套 ParaView 图标明 t、t/T、工况与固定色标,点击可查看原尺寸。HyView 静帧保留原生画面,其录制帧号和色标见原生结果图验收记录。这些图用于查看场量分布,全周期峰值另由完整数值确定。

绕射与辐射波场

以下静态原图将同一相位的散射波场分解为固定体绕射和运动诱导辐射。左图保持平均姿态,右图显示该工况六自由度运动激发的辐射贡献。分量在复数域分解后按统一物理相位重建,波面色标为 m,波高和运动观察倍率均为 6。每个面板在完整周期内采用固定色标。

曲线船体的绕射与辐射。

曲线船体固定体绕射和运动诱导辐射

半潜平台的绕射与辐射。

半潜平台固定体绕射和运动诱导辐射

集装箱船的绕射与辐射。

集装箱船固定体绕射和运动诱导辐射

丰满油船的绕射与辐射。

丰满油船固定体绕射和运动诱导辐射

场量来自经独立核对的 HSPRS 原生复数结果,使用 ParaView 命令直接导出 PNG;图注排版与所选相位随导出记录保存。入射波解析解、完整复辐射重建、随体压力修正及外法向采样敏感性分别验收。HSprv 原始导出和版本兼容性诊断一并保存,展示字段明确指向已验收结果。可视化数据与导出记录和命令复现方法随仓库提供。单独放大的总波与散射波视图见曲线船体、半潜平台、集装箱船和丰满油船。

曲线船体压力与波面 · 曲线船体绕射与辐射 · 半潜平台压力与波面 · 半潜平台绕射与辐射 · 集装箱船压力与波面 · 集装箱船绕射与辐射 · 丰满油船压力与波面 · 丰满油船绕射与辐射

六自由度频率响应

六自由度为纵荡、横荡、升沉、横摇、纵摇和艏摇。横轴为角频率(rad/s),平移幅值单位为 m/m,转动为 deg/m。各例保留原生 RAO;Gnuplot 配套叠图通过核对 hsrao 宏与数据列导出,展示 0°、60°、90°、120° 和 180° 浪向。

曲线船体。 231 个频率点覆盖 0.05–1.20 rad/s,间隔为 0.005 rad/s,保留升沉、横摇与纵摇等响应的峰谷细节。

曲线船体六自由度原生响应

半潜平台:StarViewer 原生 RAO。 用 HydroStar 自带 StarViewer 读取六个 .rao,直接保存 60° 浪向的六自由度幅值 SVG。237 个频率点覆盖 0.02–1.20 rad/s。

StarViewer 保存的半潜平台六自由度 RAO 矢量图

半潜平台五个浪向的 Gnuplot 配套 PDF。

集装箱船。 151 个频率点覆盖 0.05–0.80 rad/s。

集装箱船六自由度原生响应

丰满油船。 111 个频率点覆盖 0.05–0.60 rad/s。

丰满油船六自由度原生响应

相位单位为 deg,按 −180° 至 180° 包裹显示,跨边界采用离散点保留原生采样;相位跳变需结合包裹约定和相应幅值判断。

曲线船体在 60 度浪向下的六自由度相位

点击响应图打开对应的矢量原图。完整数值、13 个浪向的 SVG、物理参数及原生输入见曲线船体算例、其他三种构型结果和Gnuplot 曲线与原始数据。

二阶平均漂移与差频荷载

半潜平台已完成 HSdft → HSamg → HSqtf 原生二阶计算,提供平均漂移荷载及包含自由面积分的完整差频 QTF。水深为 200 m,浪向为 60°,差频为 0、0.05、0.10 rad/s,共保留 36 对有效波频、216 个复数荷载系数。

同一构型的 HyView 带浪画面。 HSMCN 的一阶刚体运动与 HSPRS 自由面在 HyView 中一起回放。规则波周期 7.9 s(约 0.795 rad/s),波幅 0.50 m,浪向 60°。画面显示一阶波况与运动;实际二阶荷载见下方 QTF。

HyView 原生录制静帧:半潜平台带浪的一阶刚体运动

StarViewer 原生二阶垂向 QTF。 读取 qtf_fz.qtf,显示三条差频幅值曲线,单位 N/m²。横轴为两波角频率的平均值,显示约 0.50–1.05 rad/s 的有效段。图像来源与复算记录。

StarViewer 保存的二阶垂向差频荷载 QTF

Visu5D 直接保存的二阶外部积分网格与四个水线开口

Visu5D 从二阶求解 HST 读取 Hull 1 与 Free-surface;上图显示完整对称展开的外部积分网格,柱体位于自由面下方。

半潜平台与规则环带外部积分网格

外部水域采用 72 个等角分段与 9 层渐变四边形环带,近体分区按平台对称性对应。主网格为 2946 个全体总面元,计入湿面、水线面、外部自由面和对称展开;对照为 2898。湿面、质量、惯性、恢复与阻尼保持一致,两档均重新完成原生计算。

半潜平台六分量二阶平均漂移荷载

半潜平台完整差频 QTF 幅值

二阶荷载系数的代表相位。 下列静态图从已验收的原生复数 QTF 按 q(t)=Re[Q exp(iΔωt)] 重建相位。第一组以波频和差频为坐标,显示 36 对有效频率的六分量系数;第二组选取 ω₁=0.80、ω₂=0.90 rad/s,显示差频为 0.10 rad/s 的六分量谐波。

二阶差频荷载系数的动态相位云图

选定频率对的二阶荷载系数谐波

静图注明所选相位,对应物理周期分别为 125.664 s 和 62.832 s。已有的相位云图动画和谐波动画作为可选资料保留。力系数为 kN/m²,力矩系数为 kN m/m²,色标与纵轴在整个周期内固定,系数倍率为 1。这些视图表达归一化二阶荷载系数的相位变化,实际双频总荷载组合、二阶表面压力和慢漂位移各需相应求解与验收。艏摇分量保留收敛研究标识。

力系数单位为 kN/m²,力矩系数为 kN m/m²;图中保留原生频率采样。QTF 对角项与平均漂移结果的最大归一差异为 0.032%,水平漂移力的近远场差异最高为 3.76%。两档外部积分离散的三个力分量复数差异最高为 0.41%,横摇和纵摇力矩最高为 0.083%。艏摇力矩的自身峰值归一差异为 23.37%,近远场平均漂移差异为 128.85%,该分量标为需继续收敛研究,完成验证后再用于工程荷载。 当前比较固定湿面与外部域半径,目标工程用途还需相应的空间、外部域、频率与参考结果证据。

差频 0.10 rad/s 的 QTF 实部与虚部

两档外部积分网格的差频荷载比较

二阶分析方法与复算说明积分域、频率配对和验收范围。原生二阶计算包保存 HST、RDF、MCN、DFT、QTF、RAO、八阶段日志、复数输出与正式交付清单;本例的 SPC 谱统计输入为本次不适用。四种构型的前述动态图展示各自的一阶压力、波场与运动。

多来源复杂几何与网格

以下三个原创算例展示曲线放样、贯通开口与 CAD 导入的完整建模链路。网格沿结构特征布置,保留实际求解 HST 中的四边形与局部三角形;各例已通过所列几何验收和六项原生执行门禁。

曲线站位船体、贯通月池浮体与带升沉板 Spar 的 ParaView 配套网格总览

示例构型

面元布局

湿面四边形 / 三角形

全体总面元,含水线面

CAD 体积相对差

曲线站位船体

站位与剖面网格带

1978 / 13

2749

0.490%

贯通月池浮体

内外壁与底面相容分块

728 / 0

1108

小于 0.001%

曲面 Spar 与升沉板

轴向环带与径向分区

2832 / 0

2964

0.411%

当前展示和生成脚本均控制在 3000 个全体等效总面元内,包含湿面、水线面和对称展开。 船体与 Spar 已按新网格重算,保持原有质量、重心、惯性、阻尼及环境;Spar 另保存 2916 个总面元的邻近离散,用于局部响应敏感性比较。

带贯通月池的多边形浮体。 由外部实体减去贯通开口,外壁、月池内壁和连接底面采用相容分块,保留内外水线闭环。

Visu5D 直接保存的贯通月池湿面网格

三个复杂构型同样由 Visu5D 打开实际求解 HST,用 Save image to file 保存 JPG。软件原图的来源与哈希。

贯通月池浮体的 ParaView 湿面网格与正交投影

曲线站位船体。 由原创曲线站位资料放样,采用对应的纵向与剖面网格带;艏艉保留有记录的局部三角形过渡。

Visu5D 直接保存的曲线站位船体湿面网格

曲线站位船体的 ParaView 湿面网格与正交投影

带升沉板的曲面 Spar。 导入本项目构造的毫米制 STEP,完成单位转换与水线裁剪,柱体环带与有限厚升沉板的径向分区相接。

Visu5D 直接保存的曲面 Spar 与升沉板网格

曲面 Spar 与升沉板的 ParaView 配套网格及投影

网格总览和配套投影由 HSprv → ParaView 导出,并逐面核对交付 HST。配套单模型 PNG 为 3000×1700;各模型 PDF 分三页保存三维、纵向和俯视图,总览 PDF 每个模型一页。本机 ParaView 的三维 PDF 含高清位图。响应与网格对照曲线读取原始 RAO 和 hsrao 绘图宏,由 Gnuplot 导出矢量 PDF/SVG。坐标单位为 m,几何倍率为 1,各视图独立取景。完整验收数据记录角度、翘曲、相邻尺度比、CAD 体积与浮心误差及来源哈希。

响应覆盖 0.2–0.8 rad/s、间隔 0.1 rad/s,浪向为 0°、60°、120° 和 180°;平移响应单位为 m/m,转动为 deg/m。

贯通月池浮体的六自由度原生响应

曲线站位船体的六自由度原生响应

曲面 Spar 与升沉板的六自由度原生响应

这些采样已完成建模与原生计算链路验收。目标工程用途还需对应构型的空间收敛、峰区频率与参考响应证据;月池共振和黏性耗散需专门验证和标定。复杂几何算例保存源资料、模型参数、原生输入、完整响应与交付清单,在线报告逐项列出几何质量与响应图。

建模与原生文件交付

面元布局沿结构特征布置。同轴柱体采用环带,船体采用站位带,多边形与贯通开口采用相容分块;四边形保留到原生求解文件,同时验收角度、翘曲、尺度过渡、CAD 体积与浮心、拓扑及自交。当前公开算例与新模型采用 3000 个全体等效总面元预算,包含湿面、水线面和对称展开。提高预算须按具体算例明确授权。

型值表、曲线、DXF、STEP/IGES/BREP 和表面网格可进入统一前处理;图像与 PDF 经尺寸标定、描线和独立尺寸核对后重建。使用 python -m pip install -e ".[geometry]" 安装可选依赖,具体入口和条件见多来源建模及面元建模方法。

实际计算使用的 HST、RDF、MCN、RAO、场量输入与任务所需 SPC 属于正式交付物,随包保存参数、单位、相对路径、执行顺序、状态和来源记录。交付规范和建模 skill采用相同要求;已验证的报错原因与修复办法沉淀在排错经验。

安装与运行

需要 Python 3.10+。几何规划、输入导出和已发布结果的查看可离线完成;重新求解需要用户已安装并获授权的 HydroStar 及其 MPI 运行环境。

git clone https://github.com/lightninnng/hydrostar-mcp.git
cd hydrostar-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[plot,test]"

$env:HSTAR_PATH7 = 'C:\path\to\Hstar4Experts\v8.2.0'
python -m hydrostar_mcp environment
python -m hydrostar_mcp forms
python -m hydrostar_mcp plan examples/vessel/config.json
python -m hydrostar_mcp prepare examples/vessel/config.json

prepare 返回新的 case_id,将其代入后续命令:

$caseId = '<prepare 返回的 case_id>'
python -m hydrostar_mcp start $caseId
python -m hydrostar_mcp result $caseId --dof heave

generate 导出输入;prepare 完成网格与静力检查;start 执行辐射/绕射、运动求解和结果验收。命令行 start 等待结束,MCP start_case 异步返回。常规查看与导出优先采用原生及手册推荐路径,plot 提供补充 PNG/PDF 制图。完整步骤见快速开始。

MCP 接入

使用客户端配置示例,将 Python、项目和 HydroStar 路径替换为本机实际位置。服务使用 stdio:

python -m hydrostar_mcp.server

工具

用途

list_reference_forms / make_reference_case

浏览资料参照构型、来源与完整参数方案

inspect_environment

检查本机求解器与运行条件

inspect_geometry_source / build_geometry

检查多来源资料,建立可追溯的湿表面或图纸标定工作区

plan_case / generate_inputs

预检方案、离线导出可审阅输入

prepare_case

新建独立算例并验收网格、平衡

start_case / case_status / cancel_case

异步执行、读取状态、清理本算例进程

read_rao

校验后读取完整幅值、相位与单位

质量门禁

硬性门禁

通过条件

semantic_input

尺寸、分段、单位、有限数值与质量惯性满足约束

static_equilibrium

总浮力含实体杆件;竖向平衡误差默认 ≤1%,水平重心/浮心偏距默认 ≤0.05 m,原生平衡检查通过

mesh_geometry

湿面、法向、面元平面性与已知参考量通过检查

mesh_topology

hschk 七项计数完整,全部为 0

module_execution

模块正常完成,授权、Fortran、平衡及收敛诊断通过

rao_integrity

输出齐全、频率和浪向一致、数值有限、文件哈希匹配

门禁失败会停止后续依赖步骤。常规默认执行预算为 3000 个全体等效总面元,提高预算须按具体算例明确授权。波长与面元尺度比、长宽比另作几何筛查;超限时返回具体数值与确认 token,由使用者审阅后继续。详见建模流程。

模型与验证

采用单刚体、小运动、一阶频域模型;支持参数化箱体、曲面船体、分段船型、两类半潜和单体 HST 导入。半潜支持面元与 Morison 分工、显式质量组合、附加刚度与阻力线性化。当前执行姿态采用零静态外载平衡。二阶研究脚本另提供已验证的半潜平台原生差频流程,输入与分量验收见上述计算包。

通用几何入口补充了曲线放样、布尔组合、贯通开口和 CAD 导入。单刚体假设适用于相应的船舶与浮体理想化;多体、柔性结构、实际系泊预张力和平衡、月池黏性耗散等按目标问题扩展并验证。

曲面几何和响应峰谷来自所建模型与原生计算;一阶 RAO 表达该工况下的线性频率响应。目标海况的有限幅运动、砰击、甲板上浪、黏性分离及系泊动态耦合需要相应的扩展分析。

python -m pip install -e ".[dev,plot,geometry]"
python -m pytest -q -m "not integration" --basetemp .pytest-tmp
python scripts/check_release.py
python scripts/check_local.py

有授权的机器可执行 python scripts/reference_form_study.py --run 重算三个展示算例,再依次运行 scripts/export_showcase.py 和 scripts/build_gallery.py 更新展示。网格与频率敏感性脚本见验证说明。

文档与许可

项目代码按 MIT 发布。HydroStar 为 Bureau Veritas 的独立商业软件,安装、授权与相关权利按其许可执行。仓库提供本项目生成的输入与数值示例;第三方资料引用及权利说明见 THIRD_PARTY_NOTICES.md。

Available Tools

12 tools
build_geometryA

Build an independently checked, provenance-preserving wetted HST bundle.

CAD and section data use an isolated OpenCASCADE/Gmsh process. Drawing inputs produce a metric tracing workspace. Use case_geometry from accepted output in prepare_case, with explicit mass, CG, inertia and the desired wave conditions. Choose panel_layout by topology: ring_bands for coaxial columns, station_bands for smooth x-axis lofts, polygon_blocks for a prismatic through opening, or quad_dominant for general CAD patches. Quality limits are explicit and frozen.

Inputs: request (required). Returns: object

cancel_caseB

Request cancellation of this service's queued or active job and its solver process tree.

Inputs: case_id (required). Returns: object

case_statusB
Read-only

Read persisted state, step timings, log paths, mesh checks and result summaries.

Inputs: case_id (required). Returns: object

generate_inputsB

Export reviewable parametric MRI/HST (or imported HST), RDF, MCN and RAO.

This works without a HydroStar license. The generated status means input export only; use prepare_case before attempting any calculation.

Inputs: config (required), confirmation_token. Returns: object

inspect_environmentA
Read-only

Locate solver executables and supported capabilities; does not claim license availability.

Inputs: no named parameters. Returns: object

inspect_geometry_sourceC
Read-only

Read supported source routes or inspect a source inside HS_SOURCE_ROOT.

Inputs: path. Returns: object

list_reference_formsB
Read-only

Read built-in source-informed hull families, feature allocation and citations.

Inputs: no named parameters. Returns: object

make_reference_caseB
Read-only

Create a reviewable typed recipe from public scalar references, without writes.

Returns source comparison and a full plan. Generate/prepare the returned config using the normal gates; benchmark equivalence is evaluated separately.

Inputs: form_id (required), project. Returns: object

plan_caseB
Read-only

Validate semantic input, estimate panel counts and screen wavelength before writing files.

Inputs: config (required). Returns: object

prepare_caseB

Generate geometry/RDF/MCN/RAO and check a fresh mesh before the motion solve.

If planning requires confirmation, call again with that plan's token only after human agreement. Measured mesh warnings require another review before start_case.

Inputs: config (required), confirmation_token. Returns: object

read_raoC
Read-only

Read complete validated RAO arrays, original amplitude unit and phase values (degrees).

Inputs: case_id (required), dof. Returns: object

start_caseA

Start a previously prepared case asynchronously. Poll case_status for results.

Supply the measured-mesh confirmation token only after human review when requested. Input modification invalidates preparation. Each case may be solved once.

Inputs: case_id (required), confirmation_token. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 12 tools

    Disambiguation4/5

    The tools mostly map to distinct stages of the HydroStar workflow, from environment/geometry inspection through case preparation and result reading. A few boundaries could still be confused, especially generate_inputs versus prepare_case and make_reference_case versus plan_case, though the descriptions provide clarifying context.

    Naming Consistency4/5

    Most tool names follow a consistent snake_case verb_noun pattern such as inspect_environment, build_geometry, plan_case, and read_rao. The main deviation is case_status, which lacks a verb and breaks the otherwise predictable pattern.

    Tool Count5/5

    Twelve tools are well-scoped for a multi-stage engineering workflow involving inspection, geometry building, planning, execution, monitoring, and results retrieval. Each tool appears to earn its place without obvious redundancy or excessive breadth.

    Completeness4/5

    The surface covers the core lifecycle from environment inspection and geometry setup through case execution, cancellation, and RAO retrieval. Minor gaps exist around listing existing cases or cleaning up completed cases, which agents may need to work around.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Model Context Protocol (MCP) server for offshore robotics, AUV bathymetric survey planning, API 17D / ISO 13628-8 ROV rotary valve intervention interfaces (Class 1 to 7), DNV-RP-B401 cathodic protection evaluation, and ASME PCC-1 subsea bolted flange preloads.
      4
      6 npm
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables natural-language automation of LS-PrePost preprocessing and postprocessing by exposing tools that build and verify shell meshes, query nodes, parts and connectivity, run native commands, SCL and in-application Python, and read d3plot/binout results through pluggable backends. Every job runs in its own directory and returns an ID, status, log and artifacts, so results stay traceable and failures are never silently reported as success.
      30
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to drive OpenFOAM end to end: cloning tutorials or custom cases, editing dictionaries, meshing and running solvers in the background, tracking convergence and job status, and analyzing results. It also renders flow images — slices, patches, streamlines, iso-surfaces and residual or force plots — back to the agent.
      25
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI clients to automate preprocessing workflows, including geometry queries, surface and volume meshing, mesh quality checks, entity/property management, script execution, and task tracking through a native control panel.
      4
      MIT