rover-contact-grc1-viper:月球车轮-土接触力PINN代理模型完全指南,一文读懂它在做什么

【免费下载链接】rover-contact-grc1-viper

项目地址:https://ai.gitcode.com/hf_mirrors/PINNeAPPle-Labs/rover-contact-grc1-viper
点击查看免费下载

rover-contact-grc1-viper是一个开源的月球车轮-土接触力PINN(物理信息神经网络)代理模型:只需输入车轮的"滑转率 slip"和"沉陷量 sinkage"两个数值,它就能瞬间输出 NASA VIPER 月球车车轮在 GRC-1 月壤模拟物上的牵引力、法向力和驱动扭矩,是经典 Wong-Reece 地力学公式的"数字替身"。

🌙一句话定位:它不是从零训练的黑箱网络,而是把经典刚轮地力学模型(Wong-Reece)当作"老师",用 4 层小型神经网络蒸馏其输出,并在训练中注入 4 条真实物理约束,最终通过了 12/12 项信任检查,拿到 APPROVED(1.00 分)评级。

为什么需要车轮-土接触力模型?

月球车在月壤上行驶时,车轮与土壤的相互作用决定了牵引、阻力与沉陷。用经典地力学公式逐步数值求解比较慢,而 PINN 代理模型一次前向传播只需微秒级,适合嵌进月球车运动仿真、能耗估算或控制算法里反复调用。

这个代理模型的两个"加分项":

  • 网络结构:随机傅里叶特征 + 残差 tanh MLP(4 块 × 96 神经元),傅里叶特征帮助它拟合接触力曲线的快速变化;
  • 物理约束:训练时用 4 条"软约束"把物理定律写进网络(见下表),避免它学出违背常识的力。

训练时内置的 4 条物理约束

约束物理含义
dFz/dz >= 0沉陷越深,土壤法向支撑力越大,不能越陷越小
dFx/ds >= 0(slip ≤ 0.3)牵引力随滑转的变化方向须与物理参考一致
Mohr-Coulomb 极限Fx ≤ cA + Fz·tan(φ),牵引力不能超过土壤剪切强度
My >= R·Fx驱动扭矩至少要能产生牵引力对应的力矩

输入输出:2 进 3 出,一目了然

输入(2 个)

名称单位含义
slip–纵向滑转率(负值表示打滑 skid)
sinkage_mm车轮静沉陷 + 滑转沉陷

输出(3 个)

名称单位含义
Fx_NN牵引力(drawbar pull)
Fz_NN土壤承担的法向载荷
My_NmN·m驱动扭矩

有效范围:先记住这几个边界,别越界使用

项目范围 / 取值
slip[-0.4, 0.9]
sinkage_m[0.002, 0.06] m
土壤GRC-1 月壤模拟物(黏聚力 c = 250 Pa,内摩擦角 φ = 38°)
车轮VIPER 车轮:半径 R 0.25 m,宽 b 0.20 m,24 个防滑齿
侧偏角0°(纯纵向行驶,无侧向力)

⚠️ 超出范围查询时,pinneapple库会主动告警——模型只在自己的有效范围内做承诺。

有多准?一组可复核的数字

验证集为 2000 个与训练集完全隔离的拉丁超立方采样状态,参考值是 Wong-Reece 模型的自适应数值积分解析解:

指标数值
test/Fx_rmse_N(牵引力 RMSE)0.22 N
test/Fz_rmse_N(法向力 RMSE)0.47 N
test/My_rmse_Nm(扭矩 RMSE)0.07 N·m
R²(三个输出)≈ 0.999999

同时信任报告判定APPROVED(分数 1.00、覆盖率 100%):12 项适用的物理与数据检查全部通过,4 条软约束在整张验证网格上零违反,训练/测试数据无泄漏、无重复。完整指标见 model_card.json。

快速上手:3 行 Python 跑通月球车接触力预测

如果需要获取模型文件,可以先克隆仓库:

git clone https://gitcode.com/hf_mirrors/PINNeAPPle-Labs/rover-contact-grc1-viper

然后安装官方库并预测:

