Tutorial

To get started with RidePy, following this tutorial is a good option. The tutorials are based on jupyter notebooks. Because of this, you can either view them here as part of the documentation or run them on your machine to get hands-on experience.

Available tutorials

• 1 | Basics
• 2 | Cython
• 3 | Graphs
• 4 | Parallelization

Executing the tutorial notebooks yourself

To run these notebooks locally, you’ll need to install RidePy first. Then, either clone the git repository:

git clone --recurse-submodules https://github.com/PhysicsOfMobility/ridepy.git
cd ridepy

or download the repository as a ZIP archive here.

To run the notebooks, you will either need JupyterLab (recommended) or Jupyter Notebook.

In addition, Jupytext is required to use the MyST-Markdown format in which the notebooks are kept in the repository for easier version control:

pip install -U jupytext

With Jupytext installed, run jupyter lab or jupyter notebook. Open any of the introductory notebooks in doc/notebooks, either just by clicking on it (in Jupyter Notebook) or by right-clicking and choosing Open With > Notebook (in JupyterLab). Now you can run the notebook step-by-step and play around :)