Bullet Physics Experiment Software

基于 Bullet 物理引擎的交互式物理实验软件

项目简介

这是一个用于物理教学和实验的交互式仿真软件，支持刚体碰撞、约束连接、实时数据可视化等功能。

技术栈

• 物理引擎: PyBullet 3.25
• GUI框架: PyQt6
• 3D渲染: pyqtgraph (OpenGL)
• 数据可视化: Matplotlib
• 配置管理: YAML

环境要求

• Python 3.9+
• macOS / Windows / Linux

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 运行程序

cd bullet_physics_experiment
python main.py

项目结构

bullet_physics_experiment/
├── core/              # 核心业务逻辑
│   ├── physics_world.py
│   ├── rigid_body.py
│   ├── constraint.py
│   └── core_control.py
├── ui/                # 用户界面
│   ├── main_window.py
│   ├── widget_3d.py
│   ├── widget_plot.py
│   └── widget_params.py
├── config/            # 配置文件
│   └── config.yaml
└── main.py            # 程序入口

功能特性

• ✅ 刚体创建（球体、立方体）
• ✅ 实时物理仿真
• ✅ 3D 可视化
• ✅ 数据图表绘制
• ✅ 实验模板系统
• ✅ 数据导出 (CSV)

开发进度

详见 TASK_PROGRESS_PLAN.md

常见问题

详见 TASK_PROGRESS_PLAN.md - 常见问题与故障排查

许可证

MIT License