User Guide
==========

This section is intended for end users who want a practical workflow.


1. Input data and assumptions (GPX, GRIB, cyclist parameters, routes)
2. Simulation modes (replay, prediction)
3. Interpreting outputs (speed, power, virtual slope, wind score)
4. Tips and best practices
5. Typical troubleshooting
6. An appendix expliciting mathematics and physics used


.. toctree::
   :maxdepth: 2
   :caption: Contents

   user_guide/Input-data.md
   user_guide/Simulation.md
   user_guide/Analysis.md
   user_guide/Tips.md
   user_guide/Troubleshooting.md
   user_guide/math_used.md