Miss comments and documentation on the source code

[clopez]

The code looks clean and readable (mainly because it's python).

But it will be desirable to include more comments on the source code and a few documentation about each function.

It's easy to comment the code meanwhile you write it and help other people to understand it easily.