Poppy-creature is a small library providing an abstract interface for robots (Poppy Humanoid, Poppy Torso, Poppy Ergo Jr...). It links high level controls and pypot, the generic low level library.
It mainly contains the class definition of poppy.creatures.abstractcreature.AbstractPoppyCreature which takes a configuration and builds a pypot.robot.robot.Robot out of it, but also a bunch of parameters to launch Snap! or HTTP servers, or to replace the communication toward Dynamixel servos by a communication with a simulator.
The arguments you can provide are:
base_pathdefault: None Path where the creature sources are. The librarie looks in the default PATH if not set.
configdefault: None Path to the configuration file with respect to the base-path
simulatordefault: None Possible values : 'vrep' or 'poppy-simu'. Defines if we are using a simulator (and which one) or a real robot.
scenedefault: None Path to the scene to load in the simulator. Only if simulator is vrep. Defaults to the scene present in the creature library if any (e.g. poppy_humanoid.ttt).
hostdefault: 'localhost' Hostname of the machine where the simulator runs. Only if simulator is not None.
portdefault: 19997 Port of the simulator. Only if simulator is not None.
use_snapdefault: False Should we launch the Snap! server
snap_hostdefault: 0.0.0.0 Hostname of the Snap! server
snap_portdefault: 6969 Port of the Snap! server
snap_quietdefault: True Should Snap! not output logs
use_httpdefault: False Should we launch the HTTP server (for
http_hostdefault: 0.0.0.0 Hostname of the HTTP server
http_portdefault: 8080 Port of the HTTP server
http_quietdefault: True Should HTTP not output logs
use_remotedefault: False Should we launch the Remote Robot server
remote_hostdefault: 0.0.0.0 Hostname of the Remote Robot server
remote_portdefault: 4242 Port of the Remote Robot server
syncdefault: True Should we launch the synchronization loop for motor communication
The sources are available on GitHub.
Poppy-creature also provides a command line utility poppy-services. It provides shortcuts to start services like SnapRemoteServer and HTTPRemoteServer from your terminal. Example:
poppy-services poppy-ergo-jr --snap --no-browser
This will launch the SnapRemoteServer for a real Poppy Ergo Jr robot.
--no-browseroption avoid the automatic redirection to the Snap! webpage. You can remove it if you use a computer with a GUI (e.g your laptop instead of the robot embedded board).
poppy-services poppy-ergo-jr --snap --poppy-simu
It will open a Snap! windows for a simulated poppy-ergo-jr.
The way to use it is:
poppy-services <creature_name> <options>
the available options are:
--vrep: creates the specified creature for using with V-REP simulator
--poppy-simu: creates the specified creature for using with web simulator and also launches the HTTP server needed by poppy-simu. Poppy-simu is only available for poppy-erg-jr for now.
--snap: launches the Snap! server and directly imports the specific Poppy blocks.
--no-browser: avoid automatic start of Snap! in web browser, use only with --snap
--http: start a http robot server
--remote: start a remote robot server
--verbose: start services in verbose mode (more logs)
Create your own Poppy creature
While developping a new Poppy creature, it is first easier to simply define it in a configuration file or dictionnary and instanciate a pypot.robot.robot.Robot from Pypot directly.
But when you want to make it easily usable and available to non-geek public, the best is to create your own creature's library. It should contain a configuration file and a class that extends poppy.creatures.abstractcreature.AbstractPoppyCreature. You can then add your own properties and primitives.
Example from Poppy Humanoid:
class PoppyHumanoid(AbstractPoppyCreature): def setup(cls, robot): robot._primitive_manager._filter = partial(numpy.sum, axis=0) for m in robot.motors: m.goto_behavior = 'minjerk' for m in robot.torso: m.compliant_behavior = 'safe' # Attach default primitives: # basic primitives: robot.attach_primitive(StandPosition(robot), 'stand_position') robot.attach_primitive(SitPosition(robot), 'sit_position') # Safe primitives: robot.attach_primitive(LimitTorque(robot), 'limit_torque')
Package your code it properly using setuptools.
For a better integration with the Poppy installer scripts, please have in the root of your repo a folder named software containing:
- the installation files (setup.py, MANIFEST, LICENCE)
- a folder named poppy_yourcreaturename containing your actual code
At the end, don't forget to share it to the community! Most interesting creatures will be added to this documentation!
poppy-creature library is a dependancy of any Poppy robots libraries, so you don't have to install it by hand in a normal case.
To install the poppy-creature library, you can use pip:
pip install poppy-creature
Then you can update it with:
pip install --upgrade poppy-creature
If you prefer to work from the sources (latest but possibly unstable releases), you can clone them from GitHub and install them with (in the software folder):
python setup.py install