skip to navigation
skip to content

ARS 0.5b1

Physically-accurate robotics simulator

Package Documentation

ARS: Autonomous Robot Simulator

.. image::

ARS is a physically-accurate robotics simulator written in Python.
It's main purpose is to help researchers to develop mobile
manipulators and, in general, any multi-body system. It
is open-source, modular, easy to learn and use,
and can be a valuable tool in the process
of robot design, in the development of control and reasoning algorithms, as
well as in teaching and educational activities.

It will encompass a wide range of tools spanning from kinematics and dynamics
simulation to robot interfacing and control.

ARS uses
`Open Dynamics Engine (ODE) <https:"" projects="" opende=""/>`_
as physics engine, and
`Visualization Toolkit (VTK) <http:""/>`_
as graphics engine.
While both are well regarded and popular open-source software,
ARS was designed to minimize coupling with them
(through included abstraction layers)
to let developers experiment with other alternatives.


Because ARS is ``pip``-compatible,
it's very easy to install, upgrade and uninstall it:

.. code-block:: bash

$ pip install ARS
$ pip install --upgrade ARS
$ pip uninstall ARS

While that's the recommended way to go, you may still follow
the old-fashion procedure: download the file, unpack and run

.. code-block:: bash

$ python install


ARS needs:

* Python 2.6 or 2.7
* ODE (Open Dynamics Engine) 0.12 with Python bindings
* VTK (Visualization Toolkit) 5.8 with Python bindings
* NumPy 1.6

ODE and VTK can be somewhat complicated to install, depending on your OS.

For detailed installation instructions (ARS and requirements)
and troubleshooting, see the
`online documentation <http:"" en="" latest="" installation=""/>`_.


The documentation is hosted at
` <http:"">`_
and it is generated dynamically after each commit to the repository.


This software is licensed under the OSI-approved "BSD License". To avoid
confusion with the original BSD license from 1990, the FSF refers to it as
"Modified BSD License". Other names include "New BSD", "revised BSD", "BSD-3",
or "3-clause BSD".

See the included LICENSE.txt file.


To run the included test suite you need more packages (``tox`` and ``mock``):

.. code-block:: bash

~/ars$ pip install -r requirements_test.txt
~/ars$ tox  
File Type Py Version Uploaded on Size
ARS-0.5b1-py27-none-any.whl (md5) Python Wheel any 2013-12-13 66KB
ARS-0.5b1.tar.gz (md5) Source 2013-12-13 73KB
ARS-0.5b1.win32.exe (md5) MS Windows installer 2.7 2013-12-13 259KB (md5) Source 2013-12-13 110KB