README.md 2.62 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)
Carlos Mastalli's avatar
Carlos Mastalli committed
4
5
[![conde version](https://img.shields.io/conda/vn/conda-forge/example-robot-data.svg)](https://anaconda.org/conda-forge/example-robot-data)
[![conde download](https://anaconda.org/conda-forge/example-robot-data/badges/downloads.svg)](https://anaconda.org/conda-forge/example-robot-data)
Guilhem Saurel's avatar
Guilhem Saurel committed
6
[![PyPI version](https://badge.fury.io/py/example-robot-data.svg)](https://badge.fury.io/py/example-robot-data)
Carlos Mastalli's avatar
Carlos Mastalli committed
7

8

Guilhem Saurel's avatar
Guilhem Saurel committed
9
10
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.
11

Guilhem Saurel's avatar
Guilhem Saurel committed
12
## :penguin: Installation
13

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

Guilhem Saurel's avatar
Guilhem Saurel committed
16
17
18
19
20
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
21

Guilhem Saurel's avatar
Guilhem Saurel committed
22
23
24
   curl http://robotpkg.openrobots.org/packages/debian/robotpkg.key | sudo apt-key add -
   sudo apt update
   ```
25

Guilhem Saurel's avatar
Guilhem Saurel committed
26
27
28
29
2. installation of example-robot-data and its python utils:
   ```bash
   sudo apt install robotpkg-py3\*-example-robot-data
   ```
Guilhem Saurel's avatar
Guilhem Saurel committed
30

31
32
33
34
35
36
### :snake: From <img src="https://s3.amazonaws.com/conda-dev/conda_logo.svg" height="18">

As simple as that:
```bash
   conda install example-robot-data -c conda-forge
```
37

38
39
40
41
42
43
44
45
46
47
48
### :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
49
## :robot: Show a robot with [gepetto-gui](https://github.com/gepetto/gepetto-viewer-corba)
50

Guilhem Saurel's avatar
Guilhem Saurel committed
51
`python -m example_robot_data -h` to list available robots.
Guilhem Saurel's avatar
Guilhem Saurel committed
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

## :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: