Skip to content

Tutorial

Sebastian Buck edited this page Mar 12, 2018 · 7 revisions

How-to's / Tutorials

Dependencies

You are going to need OpenCV 2.4.9 and ROS (>= jade). Simply install ros-jade-desktop-full (http://wiki.ros.org/jade/Installation/Ubuntu)

sudo apt-get install ros-jade-desktop-full qt5-default libqt5svg5-dev git subversion 

How to build the packages

Assuming you already installed ROS, you can simply follow these instruction to build the packages: ($CATKIN_WS = <path-to-your-catkin-workspace>)

cd $CATKIN_WS/src

git clone https://github.com/cogsys-tuebingen/csapex.git
cd csapex
cd plugins
git clone https://github.com/cogsys-tuebingen/csapex_core_plugins.git

cd ..
mkdir libs
cd libs
git clone https://github.com/cogsys-tuebingen/cslibs_vision.git
git clone https://github.com/cogsys-tuebingen/cslibs_laser_processing.git
git clone https://github.com/cogsys-tuebingen/cslibs_arff.git
git clone https://github.com/cogsys-tuebingen/cslibs_indexed_storage.git 

cd $CATKIN_WS
rosdep install -y -r -i --from-paths src

source /opt/ros/jade/setup.bash
catkin_make
source devel/setup.bash
rosrun csapex csapex_node

You can also add the command

source $CATKIN_WS/devel/setup.bash

to your .bashrc.

Using the GUI

Start the UI using

rosrun csapex csapex_node

You will see an empty designer board. To load some demonstration examples, open the Help Center by pressing F1 or selecting it from the Help menu. Then select the Tutorials tab in the Help Center. Here you can select a few example configurations that show you how to use the UI.

Please feel free to create issues if you find any problems or if you have suggestions how to improve the interface.

How to add custom functionality

The following tutorials show you how to create a custom package and should best be read in sequence. If you don't want to implement the tutorial yourself but just want to see the code, please refer to https://github.com/cogsys-tuebingen/csapex_tutorial.

How to create a new module

How to create a new node

How to write a CorePlugin

How to add a new message type

How to make a new message ROS-convertible

Clone this wiki locally