User guide

A full user guide is currently being developed. In the meantime, here are some examples to get started:

# .. literalinclude:: examples/example_1_README.py # :language: python