How joao-borrego/grasp works
Project Type and Purpose
• This is a robotics simulation toolkit (“GRASP”) for dynamic grasp simulation inside the Gazebo simulator, using the DART physics engine.
• It provides a C++ core library (grasp/), Gazebo plugins (plugins/), message definitions (msgs/), models (models/), configuration files (cfg/), example binaries (examples/), and helper scripts (scripts/, datasets/, utils/).
Architectural Analysis
• Top-level components:
• Core C++ Library (“grasp/”)
• Gazebo Plugins (“plugins/”)
• Protobuf Message Interface (“msgs/”)
• Models & Worlds (“models/”, “worlds/”)
• Configuration Management (“cfg/”)
• Example Executables (“examples/”)
• Data-preparation & Utility Scripts (“scripts/”, “datasets/”, “utils/”)
• Build & Deployment (CMakeLists.txt, cmake/, deps/)
• Architectural patterns:
• Plugin-based extension of Gazebo
• Pub/Sub messaging via Protobuf topics
• Modular CMake build
• Separation of simulation assets (models, worlds) vs. code
• External dependencies:
• Gazebo simulator
• DART physics engine
• Protobuf (for msgs/)
• Python (for scripts, dataset conversion)
Essential Elements to Capture
• All major directories as logical components
• Data flow via Protobuf topics
• Configurable parameters reading from cfg/
• Build/deploy process (CMake, deps/install_deps.sh) as a side note
• Example clients interacting over the message bus
• Model/dataset preprocessing pipeline