Package Summary
| Tags | No category tags. |
| Version | 0.3.12 |
| License | BSD |
| Build type | CATKIN |
| Use | RECOMMENDED |
Repository Summary
| Checkout URI | https://github.com/utexas-bwi/bwi_common.git |
| VCS Type | git |
| VCS Version | led_study_kinetic |
| Last Updated | 2018-12-14 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
Package Description
Additional Links
Maintainers
- Pato Lankenau
Authors
- Pato Lankenau
BWI Virtour
Virtour is a public facing system for teleoperated building tours.
- Web address: http://www.cs.utexas.edu/~larg/bwi_virtour/
- On the robot: uses ROS to manage tour, stream video, and take commands.
- On the website: uses rosjs to pipe commands to the robot
Features
- Adaptive Video streaming
- Teleoperated servo control
- Goal based logical navigation
- In-place robot rotation
- Robot position marker
- Tour leader management
Instructions
On robot:
Set up smallDNS
Change
broadcastTour.shto email correct people and with correct urlBring up robot (eg:
roslaunch bwi_launch segbot_v2.launch)Launch
roslaunch bwi_virtour virtour_passive.launchLaunch
roslaunch bwi_virtour virtour_active-[cameratype].launch
On server:
Link or copy the
webfolder to/var/wwwModify
index.htmlto add robot
Launch Files
There are two types of launch files, passive and full.
Before executing the virtour launch files make sure that the segbot launch
files were executed (either segbot_v1.launch or segbot_v2.launch).
The passive launch files brings up the tour manager, rosbridge and mjpeg servers. Allows people to view the robot's position, camera feed, and scavenger hunt status.
The full (active) launch files (no longer requires the passive one to be running), allows people to become tour leaders, control rotation, request navigation, as well all the features of passive.
Note that at the launch files assume you are running on a kinect powered robot. Comments in the launch file will provide a working launch file if servo or point-grey camera support is needed.
ROS Nodes
Tour Manager
Handles by tour_manager. Manages the tour state machine. Handles tour leaders, when
tours are allowed, and authentication.
Exposed Services
-
/tour_manager/authenticate- used to authenticate users and check if they are leader -
/tour_manager/get_tour_state- get the state of the current tour (excluding leader hash) -
/tour_manager/leave_tour- used to demote leaders -
/tour_manager/ping_tour- used to keep the tour leader alive -
/tour_manager/request_tour- used to request tours
Logical Navigation
Handled by the go_to_location_service_node.
To add new goals, edit js/virtour.js
Exposed Services
-
/go_to_location- used to navigate to semantic locations
Rotation
Handled by rotation_service_node. Takes in a float for the rotation delta
Exposed Services
-
/rotate- used to perform on-the-spot rotations
Project structure
-
/webcontains all files necessary for hosting the website -
/srccontains the c++ source for the ROS nodes -
/srvcontains the service definitions
Resources
Could not convert RST to MD: No such file or directory - pandoc
Wiki Tutorials
Source Tutorials
Package Dependencies
| Deps | Name | |
|---|---|---|
| 1 | message_generation | |
| 1 | message_runtime | |
| 1 | catkin | |
| 1 | bwi_services | |
| 1 | rosbridge_server | |
| 1 | web_video_server | |
| 1 | audio_capture | |
| 1 | actionlib | |
| 1 | bwi_kr_execution | |
| 2 | roscpp | |
| 2 | std_msgs |
System Dependencies
Dependant Packages
| Name | Repo | Deps |
|---|---|---|
| bwi_launch | github-utexas-bwi-bwi | |
| bwi_common | github-utexas-bwi-bwi_common |
Launch files
- launch/disable_tours.launch
- launch/virtour_full.launch
- for pointgrey and servo camera
-
- launch/virtour_passive.launch
- launch/enable_tours.launch
- launch/local_debug.launch
Messages
Services
Plugins
Recent questions tagged bwi_virtour at answers.ros.org
Package Summary
| Tags | No category tags. |
| Version | 0.3.12 |
| License | BSD |
| Build type | CATKIN |
| Use | RECOMMENDED |
Repository Summary
| Checkout URI | https://github.com/utexas-bwi/bwi_common.git |
| VCS Type | git |
| VCS Version | indigo |
| Last Updated | 2018-03-01 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
Package Description
Additional Links
Maintainers
- Pato Lankenau
Authors
- Pato Lankenau
BWI Virtour
Virtour is a public facing system for teleoperated building tours.
- Web address: http://www.cs.utexas.edu/~larg/bwi_virtour/
- On the robot: uses ROS to manage tour, stream video, and take commands.
- On the website: uses rosjs to pipe commands to the robot
Features
- Adaptive Video streaming
- Teleoperated servo control
- Goal based logical navigation
- In-place robot rotation
- Robot position marker
- Tour leader management
Instructions
On robot:
Set up smallDNS
Change
broadcastTour.shto email correct people and with correct urlBring up robot (eg:
roslaunch bwi_launch segbot_v2.launch)Launch
roslaunch bwi_virtour virtour_passive.launchLaunch
roslaunch bwi_virtour virtour_active-[cameratype].launch
On server:
Link or copy the
webfolder to/var/wwwModify
index.htmlto add robot
Launch Files
There are two types of launch files, passive and full.
Before executing the virtour launch files make sure that the segbot launch
files were executed (either segbot_v1.launch or segbot_v2.launch).
The passive launch files brings up the tour manager, rosbridge and mjpeg servers. Allows people to view the robot's position, camera feed, and scavenger hunt status.
The full (active) launch files (no longer requires the passive one to be running), allows people to become tour leaders, control rotation, request navigation, as well all the features of passive.
Note that at the launch files assume you are running on a kinect powered robot. Comments in the launch file will provide a working launch file if servo or point-grey camera support is needed.
ROS Nodes
Tour Manager
Handles by tour_manager. Manages the tour state machine. Handles tour leaders, when
tours are allowed, and authentication.
Exposed Services
-
/tour_manager/authenticate- used to authenticate users and check if they are leader -
/tour_manager/get_tour_state- get the state of the current tour (excluding leader hash) -
/tour_manager/leave_tour- used to demote leaders -
/tour_manager/ping_tour- used to keep the tour leader alive -
/tour_manager/request_tour- used to request tours
Logical Navigation
Handled by the go_to_location_service_node.
To add new goals, edit js/virtour.js
Exposed Services
-
/go_to_location- used to navigate to semantic locations
Rotation
Handled by rotation_service_node. Takes in a float for the rotation delta
Exposed Services
-
/rotate- used to perform on-the-spot rotations
Project structure
-
/webcontains all files necessary for hosting the website -
/srccontains the c++ source for the ROS nodes -
/srvcontains the service definitions
Resources
Could not convert RST to MD: No such file or directory - pandoc
Wiki Tutorials
Source Tutorials
Package Dependencies
| Deps | Name | |
|---|---|---|
| 1 | message_generation | |
| 1 | message_runtime | |
| 1 | catkin | |
| 1 | bwi_services | |
| 1 | rosbridge_server | |
| 1 | web_video_server | |
| 1 | audio_capture | |
| 1 | actionlib | |
| 1 | bwi_kr_execution | |
| 2 | roscpp | |
| 2 | std_msgs |
System Dependencies
Dependant Packages
| Name | Repo | Deps |
|---|---|---|
| bwi_launch | github-utexas-bwi-bwi | |
| bwi_common | github-utexas-bwi-bwi_common |
Launch files
- launch/disable_tours.launch
- launch/virtour_full.launch
- for pointgrey and servo camera
-
- launch/virtour_passive.launch
- launch/enable_tours.launch
- launch/local_debug.launch