Package Links

Used by (10)

Package Summary

Willow Garage low-level build system macros and infrastructure.

Author: Troy Straszheim/straszheim@willowgarage.com, Morten Kjaergaard, Brian Gerkey
License: BSD
Source: git https://github.com/ros/catkin.git (branch: fuerte-devel)

Package Links

Dependencies (6)
Used by (926)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: groovy-devel)

Package Links

Dependencies (6)
Used by (2131)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: groovy-devel)

Package Links

Used by (3213)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: indigo-devel)

Package Links

Used by (1230)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: indigo-devel)

Package Links

Used by (3346)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: kinetic-devel)

Package Links

Used by (1086)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: kinetic-devel)

Package Links

Used by (2435)
Jenkins jobs (6)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: kinetic-devel)

Package Links

Used by (2132)
Jenkins jobs (6)

Package Summary

Low-level build system macros and infrastructure for ROS.

Maintainer status: maintained
Maintainer: Geoffrey Biggs <geoff AT openrobotics DOT org>, Ivan Santiago Paunovic <ivanpauno AT ekumenlabs DOT com>
Author: Troy Straszheim, Morten Kjaergaard, Brian Gerkey, Dirk Thomas, Michael Carroll <michael AT openrobotics DOT org>, Tully Foote <tfoote AT openrobotics DOT org>
License: BSD
Bug / feature tracker: https://github.com/ros/catkin/issues
Source: git https://github.com/ros/catkin.git (branch: noetic-devel)

Conceptual Overview

See catkin/conceptual_overview

Installing catkin

Catkin is included by default when ROS is installed. Catkin can also be installed from source or prebuilt packages. Most users will want to use the prebuilt packages, but installing it from source is also quite simple.

Install from source

Catkin has the following dependencies:

CMake - A cross-platform, open-source build system.
Python - Python is a general-purpose, interpreted high-level programming language. Version 2.7 is required (reference).
- catkin_pkg - A Python runtime library for catkin.
- empy - A Python template library.
- nose - A Python testing framework.
GTest - A cpp unittest framework from Google.
GNU C++ Compiler (g++) - The GNU C++ compiler

You can resolve these dependencies on Ubuntu with this command:

sudo apt-get install cmake python-catkin-pkg python-empy python-nose python-setuptools libgtest-dev build-essential

If you are not on Ubuntu you can install catkin_pkg from PyPi via pip.

If you have trouble installing the python-* packages in the command above, make sure you have added the packages.ros.org debian repository to your apt source lists as described on this page.

Then install catkin like any CMake package

mkdir build && cmake ../ && make && sudo make install

Note: You usually want to pass a specific build type when invoking CMake, e.g. cmake -DCMAKE_BUILD_TYPE=Release ../ (or RelWithDebInfo / Debug instead of Release, see http://cmake.org/cmake/help/v2.8.12/cmake.html#variable:CMAKE_BUILD_TYPE).

Install prebuilt package

If you are using a ROS binary distribution (Groovy or higher) on Ubuntu then you can install catkin with apt-get:

sudo apt-get install ros-groovy-catkin

sudo apt-get install ros-hydro-catkin

Most ROS installations will include this by default.

Note for ROS Fuerte Users: An experimental version of catkin was released with ROS Fuerte that is quite different from the version in Groovy. Those using ROS Fuerte should continue utilizing rosbuild.

Migrating from rosbuild

See catkin/migrating_from_rosbuild

External Documentation

See the external catkin docs containing:

How to do common tasks
User guide
Advanced user guide
Information for developers
Using catkin with Python http://docs.ros.org/api/catkin/html/user_guide/setup_dot_py.html

Tutorials

Configuration File References

Glossary of Terms

See catkin/Glossary

REPs

Code Reviews

Reviews

Are you looking for the ROS Groovy documentation for catkin?

catkin was in alpha for ROS Fuerte, please see the ROS Groovy documentation for catkin if you want to see the new usage.

ROS Fuerte catkin documentation: catkin docs (Fuerte)

Not supported, use rosbuild.

Package Summary

Package Summary

Package Summary

Package Summary

Package Summary

Package Summary

Package Summary

Package Summary

Package Summary

Conceptual Overview

Installing catkin

Install from source

Install prebuilt package

Migrating from rosbuild

External Documentation

Tutorials

Configuration File References

Glossary of Terms

REPs

Code Reviews

Report a Bug