physics-tuning

Tune Gazebo physics parameters to stabilize ROS 2 simulations.

18|2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill physics-tuning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: physics-tuning
Source: https://github.com/wimblerobotics/ros2-copilot-skills/tree/main/physics-tuning
Command: npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill physics-tuning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tune Gazebo physics settings to resolve instability, jitter, tunneling, and unrealistic dynamics in Gazebo simulations.

Core Features & Use Cases

  • Step Size Tuning: adjust max_step_size for accuracy vs. performance.
  • Solver & Collision Config: configure DART solver, collision detectors, and contact parameters.
  • Real-Time Factor optimization: diagnose and improve real-time factor (RTF) for Gazebo runs.
  • Inertia, Friction & Mass Distribution: calibrate inertia, friction, and mass distribution for realism.
  • Common Problems & Fixes: help identify and fix stability issues and performance bottlenecks.

Quick Start

Begin by lowering max_step_size to 0.001 and iteratively adjust solver parameters while observing the real-time factor and stability in your Gazebo world.

Frequently Asked Questions about physics-tuning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Gazebo simulation instability and jitter?

To fix Gazebo simulation instability, lower the max_step_size to 0.001 and iteratively adjust solver parameters while observing the real_time_factor and contact settings in your physics engine.

What causes tunneling and unrealistic dynamics in Gazebo physics?

Tunneling and unrealistic dynamics in Gazebo physics are typically caused by uncalibrated inertia, improper mass distribution, or incorrect friction settings, requiring systematic stability analysis and parameter tuning to resolve.

How do I tune the DART solver and collision detectors in Gazebo?

Tune the DART solver and collision detectors in Gazebo by configuring contact parameters and solver settings, adjusting them iteratively alongside max_step_size to balance simulation accuracy and performance.

How do I improve real_time_factor performance in ROS 2 Gazebo projects?

Improve real_time_factor (RTF) performance in ROS 2 Gazebo projects by diagnosing performance bottlenecks during stability analysis and modifying max_step_size, solver settings, and friction parameters for optimal speed.

Can I apply Gazebo physics tuning to mobile robotics and manipulation tasks?

Yes, Gazebo physics tuning applies to ROS 2 Gazebo projects across robot dynamics, manipulation, and mobile robotics, calibrating inertia, friction, and mass distribution to achieve realistic and stable simulations.

Why does lowering max_step_size help with Gazebo physics stability?

Lowering max_step_size helps Gazebo physics stability by increasing simulation accuracy, which reduces jitter and tunneling, though it must be balanced against real_time_factor performance to avoid bottlenecks.