-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
dce8b86
commit 32da534
Showing
1 changed file
with
8 additions
and
57 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,59 +1,20 @@ | ||
[![CircleCI](https://circleci.com/gh/robomechanics/quad-sdk/tree/main.svg?style=shield)](https://circleci.com/gh/robomechanics/quad-sdk/tree/main) | ||
![Example image](doc/quad_sdk_promo.png) | ||
|
||
## Overview | ||
## Quad-SDK Fork | ||
|
||
Quad-SDK is an open source, ROS-based full stack software framework for agile quadrupedal locomotion. The design of Quad-SDK is focused on the vertical integration of planning, control, estimation, communication, and development tools which enable agile quadrupedal locomotion in simulation and hardware with minimal user changes for multiple platforms. The modular software architecture allows researchers to experiment with their own implementations of different components while leveraging the existing framework. Quad-SDK also offers Gazebo simulation support and a suite of visualization and data-processing tools for rapid development. Refer to the [paper] for high-level details of the framework. | ||
This is a fork of the [Quad-SDK](https://github.com/robomechanics/quad-sdk) repository, used to generate simulated UniTree Go2 data for use with the [MI-HGNN](https://github.com/lunarlab-gatech/Morphology-Informed-HGNN) paper. For the main repository README.md or the documentation for how to use it, please see the original [Quad-SDK](https://github.com/robomechanics/quad-sdk) repository. | ||
|
||
**Keywords:** Legged Robotics, Quadrupeds, Planning, Control, Leaping, ROS | ||
However, we made some alterations to the setup process in order to resolve issues or streamline the process. See the sections below for alterations to the install process and for the list of changes: | ||
|
||
### License | ||
## Install Alterations | ||
|
||
The source code is released under a [MIT License](LICENSE). | ||
### Get HSL solver for IPOPT | ||
|
||
**Authors: Joe Norby, Yanhao Yang, Ardalan Tajbakhsh, Jiming Ren, Justin K. Yim, Alexandra Stutt, Qishun Yu, Nikolai Flowers, and Aaron M. Johnson<br /> | ||
Affiliation: [The Robomechanics Lab at Carnegie Mellon University](https://www.cmu.edu/me/robomechanicslab/)<br /> | ||
Maintainer: Ardalan Tajbakhsh, [email protected]** | ||
On the "1. Getting Started with Quad SDK" page of the [Quad-SDK](https://github.com/robomechanics/quad-sdk) Wiki, it mentions "Get HSL solver for IPOPT". However, you can't install the latest version of the solver, as it has build errors (see Issue #[425](https://github.com/robomechanics/quad-sdk/issues/425)). As of the time of writing, it's unclear whether this is solved, but we worked around it by getting the 2022.11.09 version of the solver. | ||
|
||
The packages in Quad-SDK have been tested under [ROS] Melodic on Ubuntu 18.04. | ||
This is research code, expect that it changes often and any fitness for a particular purpose is disclaimed. | ||
|
||
### Publications | ||
|
||
If you use this work in an academic context, please cite the following publications as relevant: | ||
|
||
* Repository: J. Norby, Y. Yang, A. Tajbakhsh, J. Ren, J. K. Yim, A. Stutt, Q. Yu, N. Flowers, and A. M. Johnson. Quad- | ||
SDK: Full stack software framework for agile quadrupedal locomotion. In ICRA Workshop on | ||
Legged Robots, May 2022. ([paper]) | ||
|
||
@inproceedings{abs:norby-quad-sdk-2022, | ||
author = {Joseph Norby and Yanhao Yang and Ardalan Tajbakhsh and Jiming Ren and Justin K. Yim and Alexandra Stutt and Qishun Yu and Nikolai Flowers and Aaron M. Johnson}, | ||
title = {Quad-{SDK}: Full Stack Software Framework for Agile Quadrupedal Locomotion}, | ||
booktitle = {ICRA Workshop on Legged Robots}, | ||
year = {2022}, | ||
month = {May}, | ||
type = {workshop abstract}, | ||
url_Info = {https://leggedrobots.org/index.html}, | ||
url_PDF = {http://www.andrew.cmu.edu/user/amj1/papers/Quad_SDK_ICRA_Abstract.pdf}, | ||
keywords = {Control,Planning,Leaping} | ||
} | ||
* Global Planner: J. Norby and A. M. Johnson, “Fast global motion planning for dynamic legged robots,” in 2020 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS). IEEE, 2020, pp. 3829–3836. ([paper](https://www.andrew.cmu.edu/user/amj1/papers/IROS2020_Fast_Global_Motion_Planning.pdf)) | ||
|
||
@inproceedings{Norby2020, | ||
title={Fast global motion planning for dynamic legged robots}, | ||
author={Norby, Joseph and Johnson, Aaron M}, | ||
booktitle={2020 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)}, | ||
pages={3829--3836}, | ||
year={2020}, | ||
organization={IEEE} | ||
} | ||
|
||
|
||
|
||
## Installation | ||
|
||
Refer to the [Quad-SDK Wiki](https://github.com/robomechanics/quad-sdk/wiki/1.-Getting-Started-with-Quad-SDK) for installation, dependency, and unit testing information. Currently Quad-SDK requires ROS Melodic on Ubuntu 18.04. All other dependencies are installed with the included setup script. | ||
## Changelog | ||
- | ||
|
||
## Usage | ||
|
||
|
@@ -77,13 +38,3 @@ Run the stack with global planner: | |
roslaunch quad_utils quad_plan.launch reference:=gbpl logging:=true | ||
``` | ||
Refer to the [Wiki](https://github.com/robomechanics/quad-sdk/wiki/2.-Using-the-Software) for more information on alternate usage. | ||
|
||
## Bugs & Feature Requests | ||
|
||
Please report bugs and request features using the [Issue Tracker](https://github.com/robomechanics/quad-sdk/issues). | ||
|
||
|
||
[paper]: https://www.andrew.cmu.edu/user/amj1/papers/Quad_SDK_ICRA_Abstract.pdf | ||
[ROS]: http://www.ros.org | ||
[rviz]: http://wiki.ros.org/rviz | ||
[Eigen]: http://eigen.tuxfamily.org |