************************************
``plotly`` module
************************************
The plotly module in the ``visualization_toolkit`` contains higher-order-functions to generate
plotly charts that match company branding and visual-best practices. Core charts such as line, bar, area, and
combo charts can be creating using this module.

While good defaults are used to style charts, many options exist to customize the visualizations
to craft effective visual content. The styling defaults are stored in the `plotly.helpers.theme` module.

Core Charting Functions
===================================
Function-based building blocks to create a majority of charting content.

.. autoapifunction:: visualization_toolkit.helpers.plotly.chart

.. autofunction:: visualization_toolkit.helpers.plotly.axis

.. autofunction:: visualization_toolkit.helpers.plotly.series

.. autofunction:: visualization_toolkit.helpers.plotly.shade_series

.. autofunction:: visualization_toolkit.helpers.plotly.annotation

.. autofunction:: visualization_toolkit.helpers.plotly.shade_x

.. autofunction:: visualization_toolkit.helpers.plotly.shade_y

Advanced Charting Functions
===================================
Specific functions to create custom chart types such as waterfall charts or heatmaps

.. autoapifunction:: visualization_toolkit.helpers.plotly.heatmap_chart

.. autoapifunction:: visualization_toolkit.helpers.plotly.waterfall_chart


Plotly Base Functions
===================================
General utilities to build custom visualizations with plotly are found here. These include lower-level functions that ``chart`` will build upon.

.. autofunction:: visualization_toolkit.helpers.plotly.generate_base_figure

.. autofunction:: visualization_toolkit.helpers.plotly.highlight_trace

.. autofunction:: visualization_toolkit.helpers.plotly.disable_hover_labels