Experimental visual-feedback layer for robotic servo dynamics research.
This repository is intended to sit above simulator/control backends such as
SO101_CoppeliaSim. The simulator backend should be added as a git submodule
under thirdparty/SO101_CoppeliaSim, while this repository owns visual
observation capture, synchronized metadata, and feedback-loop experiments.
- Connect to simulator/control backends through their public APIs.
- Capture visual observations synchronized with simulation time and servo telemetry.
- Store experiment artifacts in reproducible CSV/JSON/JSONL layouts.
- Evaluate how visual feedback delay, noise, and estimation errors affect servo motion quality.
VisionServoLab/
├── configs/ # Experiment configuration files
├── results/ # Local experiment outputs, ignored by git
├── scripts/ # Thin user-facing commands
├── src/vision_servo_lab/ # Python package
├── tests/ # Unit tests
└── thirdparty/ # External repositories, including simulator submodules
After creating the GitHub repository for the simulator backend, add it as a submodule:
git submodule add <SO101_CoppeliaSim_GIT_URL> thirdparty/SO101_CoppeliaSim
git submodule update --init --recursiveKeep submodule changes explicit: this repository should normally track a known commit of the backend rather than relying on uncommitted backend edits.
uv sync
uv run python -m unittest discover -s tests -vGitHub Actions runs:
uv lock --check
uv run python -m unittest discover -s tests -v
git diff --check