pip install pinneapple
import pinneapple as pp model = pp.zoo.load("rover_contact_grc1_viper") # 权重按 SHA-256 自动校验 out = model.predict({"slip": -0.00237311, "sinkage_m": 0.0121651}) print({k: round(float(v[0]), 6) for k, v in out.items()}) # {'Fx_N': -10.081497, 'Fz_N': 165.083856, 'My_Nm': 2.054259}

对同一输入,Wong-Reece 参考值为 Fx ≈ -10.47 N、Fz ≈ 167.45 N、My ≈ 2.18 N·m,代理模型偏差仅约 0.4 N。这条输入输出样例连同pass判定结论,记录在 example.json 中。

📌 防篡改设计:pp.zoo.load会把仓库里每个文件与模型卡记录的 SHA-256 逐一比对,文件被改动过就拒绝加载。

ONNX 版:自带前后处理的独立计算图

不在 PyTorch 生态里也能跑。model.onnx(opset 17)输入x(形状(n, 2)的 float32,列为slip、sinkage_m),直接输出物理单位的Fx_N、Fz_N、My_Nm——归一化/反归一化已内嵌在图中,与 PyTorch 版最大差异仅 5.6e-07。注意:ONNX 图不包含有效范围与物理检查,需自行核对输入边界。

文件清单:仓库里每个文件都是干什么的

文件作用
weights.ptPyTorchstate_dict权重,pp.zoo.load读取的就是它
model.safetensors同一份权重的 safetensors 格式副本
model.onnxONNX 计算图(含前后处理)
config.json网络结构、输入输出归一化边界 + 完整物理配置(土壤/车轮/重力 1.62 m/s²)
model_card.json模型卡:输入输出、有效范围、验证指标、信任报告
example.json完整示例:输入、输出、参考值与判定
README.md项目说明文档(含全部指标与使用示例)

已知局限:使用前的 3 个提醒

  • 上限取决于 Wong-Reece 公式本身:对照公开发表的单轮试验,Wong-Reece 的牵引力 RMSE 为 4–14 N,大于代理模型自身的误差——它精确复现的是物理公式,不是真实月壤;
  • 单一土壤、单一车轮:GRC-1 + VIPER 车轮,侧偏角 0°,稳态工况,无侧向力输出;
  • 零滑转处有"拐角":滑转-沉陷机制让力曲线在 slip = 0 处出现折点,网络会在一小段滑转区间内把它抹平。

小结

rover-contact-grc1-viper 展示了一套"物理信息代理模型"的完整样板:经典地力学公式当老师、小网络 + 物理约束做蒸馏、SHA-256 校验 + 信任报告 + 物理检查为每次预测提供独立审计。🛞 如果你在做月球车运动仿真、能耗估算或控制器开发,它能让"车轮现在受多大的力"这类问题在微秒级得到可信答案。

【免费下载链接】rover-contact-grc1-viper

项目地址:https://ai.gitcode.com/hf_mirrors/PINNeAPPle-Labs/rover-contact-grc1-viper
点击查看免费下载
上一篇:Angular Components性能监控工具:识别与解决性能问题
下一篇:解锁Label Studio全潜力:插件市场探索与安装指南

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

内网离线部署DeepSeek:从模型导入到RAG与安全加固

内网离线部署DeepSeek:从模型导入到RAG与安全加固

简介:面向政企单位IT运维人员与技术爱好者的DeepSeek内网离线部署指南,专门解决无互联网接入环境下建设私有AI知识库的痛点,覆盖离线资源准备、环境部署、数据投喂到权限管理全流程,并突出国产化操作系统、CPU架构与硬件兼容适配。…

2026/10/20 10:35:16 阅读更多 →
GLM-4.6V-Flash-GGUF完全介绍:如何在本地免费运行9B多模态视觉大模型?

GLM-4.6V-Flash-GGUF完全介绍:如何在本地免费运行9B多模态视觉大模型?

【免费下载链接】GLM-4.6V-Flash-GGUF 项目地址: https://ai.gitcode.com/hf_mirrors/unsloth/GLM-4.6V-Flash-GGUF 点击查看 免费下载 GLM-4.6V-Flash-GGUF 是由 unsloth 提供的 GLM-4.6V-Flash(9B)多模态视觉大模型 GGUF 量化合集&#xf…

