This is the source repository for TuLiP, the temporal logic planning toolbox. The project website is http://tulip-control.org
In most cases, it suffices to:
pip install .
TuLiP can be installed also from PyPI:
pip install tulip
This will install the latest release, together with required dependencies. To find out what dependencies (including optional ones) are installed, call:
tulip.interfaces.print_env()
For detailed instructions, including notes about dependencies and troubleshooting,
consult https://tulip-control.sourceforge.io/doc/install.html
The next section describes how to build documentation.
A test suite is provided under tests/. Consult the section "Testing" below.
Pip can install the latest development snapshot too:
pip install https://github.com/tulip-control/tulip-control/archive/master.zip
Code under development can be unstable so trying pip install tulip first is recommended.
There are two main sources of documentation outside the code. The "user"
documentation is under doc/ and is built with Sphinx, so the usual steps apply,
make html
API documentation is generated using Epydoc
and can also be built from the doc directory, now by
make api
Built copies for the most recent release of TuLiP are available online at:
Command summaries are provided by make help. Besides the above sources, you
may also read API documentation using the standard pydoc tool. E.g.,
pydoc tulip
Tests are performed using pytest. From the
root of the source tree (i.e., where setup.py is located),
./run_tests.py
to perform basic tests. To try all available tests, ./run_tests.py full.
For alternatives and a summary of usage, ./run_tests.py -h
- Ask for help on the tulip-control-users mailing list
- For release announcements, join the tulip-control-announce mailing list
- Bug reports and feature requests should be made at https://github.com/tulip-control/tulip-control/issues Please check for prior discussion and reports before opening a new issue.
This is free software released under the terms of the BSD 3-Clause License. There is no warranty; not even for merchantability or fitness for a particular purpose. Consult LICENSE for copying conditions.
When code is modified or re-distributed, the LICENSE file should accompany the code or any subset of it, however small. As an alternative, the LICENSE text can be copied within files, if so desired.
If this software is useful to you, we kindly ask that you cite us:
I. Filippidis, S. Dathathri, S. C. Livingston, N. Ozay and R. M. Murray, "Control design for hybrid systems with TuLiP: The Temporal Logic Planning toolbox," 2016 IEEE Conference on Control Applications (CCA), Buenos Aires, Argentina, 2016, pp. 1030-1041, doi: 10.1109/CCA.2016.7587949.