Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix for Noetic (and two minor things) #60

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
cmake_minimum_required(VERSION 2.8.0)
cmake_minimum_required(VERSION 3.10)
project(ros_vrpn_client)

add_definitions(-std=c++11)

find_package(catkin_simple REQUIRED)
catkin_simple(ALL_DEPS_REQUIRED)

find_package(Eigen REQUIRED)
include_directories(${Eigen_INCLUDE_DIRS})
find_package(Eigen3 REQUIRED)
include_directories(${Eigen_INCLUDE_DIR})

cs_add_library(vicon_estimator
src/library/vicon_estimator.cpp
Expand Down
51 changes: 21 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,37 @@
ros_vrpn_client
===============
# ros_vrpn_client

Ros interface for http://www.cs.unc.edu/Research/vrpn/
[![Build Status](https://jenkins.asl.ethz.ch/buildStatus/icon?job=ros_vrpn_client)](https://jenkins.asl.ethz.ch/job/ros_vrpn_client/)

Dependencies
-------------------
vrpn_catkin package from: https://github.com/ethz-asl/vrpn_catkin
This is a ROS interface for VRPN ("Virtual-Reality Peripheral Network"). More info about VRPN can be found in their original [publication](https://dl.acm.org/doi/10.1145/505008.505019) and on their [github](https://github.com/vrpn/vrpn).

## Installation

For both Ubuntu and macOS:

1. build [vrpn_catkin](https://github.com/ethz-asl/vrpn_catkin) package (catkinized version of [VRPN](https://github.com/vrpn/vrpn))
2. build this package

## Usage

Usage
-----------------
You have to start a ROS node per tracked object and the ROS node name has to be the name of the trackable object.

rosrun ros_vrpn_client ros_vrpn_client _object_name:=object_name _vrpn_server_ip:=192.168.1.1
`rosrun ros_vrpn_client ros_vrpn_client _object_name:=object_name _vrpn_server_ip:=192.168.1.1`

Or in a launch file:

```XML
<arg name="object_name" default="some_object_name" />
<node name="some_object_name_vrpn_client" type="ros_vrpn_client" pkg="ros_vrpn_client" output="screen">
<param name="vrpn_server_ip" value="192.168.1.100" />
<param name="object_name" value="$(arg object_name)" />
<!-- or directly:
<param name="object_name" value="some_object_name" /> -->
<param name="vrpn_server_ip" value="192.168.1.100" />
<param name="object_name" value="$(arg object_name)" />
<!-- or directly:
<param name="object_name" value="some_object_name" /> -->
</node>
```
Installation HowTo
===============
Installation Ubuntu
-------------------
A catkinized version of VRPN can be found here: https://github.com/ethz-asl/vrpn_catkin

For further information about VRPN, please consult their website:
https://github.com/vrpn/vrpn
## Info about coord frames

Installation OS X
-----------------
Use the catkinized package above.

TF coord frames
----------------
### TF coord frames

1. /optitrak
- world frame that we will use.
Expand All @@ -52,8 +45,8 @@ TF coord frames
software (Trackable properties) aligns the object coord frame with
the /optitrak frame.

Coord frames vodoo
------------------
### Coord frames vodoo

The TrackingTools software outputs the position and orientation in a
funky coord frame which has the Y axis pointing vertically up, the X
axis along the x axis of the calibration square and Z axis along the
Expand All @@ -63,5 +56,3 @@ We perform some rotations to get rid of this funky frame and use the
/optitrak frame described above as our fixed world coord frame. The
code is in the "VRPN_CALLBACK track_target" function in
ros_vrpn_client.cpp


2 changes: 1 addition & 1 deletion package.xml
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@
<!-- Dependencies which this package needs to build itself. -->
<buildtool_depend>catkin</buildtool_depend>
<buildtool_depend>catkin_simple</buildtool_depend>
<buildtool_depend>message_generation</buildtool_depend>

<!-- Dependencies needed after this package is compiled. -->
<depend>message_generation</depend>
<depend>roscpp</depend>
<depend>tf</depend>
<depend>geometry_msgs</depend>
Expand Down