Newton物理引擎入门指南：从安装到第一个仿真场景的完整步骤

Newton物理引擎入门指南：从安装到第一个仿真场景的完整步骤

【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton

Newton是一款基于NVIDIA Warp构建的开源GPU加速物理仿真引擎，专为机器人学家和仿真研究人员设计。本指南将帮助新手快速掌握Newton的安装方法，并通过简单步骤创建第一个物理仿真场景，体验GPU加速带来的高效仿真效果。

📋 系统准备与环境要求

在开始安装Newton之前，请确保您的系统满足以下基本要求：

最低配置要求

• Python：3.10或更高版本（推荐3.11+）
• 操作系统：Linux（x86-64/aarch64）、Windows（x86-64）或macOS（仅CPU模式）
• NVIDIA GPU：计算能力5.0+（Maxwell架构，如GeForce GTX 9xx系列或更新）
• NVIDIA驱动：545或更高版本（推荐550+以获得最佳性能）
• CUDA：12或13（无需本地CUDA工具包，Warp会捆绑运行时）

⚠️注意：macOS系统仅支持CPU模式，部分高级特性如SDF碰撞、网格接触等将不可用。

推荐配置

• GPU：NVIDIA Ada Lovelace或Blackwell架构
• CUDA版本：12.4+（支持CUDA图捕获，提升性能）
• Python版本：3.12+

🚀 快速安装步骤

Newton提供多种安装方式，推荐使用PyPI进行快速安装。以下是针对不同操作系统的安装指南：

基础安装

pip install newton

完整安装（含示例和可视化依赖）

pip install "newton[examples]"

虚拟环境安装（推荐）

Linux/macOS

python -m venv .venv source .venv/bin/activate pip install "newton[examples]"

Windows（命令提示符）

python -m venv .venv .venv\Scripts\activate.bat pip install "newton[examples]"

Windows（PowerShell）

python -m venv .venv .venv\Scripts\Activate.ps1 pip install "newton[examples]"

💡提示：Python 3.10用户安装examples时可能遇到imgui_bundle依赖问题，建议升级Python版本或参考开发指南使用uv工具安装。

🔍 验证安装与运行示例

安装完成后，您可以通过运行内置示例来验证安装是否成功：

启动示例浏览器

python -m newton.examples

这将打开Newton的示例浏览器，默认加载basic_pendulum示例。您可以通过侧边面板浏览其他示例场景。

Newton示例浏览器展示了多种物理仿真场景，包括基础几何体和复杂机器人模型

运行特定示例

例如，运行传送带仿真示例：

python -m newton.examples basic_conveyor

Newton物理引擎的传送带仿真场景，展示了物体在传送带上的运动和碰撞效果

查看所有可用示例

python -m newton.examples --list

🎯 创建第一个仿真场景

下面我们将通过一个简单的示例，展示如何使用Newton创建并运行一个基本的物理仿真场景。

基本仿真流程

Newton的典型工作流程包括以下步骤：

1. 构建模型
2. 创建求解器
3. 初始化状态
4. 运行仿真循环

代码示例：创建简单摆锤

import warp as wp import newton # 1. 构建模型 builder = newton.ModelBuilder() builder.add_ground_plane() # 添加地面 # 添加摆锤（简化代码，实际需定义关节和几何体） model = builder.finalize() # 2. 创建求解器 solver = newton.solvers.SolverMuJoCo(model) # 3. 初始化状态 state_0 = model.state() state_1 = model.state() control = model.control() contacts = model.contacts() # 4. 运行仿真 for step in range(1000): state_0.clear_forces() model.collide(state_0, contacts) solver.step(state_0, state_1, control, contacts, 1.0 / 60.0 / 4.0) state_0, state_1 = state_1, state_0

📚参考：完整的摆锤示例代码可在newton/examples/basic/example_basic_pendulum.py中找到。

🤖 高级应用：机器人仿真

Newton特别适合机器人仿真，支持复杂机器人模型和并行仿真。以下是一个四足机器人仿真的示例：

安装机器人仿真依赖

# 根据您的CUDA版本选择合适的PyTorch安装命令 pip install newton[torch-cu12] --extra-index-url https://download.pytorch.org/whl/cu128

运行Anymal四足机器人仿真

python -m newton.examples robot_anymal_c_walk

Newton物理引擎模拟Franka机械臂与柔性布料的交互

🧩 核心模块与功能

Newton提供了丰富的模块，支持各种物理仿真需求：

• 动力学求解器：newton/solvers/

  • 支持MuJoCo、XPBD、Style3D等多种求解器
  • GPU加速的并行仿真能力

• 机器人学：newton/_src/sim/ik/

  • 逆运动学求解
  • 机器人控制与规划

• 传感器模拟：newton/sensors.py

  • 接触传感器
  • IMU传感器
  • tiled相机传感器

• 可视化工具：newton/viewer.py

  • 实时3D可视化
  • 仿真录制与回放

📚 学习资源与下一步

官方文档

• 安装指南：详细的安装说明和系统要求
• 开发指南：贡献代码和高级安装方法
• 示例教程：逐步学习Newton的核心功能

推荐示例

• 布料仿真：python -m newton.examples cloth_hanging
• 软体仿真：python -m newton.examples softbody_hanging
• 碰撞检测：python -m newton.examples contacts_rj45_plug

Newton物理引擎模拟Franka机械臂抓取软体物体

❓ 常见问题解答

Q: 如何解决CUDA版本不兼容问题？

A: 运行nvidia-smi查看支持的CUDA版本，然后安装对应版本的PyTorch，例如：

pip install torch==2.6.0 --extra-index-url https://download.pytorch.org/whl/cu124

Q: macOS上可以使用GPU加速吗？

A: 不可以，macOS仅支持CPU模式，部分高级特性将不可用。

Q: 如何导入自己的URDF/USD模型？

A: 使用ModelBuilder的add_urdf()或add_usd()方法，例如：

builder = newton.ModelBuilder() builder.add_urdf("my_robot.urdf")

通过本指南，您已经了解了Newton物理引擎的基本安装和使用方法。现在，您可以开始探索更多高级功能，创建自己的物理仿真场景了！无论是机器人控制、柔性体仿真还是复杂的多体动力学问题，Newton都能为您提供高效的GPU加速仿真支持。

【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton