(C) 2022 Airbus Defence and Space. Licensed under Apache 2.0

VISPA Description

This collection of files and folders containing the necessary information to visualise and simulate the Versatile In-Space and Planetary Arm (VISPA). At the heart of the description package is the Unified Robot Description Format (URDF) that is commonly utalised in robotics to represent a robot model in the XML format.

• VISPA Description
  • Folder Structure
    • urdf
    • meshes
    • rviz
    • launch
  • Viewing Model
    • ROS 2 (distro foxy)
    • ROS 1 (distro kinetic)
    • CoppeliaSim (Version 4.2)
    • Matlab
  • Caveats
  • TODO

Folder Structure

vispa_description
|   README.md
|   CMakeLists.txt
|   package.xml
|
└─ images
|       coppeliasim_vispa.png
|	...
└─ launch
|      display.launch
|      display.launch.py
└─ meshes
|       Link0_DHReference-PublicRelease.stl
|       Link0_DHReference-PublicRelease-col.stl
|       ...
|       Link6_DHReference-PublicRelease.stl
|	Link6_DHReference-PublicRelease-col.stl
└─ rviz
|       vispa_ros1.rviz
|       vispa_ros2.rviz
└─ urdf
        VISPA_modifiedDH.urdf
	VISPA_modifiedDH_Ros2.urdf
        

urdf

This folder contains the URDF file (VISPA_modifiedDH.urdf) that describes the robotic arm characteristics, and links to CAD data.

meshes

Stores the CAD files for sections for the arm in STL format. Each section has two corresponding files; one for visulaisation and one for collision checking algorithms. The colision check STL files are smaller in size to allow quicker processing this is achieved by decimating the mesh.

rviz

Setting files to view the model in the Robotic Operation System (ROS) visualisation tool (RViz). ROS has two ‘main’ versions, ROS1 and ROS2, with subsequent two versions of Rviz.

launch

ROS works by using started scripts or launch files start ‘nodes’. The launch folder contains launch files for ROS1 and ROS2. ROS2 uses python instead of the previous custom .launch file type.

Viewing Model

ROS 2 (distro foxy + Ubuntu 18.04 LTS)

This was tested on Ubuntu 18.04LTS with the ROS2 Foxy version. The following assumes Ros2 is already installed, if not then the webpage - https://docs.ros.org/en/dashing/Installation/Ubuntu-Install-Binary.html - is proably a good starting point to understanding how to install it.

Start by cloning the vispa repo to a suitable location.

git clone https://github.com/AirbusDefenceAndSpace/vispa.git
cd vispa

Then build the package using the following two commands. The author used the Zsh command shell, if using another one for instance, Bash, then change the suffix on ‘setup.’ to what is appropriate.

colcon build
. install/setup.zsh 

Then launch the rviz viewer that hopefully should load the Vispa Urdf and provide a small gui to control joint positions.

```bash

File truncated at 100 lines see the full file