/bayesopt4ros

Bayesian Optimisation package for ROS

Primary LanguagePythonMIT LicenseMIT

BayesOpt4ROS

Integration test status badge Documentation deployment status badge DOI

A Bayesian Optimisation package for ROS developed by the Intelligent Control Systems (ICS) group at ETH Zurich.

Documentation

We provide a official and up-to-date documentation here.

Getting started

For a short tutorial on how to get started with the BayesOpt4ROS package, please see the official documentation.

Contributing

In case you find our package helpful and want to contribute, please either raise an issue or directly make a pull request.

Testing

To facilitate easier contribution, we have a continuous integration pipeline set up using Github Actions. To run the tests locally you can use the following commands:

Unit tests

pytest src/bayesopt4ros/test/unit/

Integration tests

To run all integration tests (this command is executed in the CI pipeline):

catkin_make_isolated -j1 --catkin-make-args run_tests && catkin_test_results

Or if you want to just run a specific integration test:

rostest bayesopt4ros test_client_python 

Citing BayesOpt4ROS

If you found our package helpful in your research, we would appreciate if you cite it as follows:

@misc {Froehlich2021BayesOpt4ROS, 
  author       = {Fr\"ohlich, Lukas P. and Carron, Andrea},
  title        = {BayesOpt4ROS: A {B}ayesian Optimization package for the Robot Operating System},
  howpublished = {\url{ https://github.com/IntelligentControlSystems/bayesopt4ros}},
  year         = {2021},
  note         = {DOI 10.5281/zenodo.5560966},
}