Tutorials
=========

.. toctree::
   :maxdepth: 2

   basic_usage
   bias_correction
   streaming_polls
   algorithm_comparison

This section provides step-by-step tutorials for common use cases of the 
``onlinerake`` package. Each tutorial includes complete code examples and
explanations of the key concepts.

Tutorial Overview
-----------------

:doc:`basic_usage`
   Learn the fundamentals of online raking with a simple example.

:doc:`bias_correction`
   Correct demographic bias in online surveys using real-world scenarios.

:doc:`streaming_polls`
   Handle real-time polling data with changing demographics over time.

:doc:`algorithm_comparison`
   Compare SGD vs MWU algorithms and choose the right one for your use case.

Prerequisites
-------------

Before working through these tutorials, make sure you have:

- Installed the ``onlinerake`` package (:doc:`../installation`)
- Basic familiarity with Python and pandas
- Understanding of survey weighting concepts (helpful but not required)

Getting Help
------------

If you encounter issues with any tutorial:

- Check the :doc:`../api_reference` for detailed parameter descriptions
- Review the :doc:`../examples` for additional use cases
- Open an issue on GitHub if you find bugs or have suggestions