.. _python_API_tutorials:

.. currentmodule:: flow360

**************************
Tutorials
**************************

This section offers practical, hands-on tutorials to help you master the Flow360 Python API. Whether you're a beginner or an experienced CFD practitioner, these tutorials will guide you through real-world applications and essential concepts.

.. grid:: 1

    .. grid-item-card:: 📓 Jupyter Notebooks
        :link: notebooks/index
        :link-type: doc
        
        Interactive Jupyter notebook tutorials demonstrating complete CFD workflows from setup to analysis.

    .. grid-item-card:: 📏 Working with Units
        :link: units
        :link-type: doc
        
        Master the use of physical units in Flow360 for consistent, error-free simulations across different unit systems.

What You'll Learn
===============

* Complete CFD workflows from geometry import to results analysis
* Best practices for structuring your Flow360 Python code
* Techniques for automating repetitive simulation tasks
* How to properly handle physical units in your simulations
* Approaches for post-processing and visualizing CFD results
* Integration of Flow360 with other scientific Python libraries

How to Use These Tutorials
========================

We recommend approaching these tutorials in the following ways:

* **Beginners:** Start with the Jupyter Notebooks to see complete workflows in action
* **All users:** Review the Units tutorial to ensure your simulations maintain proper physical consistency
* **Method:** Run the code examples in your own environment and experiment with modifications

.. toctree::
   :hidden:

   notebooks/index
   units