Documentation
=============

This is some documentation for our project.

It is written in reStructuredText format. However, it contains embedded Python
code which serve as examples. For instance, the following snippet:

.. code:: python

    import numpy as np
    import matplotlib.pyplot as plt

    def test_function(A):
        f = 17.2
        t = np.linspace(0.5, 0.6, 200)
        return t, A * np.sin(2 * np.pi * f * t)

    time, signal = test_function(1.55)
    plt.plot(time, signal)

Ideally, this document would *not* be identified as a Python script.