Changelog History
Page 1
-
v4.1.0 Changes
April 01, 2020- Minimum Python version is now 3.6
- ๐ Update Vega-Lite to version 4.8.1; many new features and bug fixes from Vega-Lite versions 4.1 through 4.8; see Vega-Lite Release Notes.
โจ Enhancements
strokeDash
encoding can now be used to control line styles (Example: Multi Series Line Chart- ๐พ
chart.save()
now relies on altair_saver for more flexibility (#1943). - New
chart.show()
method replaceschart.serve()
, and relies on altair_viewer to allow offline viewing of charts (#1988).
๐ Bug Fixes
- ๐ Support Python 3.8 (#1958)
- ๐ Support multiple views in JupyterLab (#1986)
- ๐ Support numpy types within specifications (#1914)
- ๐ Support pandas nullable ints and string types (#1924)
๐ง ##Maintenance
-
v4.0.1
January 14, 2020 -
v4.0.0 Changes
December 11, 2019๐ Altair Version 4.0.0 release
๐ 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.โจ Enhancements
๐ Support for interactive legends: (Example)
๐ฑ Responsive chart width and height: (Example)
๐ฑ Bins responsive to selections: (Example)
๐ฑ๐ New pivot transform: (Example)
๐ New Regression transform: (Example)
๐ New LOESS transform: (Example)
๐ New density transform: (Example)
Image mark (Example)
๐ New default
html
renderer, 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,
0๏ธโฃ Colab, Kaggle Kernels, and DataBricks. To enable the old default renderer, use:alt.renderers.enable('mimetype')
๐ Support per-corner radius for bar marks: (Example)
Grammar Changes
Sort-by-field can now use the encoding name directly. So instead of
alt.Y('y:Q', sort=alt.EncodingSortField('x_field', order='descending'))
you can now use::
alt.Y('y:Q', sort="-x")
๐ง The
rangeStep
argument to :class:Scale
and :meth:Chart.configure_scale
is deprecated.
instead, usechart.properties(width={"step": rangeStep})
or
๐งchart.configure_view(step=rangeStep)
.align
,center
,spacing
, andcolumns
are no longer valid chart properties, but
๐ are moved to the encoding classes to which they refer. -
v3.3.0 Changes
November 27, 2019๐ Version 3.3.0
๐ released Nov 27, 2019
๐ Last release to support Python 2
โจ Enhancements
- โ Add inheritance structure to low-level schema classes (#1803)
- โ Add
html
renderer which works across frontends (#1793) - ๐ Support Python 3.8 (#1740, #1781)
- โ Add
:G
shorthand for geojson type (#1714) - โ Add data generator interface:
alt.sequence
,alt.graticule
,
alt.sphere()
(#1667, #1687) - Support geographic data sources via
__geo_interface__
(#1664)
๐ Bug Fixes
-
v3.2.0 Changes
August 05, 2019๐ 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:
โจ Enhancements
- Selector values can be used directly in expressions (#1599)
- Top-level chart repr is now truncated to improve readability of error
messages (#1572)
๐ Bug Fixes
- top-level
add_selection
methods now delegate to sub-charts. Previously
they produced invalid charts (#1607) - ๐ Unsupported
mark_*()
methods removed from LayerChart (#1607) - ๐ New encoding channels are properly parsed (#1597)
- Data context is propagated when encodings are specified as lists (#1587)
Backward-Incompatible Changes
alt.LayerChart
no longer hasmark_*()
methods, because they never
produced valid chart specifications) (#1607)
-
v3.1.0 Changes
June 06, 2019โก๏ธ Update includes full compatibility with version 3.3 of Vega-Lite.
โจ Enhancements
โ Added support for vega themes via
alt.themes.enable(theme_name)
(#1539)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).
data
argument is now properly handled byChart.properties
(#1525)๐ 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)๐
alt.LayerChart
now supportsmark_*()
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:chart.facet('column_name', columns=5)
See
altair/examples/us_population_over_time_facet.py
for a more complete example.
๐ Bug fixes
๐ Make
chart.serve()
andchart.save()
respect the data transformer setting (#1538)๐ Fixed a deserialization bug for certain chart specs in schemapi (#1543)
Backward-Incompatible Changes
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')
: unchangedchart.facet('col1', 'col2')
: change tochart.facet(row='col1', column='col2')
chart.facet('col1')
: change tochart.facet(row='col1')
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:
alt.Fillopacity
->alt.FillOpacity
alt.Strokeopacity
->alt.StrokeOpacity
alt.Strokewidth
->alt.StrokeWidth
alt.Xerror
->alt.XError
alt.Xerror2
->alt.XError2
alt.Yerror
->alt.YError
alt.Yerror2
->alt.YError2
-
v3.0.1 Changes
May 01, 2019๐ Fix version info bug for HTML output and Colab & Kaggle renderers.
-
v3.0.0 Changes
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.
Highlights:
- new compound marks:
mark_boxplot()
,mark_errorband()
,mark_errorbar()
- new transforms:
transform_impute()
,transform_joinaggregate()
,transform_flatten()
transform_fold()
,transform_sample()
,transform_stack()
- ๐ new
facet
encoding that is similar to therow
andcolumn
encoding, but allows for wrapped facets - ๐ new
alt.concat()
function that is similar toalt.hconcat
andalt.vconcat
, but allows for more general wrapped concatenation - ๐ new
columns
keyword that allows wrapped faceting, repeating, and concatenation. - ๐ many, many bug fixes
- ๐ง tooltips can now be automatically populated using the
tooltip
mark configuration. - ability to specify initial condisions for selections
- new compound marks:
-
v3.0.0.rc1
March 27, 2019 -
v2.4.1 Changes
February 21, 2019โจ Enhancements
- ๐ Several documentation cleanups & new examples
๐ Bug Fixes
- ๐ Fix incompatibility with pandas version 0.24 (#1315)