Skip to content
This repository has been archived by the owner on Jan 13, 2025. It is now read-only.

Commit

Permalink
Update README to VHIP walking
Browse files Browse the repository at this point in the history
  • Loading branch information
stephane-caron committed Sep 22, 2019
1 parent f633b47 commit 830fc95
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 55 deletions.
5 changes: 4 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,14 @@

All notable changes to this project will be documented in this file.

## Unreleased
## [vhip\_walking\_controller v0.8] - 2019/09/22

### Added

- Desired wrench can be computed with both VHIP or LIPM reduced models
- HRP4ForceCalibrator to decouple normal force and torques while standing
- Stability condition for DCM proportional gain ``k > 1``
- Vertical CoM admittance control to regulate virtual leg stiffness of VHIP

### Changed

Expand Down
3 changes: 1 addition & 2 deletions COMMITS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,5 +10,4 @@ This file lists dependency commits of a consistent build of the project:
* [copra](https://github.com/vsamy/copra): ``baa07aa79217bd4aeaeff04fe5c7596b782e9c30``
* [mc\_rtc\_ros\_data](https://gite.lirmm.fr/multi-contact/mc_rtc_ros_data): ``cc065c64927c500cd45e358bb97a28fda6bae52d``
* [mc\_rtc\_ros](https://gite.lirmm.fr/multi-contact/mc_rtc_ros): ``881c26de335c76a4c082cd6648662a39180a59b4``
* [mc\_rtc](https://gite.lirmm.fr/multi-contact/mc_rtc): ``5a85f58f1558f5894aba2bf1b7522cf4370ebf7f``
* [tvm](https://github.com/jrl-umi3218/tvm): ``a74f84dac6aa8b17f3f235f3ca24bcf1c1abbc7ea``
* [mc\_rtc](https://gite.lirmm.fr/multi-contact/mc_rtc): ``1e9eabc6c839996ffc3ca3cbcb22cacd218b395c``
58 changes: 6 additions & 52 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,11 @@
# VHIP Walking Controller

[![Stair climbing by the HRP-4 humanoid robot](https://scaron.info/images/stair-climbing.jpg)](https://www.youtube.com/watch?v=vFCFKAunsYM)
Source code of the controller used in the experiments of [Biped Stabilization by Linear Feedback of the Variable-Height Inverted Pendulum Model](https://hal.archives-ouvertes.fr/hal-02289919/document).

Source code of the walking and stair climbing controller used in the experiments of [Stair Climbing Stabilization of the HRP-4 Humanoid Robot using Whole-body Admittance Control](https://hal.archives-ouvertes.fr/hal-01875387/document).
## Ressources

## Installation
See the documentation of the [LIPM walking](https://github.com/stephane-caron/lipm_walking_controller) controller:

Compilation has been tested on Ubuntu 14.04 (gcc/clang) with ROS Indigo and Ubuntu 16.04 (gcc) with ROS Kinetic.

### Dependencies

Compilation requires:

* [ROS](http://www.ros.org/) with a working [catkin workspace](http://wiki.ros.org/catkin/Tutorials/create_a_workspace)
* [SpaceVecAlg](https://github.com/jrl-umi3218/SpaceVecAlg): spatial vector algebra
* [RBDyn](https://github.com/jrl-umi3218/RBDyn/): rigid body dynamics
* [eigen-lssol](https://gite.lirmm.fr/multi-contact/eigen-lssol): quadratic programming (if you have the LSSOL licence ask us this library)
* [eigen-qld](https://github.com/jrl-umi3218/eigen-qld): quadratic programming
* [sch-core](https://github.com/jrl-umi3218/sch-core): collision detection
* [Tasks](https://github.com/jrl-umi3218/Tasks/): inverse kinematics
* [mc\_rbdyn\_urdf](https://github.com/jrl-umi3218/mc_rbdyn_urdf): robot model loader
* [copra](https://github.com/vsamy/copra): linear model predictive control
* [tvm](https://github.com/jrl-umi3218/tvm): modeling language for linear control problems

The following dependencies are not publicly released yet but available upon request to [Pierre Gergondet](mailto:[email protected]):

* [mc\_rtc](https://gite.lirmm.fr/multi-contact/mc_rtc): robot controller library (includes mc\_control, mc\_rbdyn, mc\_solver and mc\_tasks)
* [mc\_rtc\_ros](https://gite.lirmm.fr/multi-contact/mc_rtc_ros): ROS tools for mc\_rtc
* [mc\_rtc\_ros\_data](https://gite.lirmm.fr/multi-contact/mc_rtc_ros_data): ROS environment and object descriptions for mc\_rtc

### Building from source on Linux

Link `vhip_walking_controller` from the source folder of your catkin workspace, then follow the standard catkin workflow:
```sh
catkin_make -DCMAKE_BUILD_TYPE=RelWithDebInfo && catkin_make install
```
To avoid a ``sudo`` at ``catkin_make install`` you can change ownership or permissions of the ``/usr/local/lib/mc_controller`` folder.

## Usage

First, launch RViz for the HRP-4 model by:
```sh
roslaunch vhip_walking_controller display.launch robot:=hrp4
```
Enable the controller in your mc\_rtc configuration:
```sh
{
"MainRobot": "HRP4",
"Enabled": ["VHIPWalking"]
}
```
Finally, run your mc\_rtc interface, for instance ``mc_vrep`` or ``MCUDPControl``.

## Thanks

To [@gergondet](https://github.com/gergondet) for developing and helping with the mc\_rtc framework.
- [Installation](https://github.com/stephane-caron/lipm_walking_controller#installation)
- [Usage](https://github.com/stephane-caron/lipm_walking_controller#usage)
- [Wiki](https://github.com/stephane-caron/lipm_walking_controller/wiki)

0 comments on commit 830fc95

Please sign in to comment.