HIOB example client

Description

Provides an example client for the HIOB-ROS-Server, which tracks objects within some camera footage (e.g. from a webcam).

Note: This is only a client application; you need to have an instance of the server running somewhere in the network (or on the same machine) in order to use it.

Requirements

• Python 2
• ROS (Kinetic or above)
• hiob_msgs (see Installation section)

---

Note: The following instructions assume a modern Linux OS. However, while not tested explicitly, the client might likely be compatible with other operating systems as well, if they have Python and ROS available.

Installation

1. Source the ROS setup script of the ROS distro, e.g.

   . /opt/ros/kinetic/setup.bash

2. Create or reuse a directory for a ROS workspace, e.g.:

   mkdir -p my_ros_ws/src

3. Clone this repository and dependencies into an 'src' directory inside the created workspace:

   git clone https://github.com/theCalcaholic/hiob_example_client.git src/hiob_example_client
   git clone https://github.com/theCalcaholic/hiob_msgs.git           src/hiob_msgs

4. Install dependencies of packages in the created workspace, e.g.:

   rosdep init
   rosdep update
   rosdep install --from-paths src --ignore-src --rosdistro kinetic

   Note: Replace 'kinetic' by your ROS distro.
5. Install the ROS packages with catkin (from your ros workspace root directory):

   catkin_make install

Usage

This section assumes that you have followed the steps in the Installation section carefully.

If so, you should be able to perform these steps in order to run the HIOB client:

1. Source the ROS setup script of the ROS distro e.g.:

   . /opt/ros/kinetic/setup.bash

2. Start an instance of roscore
3. Open a new terminal window and source the ROS setup scripts of both the ROS distro and your ROS workspace, e.g.:

   . /opt/ros/kinetic/setup.bash
   . my_ros_workspace/install/setup.bash

4. Run the example client:

   rosrun hiob_example_client launch.py