===============
Tutorials
===============

Welcome to the Climate Diagnostics Toolkit tutorials! These step-by-step guides will help you get the most out of the toolkit.

📚 **Tutorial Series**
=======================

.. toctree::
   :maxdepth: 2
   :numbered:

   basic_usage

🎯 **What You'll Learn**
=========================

.. grid:: 2
   :gutter: 3

   .. grid-item-card:: 🚀 Getting Started
      :text-align: center

      Basic usage patterns and data loading
      
      +++
      
      .. button-ref:: basic_usage
         :expand:
         :color: primary
         :click-parent:
         
         Start Here

   .. grid-item-card:: 🗺️ Plotting
      :text-align: center

      Create beautiful climate visualizations
      
      +++
      
      See :doc:`../user_guide/plotting` for details

   .. grid-item-card:: 📈 Time Series
      :text-align: center

      Analyze temporal patterns and trends
      
      +++
      
      Time series analysis tutorials

   .. grid-item-card:: 🔬 Advanced
      :text-align: center

      Statistical methods and custom workflows
      
      +++
      
      Advanced analysis techniques

💡 **Prerequisites**
=====================

Before starting these tutorials, make sure you have:

- Python 3.11+ installed
- Basic familiarity with NumPy and xarray
- Climate Diagnostics Toolkit installed
- Sample climate data (we'll show you how to get some!)

🔗 **Additional Resources**
============================

- :doc:`../quickstart` - Quick reference guide
- :doc:`../api/index` - Complete API documentation
- :doc:`../examples/index` - Real-world examples