Home

What is Playful

Playful is a scripting language for complex runtime orchestration of Python API. It is meant for professional roboticists who want to acquire the skill to develop reactive complex behaviors. It supports:

• encoding of applications in dynamic behavior trees
• mixing of logics (conditional, prioritized and state machine)
• dynamic runtime restructure of the tree and online setup of sensory motor couplings
• encoding of sensory information into discrete scheme systems.

If anything in this tutorial is unclear, we are happy to get feedback on [email protected]. Merge requests for improvement of this tutorial are also welcomed.

How-to run one of the tutorial

The tutorial consists of 10 "subtutorials", enumerated from tutorial1 to tutorial10. To each corresponds a playful script that can be executed.

1. download playful executable from playful.is.tuebingen.mpg.de.
2. make the downloaded file executable (in a terminal: 'chmod +x ./playful')
3. the executable does not need installation. Update the $PATH to include the executable (see below).
4. in a terminal: go to any of the tutorial folder (e.g.: 'cd <>/playful_tutorial/tutorial8')
5. in the terminal: run the executable passing "execute" as parameter ('playful execute'). Press 'q' to exit

To update the $PATH

Add the following line in ~/.bashrc:

export PATH=${PATH}:path to the directory which contains the playful executable

Start a new terminal. You can check if things work by typing "playful" in this new terminal. You should see something similar to:

Playful v1.0. Copyright 2015 Vincent Berenz , Copyright 2015-2018 Max Planck Gesellschaft
License information: free of charge exclusively to non-profit organization for use on non-profit projects
Visit: playful.is.tuebingen.mpg.de | support: [email protected]

More information:

• https://askubuntu.com/questions/60218/how-to-add-a-directory-to-the-path
• https://help.ubuntu.com/community/EnvironmentVariables#Persistent_environment_variables

How to go through all tutorials

• Visit the tutorial wiki pages, they will display code and information
• On your machine, run the playful executable for each tutorial, as explained in the section above

Requirements

• Ubuntu
• Any (relatively) recent Python 2.7 should be installed as default Python interpreter. (Python 3 will not work) (this is default on any version of ubuntu)

Things not working ?

contact [email protected]

We hope Playful will be as useful to you as it has been useful to us :)