Altair: Declarative Visualization in Python
===========================================
.. role:: raw-html(raw)
   :format: html


.. altair-minigallery::
   :names: one_dot_per_zipcode, horizon_graph, world_projections, candlestick_chart, falkensee, scatter_linked_brush, layered_heatmap_text, natural_disasters, streamgraph, multiline_tooltip, select_detail, choropleth, interactive_cross_highlight, seattle_weather_interactive, london_tube
   :size: 15

Altair is a declarative statistical visualization library for Python, based on
Vega_ and Vega-Lite_, and the source is available on
`GitHub <http://github.com/altair-viz/altair>`_.

With Altair, you can spend more time understanding your data and its meaning.
Altair's API is simple, friendly and consistent and built on top of the
powerful Vega-Lite_ visualization grammar. This elegant simplicity produces
beautiful and effective visualizations with a minimal amount of code.

.. toctree::
   :maxdepth: 1
   :caption: Getting Started

   getting_started/overview
   getting_started/installation
   getting_started/starting

.. toctree::
   :maxdepth: 1
   :caption: Gallery

   gallery/index

.. toctree::
   :maxdepth: 1
   :caption: User Guide

   user_guide/data
   user_guide/encoding
   user_guide/marks
   user_guide/transform/index
   user_guide/interactions
   user_guide/configuration
   user_guide/compound_charts
   user_guide/scale_resolve
   user_guide/saving_charts
   user_guide/customization
   user_guide/times_and_dates
   user_guide/faq
   user_guide/troubleshooting
   user_guide/internals
   user_guide/API
   user_guide/ecosystem

.. toctree::
   :maxdepth: 1
   :caption: Case Studies

   case_studies/exploring-weather

.. toctree::
   :maxdepth: 1
   :caption: Advanced Usage

   user_guide/importing
   user_guide/display_frontends
   user_guide/custom_renderers
   user_guide/data_transformers

.. toctree::
   :maxdepth: 1
   :caption: Release Notes
   
   releases/changes

Bug Reports & Questions
-----------------------

Altair is BSD-licensed and the source is available on `GitHub`_. If any
questions or issues come up as you use Altair, please get in touch via
`Git Issues`_ or our `Google Group`_.


Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`


.. _GitHub: http://github.com/altair-viz/altair
.. _Git Issues: http://github.com/altair-viz/altair/issues
.. _Vega: http://vega.github.io/vega
.. _Vega-Lite: http://vega.github.io/vega-lite
.. _Google Group: https://groups.google.com/forum/#!forum/altair-viz
