cmake_modules

A common repository for CMake Modules which are not distributed with CMake but are commonly used by ROS packages.

See the CONTRIBUTING.md file in this repository before submitting pull requests for new modules.

ROS Distros

This repository has branches for minor releases (0.2-devel, 0.3-devel, 0.4-devel, etc…) and they map to specific ROS distributions like so:

• 0.2-devel:
  • ROS Groovy
• 0.3-devel:
  • ROS Hydro
  • ROS Indigo
• 0.4-devel:
  • ROS Jade
  • ROS Kinetic
  • ROS Lunar
  • ROS Melodic
• 0.5-devel:
  • ROS Noetic

This mapping will be kept up-to-date in the README.md on the default branch.

In the future, new minor releases will increment by the number of ROS distros that are skipped. For example, if a custom branch is needed for ROS Lunar, then it will be 0.6-devel and not 0.5-devel, so that 0.5-devel maybe used by Kinetic in the future if necessary.

Provided Modules

1. NumPy is the fundamental package for scientific computing with Python.
2. TBB lets you easily write parallel C++ programs that take full advantage of multicore performance.
3. TinyXML is a simple, small, C++ XML parser.
4. TinyXML2 is a simple, small, C++ XML parser, continuation of TinyXML.
5. Xenomai is a real-time development framework cooperating with the Linux kernel.
6. GSL is a numerical library for C and C++ programmers.
7. Gflags is a C++ library that implements commandline flags processing with the ability to define flags in the source file in which they are used.
8. [Deprecated] Eigen is a C++ template library for linear algebra: matrices, vectors, numerical solvers, and related algorithms.

Usage

To use the CMake modules provided by this catkin package, you must <build_depend> on it in your package.xml, like so:

<?xml version="1.0"?>
<package>
  <!-- ... -->
  <build_depend>cmake_modules</build_depend>
</package>

Then you must find_package it in your CMakeLists.txt along with your other catkin build dependencies:

find_package(catkin REQUIRED COMPONENTS ... cmake_modules ...)

OR by find_package‘ing it directly:

find_package(cmake_modules REQUIRED)

After the above find_package invocations, the modules provided by cmake_modules will be available in your CMAKE_MODULE_PATH to be found. For example you can find TinyXML by using the following:

find_package(TinyXML REQUIRED)

Lookup sheet

Eigen [Deprecated]

find_package(Eigen REQUIRED)

NumPY

find_package(NUMPY REQUIRED)

TBB

find_package(TBB REQUIRED)

TinyXML

find_package(TinyXML REQUIRED)

Xenomai

find_package(Xenomai REQUIRED)

FindGSL

find_package(GSL REQUIRED)

Gflags

find_package(Gflags REQUIRED)

Changelog for package cmake_modules

0.5.0 (2020-01-23)

• Bump CMake version to avoid CMP0048 author warning (#51)
• Contributors: Shane Loretz

0.4.2 (2019-03-19)

• Changed FindPoco to use 'd' suffix only when debug libraries are present (#50)
  • Recent versions of Debian and Ubuntu (beginning with Stretch and Bionic respectively) do not provide separate debug library versions of Poco.
  • The refactored debug check now actually verifies that a d-suffixed library exists.
  • If not it falls back to using the non-suffixed version of the library which may or may not include debug symbols.
• add note about ROS Lunar and future versioning schemes
• Contributors: Steven! Ragnarök, William Woodall

0.4.1 (2017-02-21)

• Add FindTinyXML2 module (#42) Signed-off-by: Dmitry Rozhkov <<dmitry.rozhkov@linux.intel.com>>
• Add FindGflags for supporting Gflags
• Contributors: Dave Coleman, Dmitry Rozhkov, William Woodall

0.4.0 (2014-12-25)

• The Eigen module provided by this package has been deprecated. There is now a CMake warning to encourage people to use the Module provided by Eigen instead.
• Contributors: William Woodall

0.3.3 (2014-12-23)

• Added FindPoco.cmake, which migrated from the ros/class_loader repository.
• Update to FindXenomai.cmake find_package_handle_standard_args generates all caps variables (XENOMAI_FOUND), while this script is expected to create Xenomai_FOUND. This changeset creates the appropriately cased variable, but does not unset the all-caps variant for backwards-compatibility reasons (I typically unset it on new modules).
• Contributors: Adolfo Rodriguez Tsouroukdissian, Esteve Fernandez, William Woodall

0.3.2 (2014-10-27)

• Added CMake module for finding the UUID libraries
• Changed prepend of CMAKE_MODULE_PATH to append behaviour in order to allow prepending of external CMake modules.
• Added CMake module for finding GSL
• Contributors: Esteve Fernandez, Peter Lehner, William Woodall, v01d

0.3.1 (2014-05-07)

• Export architecture_independent flag in package.xml
• Fix extended CMAKE_MODULE_PATH variable when path contains spaces
• Mention the sequencing reqirement with an example
• Contributors: Dirk Thomas, Paul Mathieu, Scott K Logan, Tully Foote, William Woodall, phuicy

0.3.0 (2014-02-22)

• Added Numpy CMake module
• Added Eigen CMake module closed #10
• Removed use of absolute paths in extra files fixed #9
• Contributors: Vincent Rabaud, William Woodall

0.2.1 (2014-01-24)

• Adding CMake module for finding Xenomai RT kernel patch build flags
• Contributors: Jonathan Bohren, William Woodall

0.2.0 (2013-12-04)

• Added FindTBB.cmake version r36 from the findtbb package
• TinyXML: Add more comprehensive header documentation.

0.1.0 (2013-07-24)

• Initial release, includes the FindTinyXML.cmake CMake module