2026/10/20 10:35:16 阅读更多 →
Frappe LMS 多语言配置指南:3步跑通国际化

Frappe LMS 多语言配置指南:3步跑通国际化

Frappe LMS 多语言配置指南:3步跑通国际化 【免费下载链接】lms Easy to Use, 100% Open Source Learning Management System 项目地址: https://gitcode.com/GitHub_Trending/lms1/lms 给学员上线一门课,界面却全是英文,海外用户基本…

2026/10/20 10:35:16 阅读更多 →

最新新闻

轮胎侧偏刚度在线辨识:递归最小二乘法的车辆动力学实践

轮胎侧偏刚度在线辨识:递归最小二乘法的车辆动力学实践

1. 为什么死磕轮胎侧偏刚度?先从问题背景和方案选型说起1.1 侧偏刚度在车辆动力学里的“地基”地位做车辆动力学控制的人应该都有这种感觉:很多看似高大上的功能——ESP车身稳定控制、主动转向、自动驾驶的轨迹跟踪、底盘域控制器的状态观测——拆到最底…

2026/10/20 22:57:55 阅读更多 →
从unittest到pytest:fixture、参数化与断言内幕实战解析

从unittest到pytest:fixture、参数化与断言内幕实战解析

1. 从 unittest 转向 pytest:一次测试框架选型的真实复盘先说个背景。前阵子我接手了团队里一套老项目的回归测试,代码量不大,但里面大几十个用例全是基于 unittest 写的。写起来难受,跑起来也难受——每个测试类都要手动继承 Tes…

2026/10/20 22:57:55 阅读更多 →
Forge-1.20.1模组开发实战:从工程搭建到Mixin字节码注入

Forge-1.20.1模组开发实战:从工程搭建到Mixin字节码注入

简介:本资源是专为Minecraft模组开发者提供的Forge 1.20.1官方MDK(Mod Development Kit)开发套件,适用于Java基础扎实、希望基于Minecraft 1.20.1版本进行模组创作的中高级开发者。它封装了完整的Gradle构建环境与标准项目结构&am…

2026/10/20 22:57:55 阅读更多 →
免费查AI率工具实测:原理、误区与防坑指南

免费查AI率工具实测:原理、误区与防坑指南

最近“查AI率”这词在学术圈里简直成了高频热词。不管是写课程论文的本科生,还是赶毕业设计的硕士博士,甚至是在职评职称发论文的老师,几乎人人都在问同一个问题:我这稿子,到底有没有被判定成“AI写的”?这…

2026/10/20 22:57:55 阅读更多 →
Flink核心机制:窗口、状态与检查点的原理与实战调优

Flink核心机制:窗口、状态与检查点的原理与实战调优

我最早接触 Flink 的时候,第一感觉是:这不就是加强版的流处理框架吗?用了一段时间才反应过来,真正决定你能不能把 Flink 用好的,不是它有多快,而是你到底把握没把握住它那三个"骨架级"概念——Wi…

2026/10/20 22:57:55 阅读更多 →
C++智能指针循环引用检测与修复:从内存泄露到工程实践

C++智能指针循环引用检测与修复:从内存泄露到工程实践

说实话,我第一次在正式项目里撞上shared_ptr循环引用,并不是因为查内存泄漏教程,而是因为一段“怎么看都正常”的代码把服务的常驻内存从300M干到了3个G。当时所有人盯着监控面板都觉得是哪里new了没delete,结果用valgrind一跑&am…

2026/10/20 22:56:49 阅读更多 →

日新闻

CLRC663芯片Pin-to-Pin替代实战:从评估到量产全记录

CLRC663芯片Pin-to-Pin替代实战:从评估到量产全记录

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 1:01:30 阅读更多 →
ESP32舵机控制指南:原理、多路驱动与避坑实战

ESP32舵机控制指南:原理、多路驱动与避坑实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 1:01:30 阅读更多 →
位移法实现一阶低通滤波:单片机ADC采样降噪实战

位移法实现一阶低通滤波:单片机ADC采样降噪实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 1:01:30 阅读更多 →

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/20 10:02:13 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/20 20:43:59 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/20 2:50:50 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 10:02:08 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:17 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:45 阅读更多 →