Altair Change Log¶
Version 4.0.0 (unreleased)¶
Version 4.0.0 is based on Vega-Lite version 4.0, which you can read about at https://github.com/vega/vega-lite/releases/tag/v4.0.0.
It is the first version of Altair to drop Python 2 compatibility, and is tested on Python 3.5 and newer.
Support for interactive legends: (see Interactive Legend)
Responsive chart width and height: (see Adjusting Chart Size)
Lookup transform responsive to selections: (see Lookup Transform)
Bins responsive to selections: (see Histogram with Responsive Bins)
New Regression transform: (see Regression Transform)
New LOESS transform: (see LOESS Transform)
New density transform: (see Density Transform)
New pivot transform: (see Pivot Transform)
Image mark (see Image Mark)
htmlrenderer, directly compatible with Jupyter Notebook and JupyterLab without the need for frontend extensions, as well as tools like nbviewer and nbconvert, and related notebook environments such as Zeppelin, Colab, Kaggle Kernels, and DataBricks. To enable the old default renderer, use:
Support per-corner radius for bar marks: (see Bar Chart with rounded edges)
Sort-by-field can now use the field name directly. So instead of:
alt.Y('y:Q', sort=alt.EncodingSortField('x', order='descending'))
you can now use:
Chart.configure_scale()is deprecated. instead, use
columnsare no longer valid chart properties, but are moved to the encoding classes to which they refer.
Version 3.3.0 (released Nov 27, 2019)¶
Last release to support Python 2
- Add inheritance structure to low-level schema classes (#1803)
htmlrenderer which works across frontends (#1793)
- Support Python 3.8 (#1740, #1781)
:Gshorthand for geojson type (#1714)
- Add data generator interface:
- Support geographic data sources via
copy.deepcopyfor chart objects (#1805)
- Fix bug when specifying
- Fix arguments to
- Fix composition of multiple selections (#1707)
Version 3.2.0 (released August 5, 2019)¶
Upgraded to Vega-Lite version 3.4 (See Vega-Lite 3.4 Release Notes).
Following are changes to Altair in addition to those that came with VL 3.4:
- Selector values can be used directly in expressions (#1599)
- Top-level chart repr is now truncated to improve readability of error messages (#1572)
add_selectionmethods now delegate to sub-charts. Previously they produced invalid charts (#1607)
mark_*()methods removed from LayerChart (#1607)
- New encoding channels are properly parsed (#1597)
- Data context is propagated when encodings are specified as lists (#1587)
alt.LayerChartno longer has
mark_*()methods, because they never produced valid chart specifications) (#1607)
Version 3.1.0 (Released June 6, 2019)¶
Update includes full compatibility with version 3.3 of Vega-Lite.
- Added support for vega
- Added an
alt.renderers.disable_max_rows()method for disabling the maximum rows check (#1538)
- Improved user-facing warnings/errors around layering and faceting (#1535).
dataargument is now properly handled by
- Compound charts (layer, concat, hconcat, vconcat) now move data to
the top level by default. In particular, this means that the
facet()method can now be called directly on a layered chart without having to change how data is specified. (#1521)
mark_*()methods. If a layer specifies a mark at the top level, all child charts will inherit it (unless they override it explicitly).
alt.Chart.facet()now handles wrapped facets; for example:
python chart.facet('column_name', columns=5)See
altair/examples/us_population_over_time_facet.pyfor a more complete example.
chart.save()respect the data transformer setting (#1538)
- Fixed a deserialization bug for certain chart specs in schemapi (#1543)
alt.Chart.facet()now accepts a wrapped facet encoding as a first positional argument, rather than a row encoding. The following are examples of old invocations, and the equivalent new invocations:
chart.facet(row='col1', column='col2'): unchanged
chart.facet('col1', 'col2'): change to
chart.facet('col1'): change to
In each case, the new invocations are compatible back to Altair 2.X.
- Several of the encoding channels added in 3.0 have had their capitalization corrected to better match the names used in the schema:
Version 3.0.1 (Released May 1, 2019)¶
Fix version info bug for HTML output and Colab & Kaggle renderers.
Version 3.0.0 (Released April 26, 2019)¶
Update to Vega-Lite 3.2 and Vega 5.3 & support all new features. See https://github.com/vega/vega-lite/releases/tag/v3.0.0 for Vega-Lite feature lists.
- new compound marks:
- new transforms:
facetencoding that is similar to the
columnencoding, but allows for wrapped facets
alt.concat()function that is similar to
alt.vconcat, but allows for more general wrapped concatenation
columnskeyword that allows wrapped faceting, repeating, and concatenation.
- many, many bug fixes
- tooltips can now be automatically populated using the
- ability to specify initial conditions for selections
Version 2.4.1 (Released February 21, 2019)¶
- Several documentation cleanups & new examples
- Fix incompatibility with pandas version 0.24 (#1315)
Version 2.3.0 (Released December 7, 2018)¶
Includes many reworked examples in the example gallery.
- Better errors for non-string column names, as well as automatic
pandas.RangeIndexcolumns to strings (#1107)
- Renderers now have set_embed_options() method (#1203)
- Added kaggle renderer & more HTML output options (#1123)
- fix typing requirement in Python 3.6+ (#1185)
- Added support & CI testing for Python 3.7 (#1008)
- Selection predicates now recognize all valid entries (#1143)
- Python 2 support for
Version 2.2.2 (Released August 17, 2018)¶
- fix missing JSON resource in
Version 2.2.1 (Released August 15, 2018)¶
- appropriate handling of InlineData in dataset consolidation (#1092)
- fix admonition formatting in documentation page (#1094)
Version 2.2.0 (Released August 14, 2018):¶
- better handling of datetimes and timezones (#1053)
- all inline datasets are now converted to named datasets and stored at
the top level of the chart. This behavior can be disabled by setting
alt.data_transformers.consolidate_datasets = False(#951 & #1046)
- more streamlined shorthand syntax for window transforms (#957)
- Fixed serialization of logical operands on selections within
- Fixed sphinx issue which embedded chart specs twice (#1088)
- Avoid Selenium import until it is actually needed (#982)
Version 2.1.0 (Released June 6, 2018):¶
- add a
chart.save()to allow the size/resolution of saved figures to be adjusted. (#918)
- add an
add_selection()method to add selections to charts (#832)
chart.display()methods for more flexibility in displaying charts (#831)
- allow multiple fields to be passed to encodings such as
timeUnitspecifications more succinct, by parsing them in a manner similar to aggregates (#866)
to_csv()have deterministic filenames, so in json mode a single datasets will lead to a single on-disk serialization (#862)
datathe first argument for all compound chart types to match the semantics of
- update vega-lite to version 2.4.3 (#836)
- Only API change is internal:
- update vega to v3.3 & vega-embed to v3.11 in html output & colab renderer (#838)
Version 2.0.0: May 2, 2018¶
- Complete rewrite of Altair, focused on supporting Vega-Lite 2.X
Version 1.2.1: October 29, 2017¶
This version of Altair is based on Vega-Lite 1.2.1.
- Support for JupyterLab/nteract through MIME based rendering. Enable
this by calling
enable_mime_rendering()before rendering visualizations (#216).
- Change default import in all code and docs to
import altair as alt
- Check for missing and misspelled column names upon exporting or
rendering, and raise
FieldError(#399) if any problems are found. This can be disabled by setting
MaxRowsExceededif the number of rows in the dataset is larger than
Chart.max_rowsto guard against sending large datasets to the browser.
- Move the Vega-Lite 1.x api into
altair.v1to make it easier for us to migrate to Vega-Lite 2.x and continue to support 1.x. No import change are needed as
altair.v1is aliased to
altairin this release
- Moved the example notebooks into a separate repository (https://github.com/altair-viz/altair_notebooks) that has Binder support (#391).
$schemato top-level JSON spec (#370).
- Minor documentation revisions.
Version 1.2: Nov 7, 2016¶
- Update to Vega-Lite 1.2 and make all its enhancements available to Altair
altair.exprmachinery to specify transformations and filterings (#215)
Chart.savechartmethod, which can output JSON, HTML, and (if Node is installed) PNG and SVG. See https://altair-viz.github.io/documentation/displaying.html (#213)
- Countless minor bug fixes
Version 1.0: July 11, 2016¶
- Initial release of Altair