CopterExpress/clover
1
0
Fork 0
mirror of https://github.com/CopterExpress/clover.git synced 2026-06-05 09:09:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

EN articles update

Browse Source 
8 new English articles
This commit is contained in:
Konstantin Eliseev
2019-02-05 14:20:11 +03:00
committed by GitHub
parent dffd818a42
commit 232401e730
9 changed files with 1084 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

75
docs/en/rviz.md Normal file
View File

@@ -0,0 +1,75 @@
Using rviz and rqt
===
![rviz](../assets/rviz.png)
The [rviz] tool(http://wiki.ros.org/rviz) allows real-time visualization of all components of the robotic system —the system of coordinates, moving parts, sensors, camera images — on the 3D stage.
[rqt](http://wiki.ros.org/rqt) is a set of GUI for analyzing and controlling ROS systems. For example, `rqt_image_view` allows viewing topics with images, `rqt_multiplot` allows plot charts by the values in topics, etc.
To use rviz and rqt, a PC running Ubuntu Linux (or a virtual machine such as [Parallels Desktop Lite] (https://itunes.apple.com/ru/app/parallels-desktop-lite/id1085114709?mt=12) or [VirtualBox] (https://www.virtualbox.org)) is required.
Install package `ros-kinetic-desktop-full` or `ros-kinetic-desktop` using the [installation documentation](http://wiki.ros.org/kinetic/Installation/Ubuntu).
Start rviz
---
To start еру visualization of the state of Clever in real time, connect to it via Wi-Fi (`CLEVER-xxx`) and run rviz, specifying an appropriate ROS_MASTER_URI:
```(bash)
ROS_MASTER_URI=http://192.168.11.1:11311 rviz
```
If connection is not established, make sure the `.bashrc` of Clever contains line:
```(bash)
export ROS_IP=192.168.11.1
```
Using rviz
---
### Visualization of the copter position
It is recommended to set the `map` frame as a reference frame. To visualize the copter, add visualization markers from topic `/vehicle_markers`. To visualize the camera of the copter, add visualization markers from topic `/main_camera/camera_markers`.
The result of copter and camera visualization is shown below:
![rviz](../assets/copter_visualization.png)
### Visualization of the environment
You can view a picture with augmented reality from the topic of the main camera `/main_camera/image_raw`.
Axis or Grid configured to frame `aruco_map` will visualize the location [on the map of ArUco marks](aruco.md).
### jsk_rviz_plugins
It is also recommended to install additional useful plugins for rviz [jsk_rviz_plugins](https://jsk-docs.readthedocs.io/en/latest/jsk_visualization/doc/jsk_rviz_plugins/index.html). This kit allows visualizing topics like `TwistStamped` (velocity) `CameraInfo`, `PolygonArray`, and many more. To install, use command:
```(bash)
sudo apt-get install ros-kinetic-jsk-visualization
```
Starting the rqt toolkit
---
![rqt](../assets/rqt.png)
To start rqt for monitoring Clever status, use command:
```(bash)
ROS_MASTER_URI=http://192.168.11.1:11311 rqt
```
An example of starting a specific plugin (`rqt_image_view`):
```(bash)
ROS_MASTER_URI=http://192.168.11.1:11311 rqt_image_view
```
Brief description of useful rqt plugins:
* `rqt_image_view` – viewing images from topics like `sensor_msgs/Image`;
* `rqt_multiplot` – Building charts from the data from of arbitrary topics (installation: `sudo apt-get install ros-kinetic-rqt-multiplot`);
* Bag – working with [Bag-files](http://wiki.ros.org/rosbag).