Giter Club home page Giter Club logo

open-quadruped's Introduction

open-quadruped

Maintenance PR Open Source Love png2 MIT license

An open-source 3D-printed quadrupedal robot. Intuitive gait generation through 12-DOF Bezier Curves. Full 6-axis body pose manipulation. Custom 3DOF Leg Inverse Kinematics Model accounting for offsets.

Current Status

To-Do List

  • Hardware // Redesign legs to move actuators closer to hip + reinforce all servo mounting.
  • Design // Research transition between gait & body pose.
  • Software // Implementing ROS infrastructure for all control processes (including cpp on teensy).
  • Software // Write & automate pytest unit tests.
  • Software // Integrate unit tests with github actions.
  • Simulation // Create URDF model. (or port collaborater's URDF: Maurice Rahme)
  • Simulation // Gazebo
  • Simulation // RViz Realtime Model
  • Design // Solve offset 3DOF IK model for right limbs OR validate that mirroring angles works for left/right legs
  • Simulation // Implement WebGazebo clientside support for non-linux users
  • Sim-to-Real // Joint servo calibration
  • Sim-to-Real // Refining gait parameters
  • Simulation // Reinforcement learning via ARS
  • Software // Raibert Huerestic for converting desired velocities into gait parameters
  • Software // ROS Nav Stack Layer

Papers

I've been formally documenting this project in the form of papers. You can find them here: adhamelarabawy.com/pdf/IK_Model.pdf

Documentation

You can find a summary of this project on my portfolio website's project page. I'm hosting most of the technical documentation for this project on this repo's wiki.

3D Model

In the model folder, you can find all of the step & stl files that I used for my build of OpenQuadruped. There, you can also find a Bill of Materials, and some guides (in progress).

Hardware

I made a custom pcb board to control the position and speed of 12 servos simultaneously, as well as interface with all of the sensors.

You can find the gerber files for the custom pcb in the hardware folder in this repository.

You can find the bill of materials for this project here.

Visualization Usage

NOTE: There are 3 different visualization tools: Gazebo Simulator (ROS + Physics), RViz (ROS), & my custom 3d-matplotlib visualization tool (body IK model + leg IK model). The latter tool is still under development, and I haven't ported it to use my new control library yet, so it is likely broken for the time being.

To try the visualization tool out, you'll need to run the animate.py python file with the proper libraries installed. (matplotlib 3.0.3 supported).

You can then use keyboard controls: use x, y, z, a, p, r to select (x axis, y axis, z axis, yaw, pitch, roll), and then the up and down buttons to increment the selected position. If you click '1' on your keyboard, it will reset the position.

Right now, if you try to go to an impossible pose that would result in collisions, the body will do some weird things. If that happens, just click "1" on your keyboard to reset the position.

Note: Pitch and Roll are currently not working. I am currently trying to fix that.

More Demos

Force Sensitive Leg TestIK Model Demo 0IK Model Demo 1IK Model Visualization

open-quadruped's People

Contributors

adham-elarabawy avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.