README.md 2.06 KB
Newer Older
Guilhem Saurel's avatar
Guilhem Saurel committed
1
# Example robot URDFs
2

Guilhem Saurel's avatar
Guilhem Saurel committed
3
[![pipeline status](https://gitlab.laas.fr/gepetto/example-robot-data/badges/master/pipeline.svg)](https://gitlab.laas.fr/gepetto/example-robot-data/-/commits/master)
4

Guilhem Saurel's avatar
Guilhem Saurel committed
5
6
This repository includes a set of robot descriptions that are aimed to be used in benchmarking, unit-tests, teachings,
tutorials or show-cases. These source files do not intend to substitute their original repositories.
7

Guilhem Saurel's avatar
Guilhem Saurel committed
8
## :penguin: Installation
9

Guilhem Saurel's avatar
Guilhem Saurel committed
10
### :package: From Debian / Ubuntu packages, with [robotpkg](http://robotpkg.openrobots.org)
11

Guilhem Saurel's avatar
Guilhem Saurel committed
12
13
14
15
16
1. If you have never added robotpkg's software repository, [do it now](http://robotpkg.openrobots.org/debian.html):
   ```bash
   sudo tee /etc/apt/sources.list.d/robotpkg.list <<EOF
   deb [arch=amd64] http://robotpkg.openrobots.org/packages/debian/pub $(lsb_release -sc) robotpkg
   EOF
17

Guilhem Saurel's avatar
Guilhem Saurel committed
18
19
20
   curl http://robotpkg.openrobots.org/packages/debian/robotpkg.key | sudo apt-key add -
   sudo apt update
   ```
21

Guilhem Saurel's avatar
Guilhem Saurel committed
22
23
24
25
2. installation of example-robot-data and its python utils:
   ```bash
   sudo apt install robotpkg-py3\*-example-robot-data
   ```
26

27
28
29
30
31
32
33
34
35
36
37
### :turtle: With ROS

Just clone it (with `--recursive`) into a catkin workspace.

### :file_folder: From source

Clone it (with `--recursive`), create a `build` directory inside, and:
```bash
cmake .. && make && make install
```

Guilhem Saurel's avatar
Guilhem Saurel committed
38
## :robot: Show a robot with [gepetto-gui](https://github.com/gepetto/gepetto-viewer-corba)
39

Guilhem Saurel's avatar
Guilhem Saurel committed
40
`python -m example_robot_data -h` to list available robots.
Guilhem Saurel's avatar
Guilhem Saurel committed
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

## :copyright: Credits

### :writing_hand: Written by

- [Carlos Mastalli](https://cmastalli.github.io/), The University of Edinburgh :uk:
- [Guilhem Saurel](https://github.com/nim65s), LAAS-CNRS :fr:

### :construction_worker: With contributions from

- [Justin Carpentier](https://jcarpent.github.io/), INRIA :fr:
- [Pierre Fernbach](https://pfernbach.github.io/), LAAS-CNRS :fr:
- [Florent Lamiraux](https://gepettoweb.laas.fr/index.php/Members/FlorentLamiraux), LAAS-CNRS :fr:
- [Wolfgang Merkt](http://www.wolfgangmerkt.com/research/), University of Oxford :uk:
- [Josep Martí Saumell](https://www.iri.upc.edu/staff/jmarti), IRI: CSIC-UPC :es: