Skip to content

Commit

Permalink
🚀 Release 0.17.0
Browse files Browse the repository at this point in the history
  • Loading branch information
GiulioRomualdi committed Dec 23, 2023
1 parent ad7cd34 commit a405c4b
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 35 deletions.
4 changes: 1 addition & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Changelog
All notable changes to this project are documented in this file.

## [unreleased]
## [0.17.0] - 2023-12-23
### Added
- Implement `ContactList::getNextContact` and `ContactList::getActiveContact` in `Contact` component (https://github.com/ami-iit/bipedal-locomotion-framework/pull/764)
- Implement `MANN::generateDummyMANNOutput` and `MANN::generateDummyMANNInput` in `ML` component (https://github.com/ami-iit/bipedal-locomotion-framework/pull/771)
Expand Down Expand Up @@ -34,8 +34,6 @@ All notable changes to this project are documented in this file.
### Removed
- Remove the latex dependency in the joint-position-tracking script (https://github.com/ami-iit/bipedal-locomotion-framework/pull/775/)

### Fixed

## [0.16.1] - 2023-11-17
### Changed
- [ergoCubSN000] Update the YarpRobotLogger configuration file to be mpliant with robots-configuration v2.5.2 (https://github.com/ami-iit/bipedal-locomotion-framework/pull/763)
Expand Down
2 changes: 1 addition & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ cmake_minimum_required(VERSION 3.16.0)

## MAIN project
project(BipedalLocomotionFramework
VERSION 0.16.100)
VERSION 0.17.0)

list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake)

Expand Down
11 changes: 8 additions & 3 deletions docs/config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,21 +3,26 @@ main_page = "docs/pages/main-page.dox"
additional_pages = ["docs/pages/python-additional-info.md", "docs/pages/so3-minjerk.md"]
src_folder = "src"

['v0.16.1']
['v0.17.0']
main_page = "docs/pages/main-page.dox"
additional_pages = ["docs/pages/python-additional-info.md", "docs/pages/so3-minjerk.md"]
src_folder = "src"

['v0.15.0']
['v0.16.1']
main_page = "docs/pages/main-page.dox"
additional_pages = ["docs/pages/python-additional-info.md", "docs/pages/so3-minjerk.md"]
src_folder = "src"

['v0.14.1']
['v0.15.0']
main_page = "docs/pages/main-page.dox"
additional_pages = ["docs/pages/python-additional-info.md", "docs/pages/so3-minjerk.md"]
src_folder = "src"

# ['v0.14.1']
# main_page = "docs/pages/main-page.dox"
# additional_pages = ["docs/pages/python-additional-info.md", "docs/pages/so3-minjerk.md"]
# src_folder = "src"

# ['v0.13.0']
# main_page = "docs/pages/main-page.dox"
# additional_pages = ["docs/pages/python-additional-info.md"]
Expand Down
56 changes: 28 additions & 28 deletions docs/pages/main-page.dox
Original file line number Diff line number Diff line change
Expand Up @@ -18,37 +18,37 @@ The minimum required dependencies are `Eigen3`, `iDynTree` and `spdlog`. If you

\section exported-components 📙 Exported components

The **bipedal-locomotion-framework** project consists of several components. The components are stored in the [`src`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src) folder and their compilation depends on the installed dependencies.
The **bipedal-locomotion-framework** project consists of several components. The components are stored in the [`src`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src) folder and their compilation depends on the installed dependencies.

| Component | Description | Additional Dependencies |
| :--------------------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: |
| `Framework` | Interface library that gathers all the exported components, includable with the file `BipedalLocomotion/Framework.h` | - |
| [`AutoDiff`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/AutoDiff) | Bridge between CppAD and Eigen | [`CppAD`](https://coin-or.github.io/CppAD/doc/cppad.htm) |
| [`ContactModels`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/ContactModels) | Models to describe the contact between robot and enviroment | - |
| [`Contacts`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Contacts) | Syntactic description of a contact | [`manif`](https://github.com/artivis/manif) [`nlohmann json`](https://github.com/nlohmann/json/) |
| [`CommonConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Conversions) | Common conversion utilities used in the framework | - |
| [`ManifConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Conversions) | Library related conversion utilities used in the framework | [`manif`](https://github.com/artivis/manif) |
| [`matioCppConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Conversions) | Library related conversion utilities used in the framework | [`matio-cpp`](https://github.com/ami-iit/matio-cpp) |
| [`CasadiConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Conversions) | Library related conversion utilities used in the framework | [`CasADi`](https://github.com/casadi/casadi) |
| [`Estimators`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Estimators) | Library containing observers | - |
| [`FloatingBaseEstimator`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Estimators) | Library containing floating base estimators | [`manif`](https://github.com/artivis/manif) |
| [`RobotDynamicsEstimator`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Estimators) | Library containing floating base estimators | [`manif`](https://github.com/artivis/manif) |
| [`GenericContainer`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/GenericContainer) | Data structure similar to ``span`` but resizable. | - |
| [`IK`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/IK) | Inverse kinematics | [`manif`](https://github.com/artivis/manif) [`osqp-eigen`](https://github.com/robotology/osqp-eigen) |
| [`Math`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Math) | Library containing mathematical algorithms | [`manif`](https://github.com/artivis/manif) |
| [`ML`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/ML) | Library containing deep learning algorithms | [`onnxruntime`](https://onnxruntime.ai/) |
| [`ParametersHandler`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/ParametersHandler) | Library for retrieving parameters from configuration files | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) [`tomlplusplus`](https://github.com/marzer/tomlplusplus/) (only if you want the `toml` implementation) |
| [`PerceptionInterface`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/RobotInterface) | Generic interface classes to adapt to perception data formats like images and point clouds | [`OpenCV`](https://github.com/opencv/opencv) [`PCL`](https://github.com/PointCloudLibrary/pcl) |
| [`PerceptionCapture`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Perception) | Library containing driver classes for perception devices | [`OpenCV`](https://github.com/opencv/opencv) [`PCL`](https://github.com/PointCloudLibrary/pcl) [`realsense2`](https://github.com/IntelRealSense/librealsense) |
| [`PerceptionFeatures`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Perception) | Library containing perception algorithms useful for locomotion | [`OpenCV`](https://github.com/opencv/opencv) |
| [`Planners`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/Planners) | Library containing planner useful for locomotion | [`manif`](https://github.com/artivis/manif) [`CasADi`](https://web.casadi.org/) [`qhull`](http://www.qhull.org/) |
| [`ReducedModelControllers`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/ReducedModelsController) | Controller based on reduced models, e.g., `CentroidalMPC` | [`CasADi`](https://github.com/casadi/casadi)|
| [`RobotInterface`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/RobotInterface) | Library for communicating with the robot | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) |
| [`SimplifiedModelControllers`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/SimplifiedModelControllers) | Controllers based on simplified models, i.e, LIPM. | - |
| [`System`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/System) | Description of discrete and continuous dynamical systems | - |
| [`TSID`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/TSID) | Task space inverse dynamics | [`manif`](https://github.com/artivis/manif) [`lie-group-controllers`](https://github.com/ami-iit/lie-group-controllers) |
| [`TextLogging`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/TextLogging) | Helper library to display messages into the console | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) [`ros-humble`](https://docs.ros.org/en/humble/) (if you want the `ros2` implementation) |
| [`YarpUtilities`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/src/YarpUtilities) | Utilities library for retrieving data and from YARP structures | [`YARP`](https://www.yarp.it/git-master/) |
| [`AutoDiff`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/AutoDiff) | Bridge between CppAD and Eigen | [`CppAD`](https://coin-or.github.io/CppAD/doc/cppad.htm) |
| [`ContactModels`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/ContactModels) | Models to describe the contact between robot and enviroment | - |
| [`Contacts`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Contacts) | Syntactic description of a contact | [`manif`](https://github.com/artivis/manif) [`nlohmann json`](https://github.com/nlohmann/json/) |
| [`CommonConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Conversions) | Common conversion utilities used in the framework | - |
| [`ManifConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Conversions) | Library related conversion utilities used in the framework | [`manif`](https://github.com/artivis/manif) |
| [`matioCppConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Conversions) | Library related conversion utilities used in the framework | [`matio-cpp`](https://github.com/ami-iit/matio-cpp) |
| [`CasadiConversions`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Conversions) | Library related conversion utilities used in the framework | [`CasADi`](https://github.com/casadi/casadi) |
| [`Estimators`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Estimators) | Library containing observers | - |
| [`FloatingBaseEstimator`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Estimators) | Library containing floating base estimators | [`manif`](https://github.com/artivis/manif) |
| [`RobotDynamicsEstimator`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Estimators) | Library containing floating base estimators | [`manif`](https://github.com/artivis/manif) |
| [`GenericContainer`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/GenericContainer) | Data structure similar to ``span`` but resizable. | - |
| [`IK`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/IK) | Inverse kinematics | [`manif`](https://github.com/artivis/manif) [`osqp-eigen`](https://github.com/robotology/osqp-eigen) |
| [`Math`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Math) | Library containing mathematical algorithms | [`manif`](https://github.com/artivis/manif) |
| [`ML`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/ML) | Library containing deep learning algorithms | [`onnxruntime`](https://onnxruntime.ai/) |
| [`ParametersHandler`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/ParametersHandler) | Library for retrieving parameters from configuration files | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) [`tomlplusplus`](https://github.com/marzer/tomlplusplus/) (only if you want the `toml` implementation) |
| [`PerceptionInterface`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/RobotInterface) | Generic interface classes to adapt to perception data formats like images and point clouds | [`OpenCV`](https://github.com/opencv/opencv) [`PCL`](https://github.com/PointCloudLibrary/pcl) |
| [`PerceptionCapture`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Perception) | Library containing driver classes for perception devices | [`OpenCV`](https://github.com/opencv/opencv) [`PCL`](https://github.com/PointCloudLibrary/pcl) [`realsense2`](https://github.com/IntelRealSense/librealsense) |
| [`PerceptionFeatures`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Perception) | Library containing perception algorithms useful for locomotion | [`OpenCV`](https://github.com/opencv/opencv) |
| [`Planners`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/Planners) | Library containing planner useful for locomotion | [`manif`](https://github.com/artivis/manif) [`CasADi`](https://web.casadi.org/) [`qhull`](http://www.qhull.org/) |
| [`ReducedModelControllers`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/ReducedModelsController) | Controller based on reduced models, e.g., `CentroidalMPC` | [`CasADi`](https://github.com/casadi/casadi)|
| [`RobotInterface`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/RobotInterface) | Library for communicating with the robot | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) |
| [`SimplifiedModelControllers`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/SimplifiedModelControllers) | Controllers based on simplified models, i.e, LIPM. | - |
| [`System`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/System) | Description of discrete and continuous dynamical systems | - |
| [`TSID`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/TSID) | Task space inverse dynamics | [`manif`](https://github.com/artivis/manif) [`lie-group-controllers`](https://github.com/ami-iit/lie-group-controllers) |
| [`TextLogging`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/TextLogging) | Helper library to display messages into the console | [`YARP`](https://www.yarp.it/git-master/) (only if you want the `YARP` implementation) [`ros-humble`](https://docs.ros.org/en/humble/) (if you want the `ros2` implementation) |
| [`YarpUtilities`](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/src/YarpUtilities) | Utilities library for retrieving data and from YARP structures | [`YARP`](https://www.yarp.it/git-master/) |


\warning ⚠️ Including `BipedalLocomotion/Framework.h` may result in higher compilation time because of the inclusion of headers which may not be used in your project. It is always suggested to follow the [IWYU](https://github.com/include-what-you-use/include-what-you-use/blob/cc0fad4be0db26e40713b6076263f204a311b573/docs/WhyIWYU.md) paradigm. This applies also for the CMake targets. It is suggested to link only the targets used in your project.
Expand Down Expand Up @@ -80,7 +80,7 @@ cmake --build . --config Release --target install

\section some-utilities 🖥️ Some utilities

The **bipedal-locomotion-framework** ships also some utilities that can help you in the everyday tests on a real robot. You can find them in the [`utilities` folder](https://github.com/ami-iit/bipedal-locomotion-framework/tree/master/utilities). Each utility contains a well-documented `README` where you can find further details.
The **bipedal-locomotion-framework** ships also some utilities that can help you in the everyday tests on a real robot. You can find them in the [`utilities` folder](https://github.com/ami-iit/bipedal-locomotion-framework/tree/v0.17.0/utilities). Each utility contains a well-documented `README` where you can find further details.

\section python 🐍 Python

Expand Down

0 comments on commit a405c4b

Please sign in to comment.