https://github.com/ami-iit/paper_elobaid_2023_icra_walking_with_payloads

https://github.com/ami-iit/paper_elobaid_2023_icra_walking_with_payloads

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.6%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: ami-iit
  • Language: C++
  • Default Branch: main
  • Size: 457 KB
Statistics
  • Stars: 5
  • Watchers: 3
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 3 years ago · Last pushed about 3 years ago
Metadata Files
Readme

README.md

Online Non-linear Centroidal MPC for Humanoid Robots Payload Carrying with Contact-Stable Force Parametrization

Mohamed Elobaid, Giulio Romualdi, Gabriele Nava, Lorenzo Rapetti, Hosameldin Awadalla Omer Mohamed, Daniele Pucci

IEEE International Conference of Robotics and Automation (ICRA), 2023
installation | usage | pre-print | youtube

https://github.com/ami-iit/paperelobaid2023icrawalkingwithpayloads/assets/36491318/fdda31c2-f015-4539-8252-d29681b9eefb

Abstract

In this paper we consider the problem of allowing a humanoid robot that is subject to a persistent disturbance, in the form of a payload-carrying task, to follow given planned footsteps. To solve this problem, we combine an online nonlinear centroidal Model Predictive Controller - MPC with a contact stable force parametrization. The cost function of the MPC is augmented with terms handling the disturbance and regularizing the parameter. The performance of the resulting controller is validated both in simulations and on the humanoid robot iCub. Finally, the effect of using the parametrization on the computational time of the controller is briefly studied.

Installation

The main difference with respect to the original centroidal-mpc is not on the application side, but on the bipedal-locomotion-framework side. In our case we build a version of the framework that implements the parametrized Reduced model controllers component.

General dependencies and robotology-superbuild

It is recommended that you follow the installation guidelines for the robotology-superbuild

Make sure that you set in the CMake options, the following profiles are set

- ROBOTOLOGY_USES_GAZEBO - ROBOTOLOGY_ENABLE_DYNAMICS - ROBOTOLOGY_ENABLE_DYNAMICS_FULL_DEPS

Ad-hoc installation guidelines

Once the robotology-superbuild installation is followed correctly. You need to follow the following instructions

clone this repo

then clone this repo

git clone https://github.com/ami-iit/paper_elobaid_2023_icra_walking_with_payloads.git

then go to the bipedal-locomotion-framework repo

cd /where/you/cloned/robotology-superbuild/src/bipedal-locomotion-framework/src git checkout feature/CentroidalMPC

You need to replace the contents of the folder ReducedModelControllers in the bipedal-locomotion-framework with the folder of the same name found in this repo, then

cd /where/you/cloned/robotology-superbuild/builde/src/bipedal-locomotion-framework cmake . [sudo] make && make install the sudo option in case the CMAKE_INSTALL_PREFIX was not set to a local path.

Now we clone and build the application provided in this repo

cd /where/you/cloned/this/repo/application && mkdir build cd build ccmake .. [sudo] make && make install

Finally, to be able to use the gazebo worlds provided by this repo, you need to set the following environment variables

``` export YARPDATADIRS=$YARPDATADIRS:/where/you/installed/this/repo/application/world/centroidalmpcergocub

export GAZEBOMODELPATH=$GAZEBOMODELPATH:/where/you/installed/this/repo/application/world/centroidalmpcergocub ```

Usage

To use the application and reproduce the experiments, follow the instructions below

  1. set up the robot name

export YARP_ROBOT_NAME="icubGazeboV3"

  1. run a yarpserver

yarpserver --write

  1. launch the gazebo world

export YARP_CLOCK=/clock gazebo -slibgazebo_yarp_clock.so /where/you/installed/this/repo/application/world/world

  1. run a yarprobotinterface

YARP_CLOCK=/clock yarprobotinterface --config launch-wholebodydynamics.xml

  1. run the application using the correct config files

``` cd /where/you/installed/this/repo/application/src/centroidal-mpc-walking/config/robots/iCubGazeboV3

/where/you/installed/the/application/cwm ```

to plot the data, use matlab to run the script plot_data.m

Citing this work

If you find the work useful, please consider citing:

bibtex @ARTICLE{mebbaid2023ICRA, author={Mohamed Elobaid, Giulio Romualdi, Gabriele Nava, Lorenzo Rapetti, Hosameldin Awadalla Omer Mohamed, Daniele Pucci}, title={Online Non-linear Centroidal MPC for Humanoid Robots Payload Carrying with Contact-Stable Force Parametrization}, booktitle={2023 International Conference on Robotics and Automation (ICRA)}, year={2023}}

Maintainer

This repository is maintained by:

| | | |:---:|:---:| | | @mebbaid |

Owner

  • Name: Artificial and Mechanical Intelligence
  • Login: ami-iit
  • Kind: organization
  • Location: Italy

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 3
  • Total Committers: 1
  • Avg Commits per committer: 3.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Mohamed Elobaid 3****d 3

Issues and Pull Requests

Last synced: about 1 year ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels