Examples
========

PlotSmith includes comprehensive examples demonstrating its capabilities.

Jupyter Notebooks
-----------------

Interactive Jupyter notebooks are available in the ``examples/notebooks/`` directory:

- :doc:`01_introduction` - Overview and getting started
- :doc:`02_timeseries` - Time series plotting with confidence bands
- :doc:`03_model_evaluation` - Model evaluation and backtesting
- :doc:`04_statistical_plots` - Histograms and bar charts
- :doc:`05_heatmaps` - Correlation matrices and heatmaps
- :doc:`06_styling_customization` - Advanced styling and annotations
- :doc:`07_composition` - Small multiples and figure layouts

Python Scripts
--------------

- ``examples/basic_timeseries.py`` - Basic time series example

New Chart Types
---------------

Comprehensive examples for all new chart types:

- :doc:`examples_new_charts` - Waterfall, Waffle, Dumbbell, Range, Lollipop, Slope, Metric, Box, Violin, Scatter, Correlation, and Forecast Comparison charts

To run the notebooks, install PlotSmith with examples dependencies:

.. code-block:: bash

   # Using uv (recommended)
   uv pip install plotsmith[examples]
   
   # Or using pip
   pip install plotsmith[examples]

Then open the notebooks in Jupyter:

.. code-block:: bash

   jupyter notebook examples/notebooks/