@@ -9,8 +9,10 @@ black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://gith
9
9
10
10
![ Phobos] ( https://github.com/dfki-ric/phobos/wiki/img/phobos_logo_small.png )
11
11
12
- Phobos is an add-on for the open-source 3D modeling software
13
- [ Blender] ( http://www.blender.org ) that enables the creation of WYSIWYG robot
12
+ Phobos is both a CLI tool and add-on for the open-source 3D modeling software
13
+ [ Blender] ( http://www.blender.org ) to support your robot model creation and editing
14
+
15
+ The Blender add-on enables the creation of WYSIWYG robot
14
16
models for use in robot frameworks like [ ROS] ( http://wiki.ros.org/ ) and
15
17
[ ROCK] ( https://github.com/rock-core ) or in real-time simulations such as
16
18
[ MARS] ( https://github.com/rock-simulation/mars ) or
@@ -25,7 +27,8 @@ Bremen, together with the [Robotics
25
27
Group] ( http://www.informatik.uni-bremen.de/robotik/index_en.php ) of the
26
28
[ University of Bremen] ( http://www.uni-bremen.de/en.html ) .
27
29
28
- Please contact [ Kai von Szadkowski] ( https://robotik.dfki-bremen.de/de/ueber-uns/mitarbeiter/kavo01.html )
30
+ Please contact [ Kai von Szadkowski] ( https://robotik.dfki-bremen.de/de/ueber-uns/mitarbeiter/kavo01.html ) or
31
+ [ Henning Wiedemann] ( https://robotik.dfki-bremen.de/de/ueber-uns/mitarbeiter/hewi04.html )
29
32
for any inquiries, or any questions and feedback not suited for the issues
30
33
page.
31
34
@@ -49,10 +52,28 @@ If you are on the hunt for a BiBTeX entry, check out the [FAQ section](https://g
49
52
50
53
## Installation
51
54
55
+ ### Blender
52
56
Just zip the ` phobos ` subfolder: ` zip -r phobos.zip phobos ` and install it via Blender: ` blender->edit->preferences->addons->install `
53
57
58
+ ### CLI
59
+ Just install it using pip:
60
+ ``` bash
61
+ cd phobos
62
+ pip install .
63
+ ```
64
+ or without pip:
65
+ ``` bash
66
+ cd phobos
67
+ python setup.py install
68
+ ```
69
+ or with autoproj:
70
+ 1 ) Add the package to your buildconf/package_set
71
+ 2 ) Install via ` amake `
72
+
54
73
## Overview
55
74
75
+ ### Blender
76
+
56
77
![ Model of the SpaceClimber robot in Blender, next to the Phobos toolbar
57
78
displayed on the
58
79
left.] ( https://github.com/dfki-ric/phobos/wiki/img/phobos_spaceclimber.png )
@@ -83,10 +104,17 @@ in Blender.](https://github.com/dfki-ric/phobos/wiki/img/phobos_elements.png)
83
104
in Blender. These elements can be arranged in Blender on different layers, thus
84
105
avoiding confusion or obstruction of view when editing very complex models.*
85
106
107
+ ### CLI
108
+
109
+ You can either use CLI-phobos as a normal python package or use the scripts provided with it.
110
+
111
+ For the latter do ` phobos --help ` to get a list of the currently available scripts.
112
+ It will also tell you which dependencies are missing for some scripts.
86
113
87
114
## Features
88
115
89
116
- WYSIWYG editor for robot models using Blender
117
+ - CLI tool for automated model processing
90
118
- Import and export of ** URDF** , ** SDF** ** SMURF** and other
91
119
[ formats] ( https://github.com/dfki-ric/phobos/wiki/Formats )
92
120
- Easy definition of robot kinematics (links and joints)
0 commit comments