ARS: Python robotics simulator

Note

This software and its documentation are currently under development so they will be subject to changes. Contributions are welcome!

Introduction

Welcome! This is the documentation of ARS 0.5, last updated on February 28, 2017.

ARS is written in a marvelous programming language called Python. One of the many features that make it great (and popular) is its documentation. Taking that into consideration, many sections herein were taken from the official Python documentation.

So simple

To create and run your first simulation, a few lines of code are enough! Execute the following script (press key q or e to end the simulation)

from ars.app import Program

class FallingBall(Program):

   def create_sim_objects(self):
      # add_sphere's arguments: radius, center, density
      self.sim.add_sphere(0.5, (1, 10, 1), density=1)

sim_program = FallingBall()
sim_program.start()
sim_program.finalize()

Official website

The repository is hosted at BitBucket where you will find the source code and the issue tracker. We would love that you request features or improvements for ARS. Also, bug reports are more than welcome.

Because we like the Python community and the tools they use, it is registered in PyPI (Python Package Index). Although useful for organizing packages, the main benefit is to be able to install (and upgrade) ARS using the pip program. It takes just 3 words:

$ pip install ARS

(well, you might have to prepend sudo if you are using Linux and running as a user without the required priveges. Bummer, that’s 4 words now...)

For support, check the Google group and join if you want to post a message.

Releases

version date revision
0.5b1 2013.12.13 8cde845244ae
0.5a2 2013.10.21 9fa5876718f0
0.5a1 2013.09.25 60c96b5b55ba
0.4a1 2013.04.13 f9c1381290bc
0.3a1 2012.10.17 b9190db2b909

News

What has happened lately...

Indices and tables