doc build for commit 217d23f14b1150b064caa67abd851433110b5358

altair-viz · Aug 27, 2024 · c69d1a2 · c69d1a2
1 parent 62be3ba
commit c69d1a2
Show file tree

Hide file tree

Showing 958 changed files with 4,126 additions and 4,011 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 56bd5ddc37135c9ead960d45913e4da3
+config: eec1408549b932a335065c2a658e28b4
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/_sources/gallery/cumulative_count_chart.rst.txt b/_sources/gallery/cumulative_count_chart.rst.txt
@@ -30,10 +30,8 @@ Adapted from https://vega.github.io/vega-lite/examples/area_cumulative_freq.html
         sort=[{"field": "IMDB_Rating"}],
     ).mark_area().encode(
         x="IMDB_Rating:Q",
-        y="cumulative_count:Q"
+        y=alt.Y("cumulative_count:Q", stack=False)
     )
-    # No channel encoding options are specified in this chart
-    # so the code is the same as for the method-based syntax.
 
 
 .. tab-set::
@@ -55,7 +53,7 @@ Adapted from https://vega.github.io/vega-lite/examples/area_cumulative_freq.html
                 sort=[{"field": "IMDB_Rating"}],
             ).mark_area().encode(
                 x="IMDB_Rating:Q",
-                y="cumulative_count:Q"
+                y=alt.Y("cumulative_count:Q").stack(False)
             )
 
 
@@ -76,7 +74,5 @@ Adapted from https://vega.github.io/vega-lite/examples/area_cumulative_freq.html
                 sort=[{"field": "IMDB_Rating"}],
             ).mark_area().encode(
                 x="IMDB_Rating:Q",
-                y="cumulative_count:Q"
+                y=alt.Y("cumulative_count:Q", stack=False)
             )
-            # No channel encoding options are specified in this chart
-            # so the code is the same as for the method-based syntax.
diff --git a/_sources/user_guide/customization.rst.txt b/_sources/user_guide/customization.rst.txt
@@ -180,15 +180,17 @@ The subtitle can run to two lines by passing a list where each list item is a li
        color="source:N"
    )
 
