03-18-2026, 03:57 PM
(This post was last modified: 03-18-2026, 04:11 PM by ZuoCen_Liu.)
Hi everyone,
I'm sharing a tool I've been working on to address a common headache: the "Simulation-to-Real" gap on the LBR iiwa.
We've all seen paths that look silky smooth in KUKA.Sim (or RoboDK) but cause E-Stops, vibration, or reducer overheating on the physical controller.Â
SIPA (Simulation Integrity & Physics Auditor) is an open-source "black box" auditor that catches these non-physical artifacts early.
It analyzes robot trajectories exported from simulators such as KUKA.Sim and detects non-physical motion artifacts including:
SIPA bridges the gap between 'Perfect Simulation' and 'Violent Reality'.
A quick look at a real-case audit (LBR iiwa 14 R820, 100Hz):
Visual Forensics
![[Image: joint_acc.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/joint_acc.png)
Observation: J2 axis experiences a massive acceleration spike (>600rad/s2) near frame 60.
![[Image: z_jitter.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/z_jitter.png)
Observation: High-frequency jitter in the Z-axis exceeds 10 mm,indicating potential solver instability.
![[Image: tcp_heatmap.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/tcp_heatmap.png)
Observation: Yellow/Pink clusters indicate localized instability zones in the working envelope.
![[Image: tcp_3d_path.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/tcp_3d_path.png)
Observation: The 3D path shows geometric continuity, but hides the underlying physical jitter.
Try it in 30 seconds (No install needed):
I've set up a GitHub Codespaces environment so you can run the demo audit directly in your browser without installing Python locally:
👉 https://github.com/ZC502/SIPA
I'm eager to hear if this helps with your welding, gluing, or force-control paths. If you have "problematic" CSVs that crash your iiwa but look fine in sim, I'd love to run them through SIPA to see if we can identify the fingerprint.
Happy auditing!
Cross-posted on X here:
https://x.com/liu_zc42321/status/2034189...68136?s=20
I'm sharing a tool I've been working on to address a common headache: the "Simulation-to-Real" gap on the LBR iiwa.
We've all seen paths that look silky smooth in KUKA.Sim (or RoboDK) but cause E-Stops, vibration, or reducer overheating on the physical controller.Â
SIPA (Simulation Integrity & Physics Auditor) is an open-source "black box" auditor that catches these non-physical artifacts early.
It analyzes robot trajectories exported from simulators such as KUKA.Sim and detects non-physical motion artifacts including:
- TCP discontinuous jumps
- Z-axis micro jitter
- joint acceleration spikes
- workspace instability regions
SIPA bridges the gap between 'Perfect Simulation' and 'Violent Reality'.
A quick look at a real-case audit (LBR iiwa 14 R820, 100Hz):
Code:
SIPA v2.2 Industrial Solver Audit
Robot: KUKA LBR iiwa 14 R820
Frames: 125
TCP Z Jitter
------------
Std amplitude: 10.96 mm
TCP Jump Events
---------------
124
Frame 0 Jump 84.22 mm
Frame 1 Jump 71.44 mm
Frame 2 Jump 67.84 mm
Frame 3 Jump 73.64 mm
Frame 4 Jump 85.40 mm
Diagnosis: micro oscillation detected
Possible solver divergenceVisual Forensics
![[Image: joint_acc.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/joint_acc.png)
Observation: J2 axis experiences a massive acceleration spike (>600rad/s2) near frame 60.
![[Image: z_jitter.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/z_jitter.png)
Observation: High-frequency jitter in the Z-axis exceeds 10 mm,indicating potential solver instability.
![[Image: tcp_heatmap.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/tcp_heatmap.png)
Observation: Yellow/Pink clusters indicate localized instability zones in the working envelope.
![[Image: tcp_3d_path.png]](https://raw.githubusercontent.com/ZC502/SIPA/e4927cb114a8d3b0cedeb3542794c28b34fb9fa5/demo/tcp_3d_path.png)
Observation: The 3D path shows geometric continuity, but hides the underlying physical jitter.
Try it in 30 seconds (No install needed):
I've set up a GitHub Codespaces environment so you can run the demo audit directly in your browser without installing Python locally:
👉 https://github.com/ZC502/SIPA
I'm eager to hear if this helps with your welding, gluing, or force-control paths. If you have "problematic" CSVs that crash your iiwa but look fine in sim, I'd love to run them through SIPA to see if we can identify the fingerprint.
Happy auditing!
Cross-posted on X here:
https://x.com/liu_zc42321/status/2034189...68136?s=20
