index.html

<!DOCTYPE html>
<html class="writer-html5" lang="en">

<head>
  <meta charset="utf-8" />
  <meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Vega-Altair: Declarative Visualization in Python &mdash; Altair 4.2.2 documentation</title>
  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="_static/altair-plot.css" type="text/css" />
  <link rel="stylesheet" href="_static/altair-gallery.css" type="text/css" />
  <link rel="stylesheet" href="_static/theme_overrides.css" type="text/css" />
  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
  <link rel="shortcut icon" href="_static/favicon.ico" />
  <!--[if lt IE 9]>
    <script src="_static/js/html5shiv.min.js"></script>
  <![endif]-->

  <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
  <script src="_static/jquery.js"></script>
  <script src="_static/underscore.js"></script>
  <script src="_static/doctools.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/vega@5"></script>
  <script src="https://cdn.jsdelivr.net/npm/vega-lite@4.17.0"></script>
  <script src="https://cdn.jsdelivr.net/npm/vega-embed@6"></script>
  <script src="_static/js/theme.js"></script>
  <link rel="index" title="Index" href="genindex.html" />
  <link rel="search" title="Search" href="search.html" />
  <link rel="next" title="Overview" href="getting_started/overview.html" />
</head>

<body class="wy-body-for-nav">
  <header>
    <div class="announcement">

      <span>This website is for Vega-Altair v4. Go to the&nbsp;<a href="https://altair-viz.github.io">main Vega-Altair
          homepage</a>&nbsp;for the latest release.</span>

    </div>
  </header>
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search">
          <a href="#" class="icon icon-home"> Altair
            <img src="_static/altair-logo-light.png" class="logo" alt="Logo" />
          </a>
          <div class="version">
            4.2.2
          </div>
          <div role="search">
            <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
              <input type="text" name="q" placeholder="Search docs" />
              <input type="hidden" name="check_keywords" value="yes" />
              <input type="hidden" name="area" value="default" />
            </form>
          </div>
        </div>
        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
          <p class="caption" role="heading"><span class="caption-text">Getting Started</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="getting_started/overview.html">Overview</a></li>
            <li class="toctree-l1"><a class="reference internal"
                href="getting_started/installation.html">Installation</a></li>
            <li class="toctree-l1"><a class="reference internal"
                href="getting_started/installation.html#dependencies">Dependencies</a></li>
            <li class="toctree-l1"><a class="reference internal"
                href="getting_started/installation.html#development-install">Development Install</a></li>
            <li class="toctree-l1"><a class="reference internal" href="getting_started/starting.html">Basic Statistical
                Visualization</a></li>
          </ul>
          <p class="caption" role="heading"><span class="caption-text">Gallery</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="gallery/index.html">Example Gallery</a></li>
          </ul>
          <p class="caption" role="heading"><span class="caption-text">User Guide</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/data.html">Specifying Data in
                Altair</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/encoding.html">Encodings</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/marks.html">Marks</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/transform/index.html">Data
                Transformations</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/interactions.html">Bindings,
                Selections, Conditions: Making Charts Interactive</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/configuration.html">Top-Level Chart
                Configuration</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/compound_charts.html">Compound Charts:
                Layer, HConcat, VConcat, Repeat, Facet</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/scale_resolve.html">Scale and Guide
                Resolution</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/saving_charts.html">Saving Altair
                Charts</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/customization.html">Customizing
                Visualizations</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/times_and_dates.html">Times and Dates
                in Altair</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/faq.html">Frequently Asked
                Questions</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/troubleshooting.html">Display
                Troubleshooting</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/internals.html">Altair Internals:
                Understanding the Library</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/API.html">API Reference</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/ecosystem.html">Altair Ecosystem</a>
            </li>
          </ul>
          <p class="caption" role="heading"><span class="caption-text">Case Studies</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="case_studies/exploring-weather.html">Exploring
                Seattle Weather</a></li>
          </ul>
          <p class="caption" role="heading"><span class="caption-text">Advanced Usage</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/importing.html">Importing Vega &amp;
                Vega-Lite Versions</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/display_frontends.html">Displaying
                Altair Charts</a></li>
            <li class="toctree-l1"><a class="reference internal"
                href="user_guide/display_frontends.html#renderer-api">Renderer API</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/custom_renderers.html">Customizing
                Renderers</a></li>
            <li class="toctree-l1"><a class="reference internal" href="user_guide/data_transformers.html">Data
                transformers</a></li>
          </ul>
          <p class="caption" role="heading"><span class="caption-text">Release Notes</span></p>
          <ul>
            <li class="toctree-l1"><a class="reference internal" href="releases/changes.html">Altair Change Log</a></li>
          </ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
      <nav class="wy-nav-top" aria-label="Mobile navigation menu">
        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
        <a href="#">Altair</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
            <ul class="wy-breadcrumbs">
              <li><a href="#" class="icon icon-home"></a> &raquo;</li>
              <li>Vega-Altair: Declarative Visualization in Python</li>
              <li class="wy-breadcrumbs-aside">
                <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
              </li>
            </ul>
            <hr />
          </div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
            <div itemprop="articleBody">

              <section id="altair-declarative-visualization-in-python">
                <h1>Vega-Altair: Declarative Visualization in Python<a class="headerlink"
                    href="#altair-declarative-visualization-in-python" title="Permalink to this headline"></a></h1>
                <div id="showcase">
                  <div class="examples">

                    <a class="preview" href="gallery/one_dot_per_zipcode.html"
                      style="background-image: url(/_static/one_dot_per_zipcode-thumb.png)"></a>

                    <a class="preview" href="gallery/horizon_graph.html"
                      style="background-image: url(/_static/horizon_graph-thumb.png)"></a>

                    <a class="preview" href="gallery/world_projections.html"
                      style="background-image: url(/_static/world_projections-thumb.png)"></a>

                    <a class="preview" href="gallery/candlestick_chart.html"
                      style="background-image: url(/_static/candlestick_chart-thumb.png)"></a>

                    <a class="preview" href="gallery/falkensee.html"
                      style="background-image: url(/_static/falkensee-thumb.png)"></a>

                    <a class="preview" href="gallery/scatter_linked_brush.html"
                      style="background-image: url(/_static/scatter_linked_brush-thumb.png)"></a>

                    <a class="preview" href="gallery/layered_heatmap_text.html"
                      style="background-image: url(/_static/layered_heatmap_text-thumb.png)"></a>

                    <a class="preview" href="gallery/natural_disasters.html"
                      style="background-image: url(/_static/natural_disasters-thumb.png)"></a>

                    <a class="preview" href="gallery/streamgraph.html"
                      style="background-image: url(/_static/streamgraph-thumb.png)"></a>

                    <a class="preview" href="gallery/multiline_tooltip.html"
                      style="background-image: url(/_static/multiline_tooltip-thumb.png)"></a>

                    <a class="preview" href="gallery/select_detail.html"
                      style="background-image: url(/_static/select_detail-thumb.png)"></a>

                    <a class="preview" href="gallery/choropleth.html"
                      style="background-image: url(/_static/choropleth-thumb.png)"></a>

                    <a class="preview" href="gallery/interactive_cross_highlight.html"
                      style="background-image: url(/_static/interactive_cross_highlight-thumb.png)"></a>

                    <a class="preview" href="gallery/seattle_weather_interactive.html"
                      style="background-image: url(/_static/seattle_weather_interactive-thumb.png)"></a>

                    <a class="preview" href="gallery/london_tube.html"
                      style="background-image: url(/_static/london_tube-thumb.png)"></a>

                  </div>
                </div>
                <p>Vega-Altair is a declarative statistical visualization library for Python, based on
                  <a class="reference external" href="http://vega.github.io/vega">Vega</a> and <a
                    class="reference external" href="http://vega.github.io/vega-lite">Vega-Lite</a>, and the source is
                  available on
                  <a class="reference external" href="http://github.com/altair-viz/altair">GitHub</a>.
                </p>
                <p><i>The Vega-Altair open source project is not affiliated with Altair Engineering, Inc.</i></p>
                <p>With Vega-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 <a class="reference external" href="http://vega.github.io/vega-lite">Vega-Lite</a>
                  visualization grammar. This elegant simplicity produces
                  beautiful and effective visualizations with a minimal amount of code.</p>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">Getting Started</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal"
                        href="getting_started/overview.html">Overview</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="getting_started/installation.html">Installation</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="getting_started/installation.html#dependencies">Dependencies</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="getting_started/installation.html#development-install">Development Install</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="getting_started/starting.html">Basic
                        Statistical Visualization</a></li>
                  </ul>
                </div>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">Gallery</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal" href="gallery/index.html">Example Gallery</a>
                    </li>
                  </ul>
                </div>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">User Guide</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/data.html">Specifying Data in
                        Altair</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/encoding.html">Encodings</a>
                    </li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/marks.html">Marks</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/transform/index.html">Data
                        Transformations</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/interactions.html">Bindings,
                        Selections, Conditions: Making Charts Interactive</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/configuration.html">Top-Level
                        Chart Configuration</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/compound_charts.html">Compound
                        Charts: Layer, HConcat, VConcat, Repeat, Facet</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/scale_resolve.html">Scale and
                        Guide Resolution</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/saving_charts.html">Saving
                        Altair Charts</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="user_guide/customization.html">Customizing Visualizations</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/times_and_dates.html">Times
                        and Dates in Altair</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/faq.html">Frequently Asked
                        Questions</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/troubleshooting.html">Display
                        Troubleshooting</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/internals.html">Altair
                        Internals: Understanding the Library</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/API.html">API Reference</a>
                    </li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/ecosystem.html">Altair
                        Ecosystem</a></li>
                  </ul>
                </div>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">Case Studies</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal"
                        href="case_studies/exploring-weather.html">Exploring Seattle Weather</a></li>
                  </ul>
                </div>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">Advanced Usage</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/importing.html">Importing Vega
                        &amp; Vega-Lite Versions</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="user_guide/display_frontends.html">Displaying Altair Charts</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="user_guide/display_frontends.html#renderer-api">Renderer API</a></li>
                    <li class="toctree-l1"><a class="reference internal"
                        href="user_guide/custom_renderers.html">Customizing Renderers</a></li>
                    <li class="toctree-l1"><a class="reference internal" href="user_guide/data_transformers.html">Data
                        transformers</a></li>
                  </ul>
                </div>
                <div class="toctree-wrapper compound">
                  <p class="caption" role="heading"><span class="caption-text">Release Notes</span></p>
                  <ul>
                    <li class="toctree-l1"><a class="reference internal" href="releases/changes.html">Altair Change
                        Log</a></li>
                  </ul>
                </div>
                <section id="bug-reports-questions">
                  <h2>Bug Reports &amp; Questions<a class="headerlink" href="#bug-reports-questions"
                      title="Permalink to this headline"></a></h2>
                  <p>Vega-Altair is BSD-licensed and the source is available on <a class="reference external"
                      href="http://github.com/altair-viz/altair">GitHub</a>. If any
                    questions or issues come up as you use Altair, please get in touch via
                    <a class="reference external" href="http://github.com/altair-viz/altair/issues">Git Issues</a> or
                    our <a class="reference external" href="https://groups.google.com/forum/#!forum/altair-viz">Google
                      Group</a>.
                  </p>
                </section>
                <section id="indices-and-tables">
                  <h2>Indices and tables<a class="headerlink" href="#indices-and-tables"
                      title="Permalink to this headline"></a></h2>
                  <ul class="simple">
                    <li>
                      <p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a>
                      </p>
                    </li>
                    <li>
                      <p><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module
                            Index</span></a></p>
                    </li>
                  </ul>
                </section>
              </section>


            </div>
          </div>
          <footer>
            <div class="rst-footer-buttons" role="navigation" aria-label="Footer">
              <a href="getting_started/overview.html" class="btn btn-neutral float-right" title="Overview" accesskey="n"
                rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
            </div>

            <hr />

            <div role="contentinfo">
              <p>&#169; Copyright 2016-2020, Altair Developers.</p>
            </div>

            Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
            <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
            provided by <a href="https://readthedocs.org">Read the Docs</a>.


          </footer>
        </div>
      </div>
    </section>
  </div>
  <script>
    jQuery(function () {
      SphinxRtdTheme.Navigation.enable(true);
    });
  </script>

</body>

</html>