-The ``Title`` object can also configure a number of other attributes, e.g., the position of the title and subtitle (see see :ref:`user-guide-customization` for details).
+The ``Title`` object can also configure a number of other attributes,
+e.g., to ``anchor`` it to the ``'start'`` (left) of the chart,
+and to ``orient`` it at the ``'bottom'`` of the chart (see :ref:`user-guide-configuration` for more options).
 
 .. altair-plot::
 
    alt.Chart(
       iowa,
       title=alt.Title(
           "Iowa's green energy boom",
-          subtitle=["A growing share of the state's energy", "has come from renewable sources"],
+          subtitle="A growing share of the state's energy has come from renewable sources",
           anchor='start',
           orient='bottom',
           offset=20
@@ -199,6 +201,31 @@ The ``Title`` object can also configure a number of other attributes, e.g., the
        color="source:N"
    )
 
+In the chart above,
+you can see that the title is positioned all the way to the left,
+so that it lines up with the label on the y-axis.
+You can align the title to the axis line instead
+by setting the reference ``frame`` for the anchor position
+to be relative to the ``'group'`` (i.e. the data portion of the chart, excluding labels and titles).
+
+
+.. altair-plot::
+
+   alt.Chart(
+      iowa,
+      title=alt.Title(
+          "Iowa's green energy boom",
+          subtitle=["A growing share of the state's energy has come from", "renewable sources"],
+          anchor='start',
+          frame='group',
+          orient='bottom',
+          offset=20
+      )
+   ).mark_area().encode(
+       x="year:T",
+       y=alt.Y("net_generation:Q").stack("normalize"),
+       color="source:N"
+   )
 
 Adjusting Axis Limits
 ---------------------

diff --git a/_static/_image_hashes.json b/_static/_image_hashes.json
diff --git a/_static/area_chart_gradient-thumb.png b/_static/area_chart_gradient-thumb.png
diff --git a/_static/area_chart_gradient.png b/_static/area_chart_gradient.png
diff --git a/_static/area_faceted-thumb.png b/_static/area_faceted-thumb.png
diff --git a/_static/area_faceted.png b/_static/area_faceted.png
diff --git a/_static/bar_chart_with_negatives-thumb.png b/_static/bar_chart_with_negatives-thumb.png
diff --git a/_static/bar_chart_with_negatives.png b/_static/bar_chart_with_negatives.png
diff --git a/_static/co2_concentration-thumb.png b/_static/co2_concentration-thumb.png
diff --git a/_static/co2_concentration.png b/_static/co2_concentration.png
diff --git a/_static/cumulative_count_chart-thumb.png b/_static/cumulative_count_chart-thumb.png
diff --git a/_static/cumulative_count_chart.png b/_static/cumulative_count_chart.png
diff --git a/_static/documentation_options.js b/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '5.4.0',
+    VERSION: '5.5.0dev',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

diff --git a/_static/errorbars_with_ci-thumb.png b/_static/errorbars_with_ci-thumb.png
diff --git a/_static/errorbars_with_ci.png b/_static/errorbars_with_ci.png
diff --git a/_static/falkensee-thumb.png b/_static/falkensee-thumb.png
diff --git a/_static/falkensee.png b/_static/falkensee.png
diff --git a/_static/grouped_bar_chart_with_error_bars-thumb.png b/_static/grouped_bar_chart_with_error_bars-thumb.png
diff --git a/_static/grouped_bar_chart_with_error_bars.png b/_static/grouped_bar_chart_with_error_bars.png
diff --git a/_static/interactive_column_selection-thumb.png b/_static/interactive_column_selection-thumb.png
diff --git a/_static/interactive_column_selection.png b/_static/interactive_column_selection.png
diff --git a/_static/interactive_legend-thumb.png b/_static/interactive_legend-thumb.png
diff --git a/_static/interactive_legend.png b/_static/interactive_legend.png
diff --git a/_static/interval_selection-thumb.png b/_static/interval_selection-thumb.png
diff --git a/_static/interval_selection.png b/_static/interval_selection.png
diff --git a/_static/isotype_emoji-thumb.svg b/_static/isotype_emoji-thumb.svg
diff --git a/_static/isotype_emoji.svg b/_static/isotype_emoji.svg
diff --git a/_static/layer_line_color_rule-thumb.png b/_static/layer_line_color_rule-thumb.png
diff --git a/_static/layer_line_color_rule.png b/_static/layer_line_color_rule.png
diff --git a/_static/layered_chart_with_dual_axis-thumb.png b/_static/layered_chart_with_dual_axis-thumb.png
diff --git a/_static/layered_chart_with_dual_axis.png b/_static/layered_chart_with_dual_axis.png
diff --git a/_static/line_chart_with_arrows-thumb.png b/_static/line_chart_with_arrows-thumb.png
diff --git a/_static/line_chart_with_arrows.png b/_static/line_chart_with_arrows.png
diff --git a/_static/line_chart_with_custom_legend-thumb.png b/_static/line_chart_with_custom_legend-thumb.png
diff --git a/_static/line_chart_with_custom_legend.png b/_static/line_chart_with_custom_legend.png
diff --git a/_static/line_chart_with_datum-thumb.png b/_static/line_chart_with_datum-thumb.png
diff --git a/_static/line_chart_with_datum.png b/_static/line_chart_with_datum.png
diff --git a/_static/line_chart_with_interpolation-thumb.png b/_static/line_chart_with_interpolation-thumb.png
diff --git a/_static/line_chart_with_interpolation.png b/_static/line_chart_with_interpolation.png
diff --git a/_static/line_chart_with_points-thumb.png b/_static/line_chart_with_points-thumb.png
diff --git a/_static/line_chart_with_points.png b/_static/line_chart_with_points.png
diff --git a/_static/line_chart_with_points_stroked-thumb.png b/_static/line_chart_with_points_stroked-thumb.png
diff --git a/_static/line_chart_with_points_stroked.png b/_static/line_chart_with_points_stroked.png
diff --git a/_static/line_with_ci-thumb.png b/_static/line_with_ci-thumb.png
diff --git a/_static/line_with_ci.png b/_static/line_with_ci.png
diff --git a/_static/line_with_last_value_labeled-thumb.png b/_static/line_with_last_value_labeled-thumb.png
diff --git a/_static/line_with_last_value_labeled.png b/_static/line_with_last_value_labeled.png
diff --git a/_static/multi_series_line-thumb.png b/_static/multi_series_line-thumb.png
diff --git a/_static/multi_series_line.png b/_static/multi_series_line.png
diff --git a/_static/multiline_highlight-thumb.png b/_static/multiline_highlight-thumb.png
diff --git a/_static/multiline_highlight.png b/_static/multiline_highlight.png
diff --git a/_static/natural_disasters-thumb.png b/_static/natural_disasters-thumb.png
diff --git a/_static/natural_disasters.png b/_static/natural_disasters.png
diff --git a/_static/scatter_with_layered_histogram-thumb.png b/_static/scatter_with_layered_histogram-thumb.png
diff --git a/_static/scatter_with_layered_histogram.png b/_static/scatter_with_layered_histogram.png
diff --git a/_static/scatter_with_minimap-thumb.png b/_static/scatter_with_minimap-thumb.png
diff --git a/_static/scatter_with_minimap.png b/_static/scatter_with_minimap.png
diff --git a/_static/scatter_with_rolling_mean-thumb.png b/_static/scatter_with_rolling_mean-thumb.png
diff --git a/_static/scatter_with_rolling_mean.png b/_static/scatter_with_rolling_mean.png
diff --git a/_static/seattle_weather_interactive-thumb.png b/_static/seattle_weather_interactive-thumb.png
diff --git a/_static/seattle_weather_interactive.png b/_static/seattle_weather_interactive.png
diff --git a/_static/select_mark_area-thumb.png b/_static/select_mark_area-thumb.png
diff --git a/_static/select_mark_area.png b/_static/select_mark_area.png
diff --git a/_static/sorted_error_bars_with_ci-thumb.png b/_static/sorted_error_bars_with_ci-thumb.png
diff --git a/_static/sorted_error_bars_with_ci.png b/_static/sorted_error_bars_with_ci.png
diff --git a/_static/streamgraph-thumb.png b/_static/streamgraph-thumb.png
diff --git a/_static/streamgraph.png b/_static/streamgraph.png
diff --git a/_static/strip_plot_jitter-thumb.png b/_static/strip_plot_jitter-thumb.png
diff --git a/_static/strip_plot_jitter.png b/_static/strip_plot_jitter.png
diff --git a/_static/us_employment-thumb.png b/_static/us_employment-thumb.png
diff --git a/_static/us_employment.png b/_static/us_employment.png
diff --git a/about/citing.html b/about/citing.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Citing &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Citing &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/about/code_of_conduct.html b/about/code_of_conduct.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Code of Conduct &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Code of Conduct &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/about/governance.html b/about/governance.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Governance &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Governance &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/about/roadmap.html b/about/roadmap.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Roadmap &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Roadmap &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/about/versioning.html b/about/versioning.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Versioning &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Versioning &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -136,8 +136,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/case_studies/exploring-weather.html b/case_studies/exploring-weather.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Exploring Seattle Weather &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Exploring Seattle Weather &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>

diff --git a/case_studies/index.html b/case_studies/index.html
@@ -8,7 +8,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Tutorials &#8212; Vega-Altair 5.4.0 documentation</title>
+    <title>Tutorials &#8212; Vega-Altair 5.5.0dev documentation</title>
 
 
 
@@ -41,7 +41,7 @@
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=dfe6caa3a7d634c4db9b" />
   <script src="../_static/vendor/fontawesome/6.5.2/js/all.min.js?digest=dfe6caa3a7d634c4db9b"></script>
 
-    <script src="../_static/documentation_options.js?v=d250e987"></script>
+    <script src="../_static/documentation_options.js?v=d2f74b0e"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/clipboard.min.js?v=a7894cd8"></script>
@@ -137,8 +137,8 @@
 
 
 
-    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.4.0 documentation - Home"/>
-    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.4.0 documentation - Home"/>`);</script>
+    <img src="../_static/altair-logo-light.png" class="logo__image only-light" alt="Vega-Altair 5.5.0dev documentation - Home"/>
+    <script>document.write(`<img src="../_static/altair-logo-light.png" class="logo__image only-dark" alt="Vega-Altair 5.5.0dev documentation - Home"/>`);</script>
 
 
 </a></div>