v0.12.0b1

This is the first beta release for seaborn v0.12, a major update introducing an entirely new interface along with numerous features, enhancements, and fixes for existing functionality.

To install for testing, run

pip install seaborn==0.12.0b1

Changes from the final alpha release:

Objects interface

• Improve tick label defaults and customization (#2877)
  • Add Scale.label interface for formatting tick labels
  • Fix a bug where unshared axes would use the same locator
  • Default to scientific notation for log scale ticks
  • Default to log-spaced ticks with symlog scale
  • Shorten transform parameter name to trans
  • Simplify internal type structure
• Allow suppression of legend for individual layers (#2834)

Function interface

• Add new errorbar API to pointplot and barplot (#2866)
• Add width parameter to barplot (#2860)
• Add orient parameter to lineplot (#2854)
• Allow histplot to draw discrete histograms with step or poly marks (#2859)
• Downgrade exception in relational plots with palette of incorrect length to a warning (#2856)
• Use alpha from point mark for error bars in regplot (#2853)
• Improve user-friendliness of jointplot (#2863)
• Preserve upper left y axis label in pointplot with corner=True and diag_kind=None (#2850)
• Improve support for anonymous data objects in relplot (#2846)
• Fix histplot dodged bar widths with log scale (#2849)
• Fix hue_order as a subset in scatterplot (#2848)
• Fix several bugs in the new categorical scatterplot features (#2845)

v0.12.0a1

This is the second alpha release for seaborn v0.12, a major release introducing an entirely new interface along with numerous enhancements and fixes to existing functionality.

To install for testing, run

pip install https://github.com/mwaskom/seaborn/archive/refs/tags/v0.12.0a1.tar.gz

Changes from the first alpha release:

Objects interface

• Add Norm move, for divisive scaling after stat computation (#2827)
• Complete Line mark and add corresponding Path, Lines, and Paths marks (#2822)
• Fix inferred y orientation with computed x variable (#2818)
• Fix multiple moves while pairing (#2817)
• Improve missing data handling (#2816)

Categorical plots

• Revert change to 1D "wide" data handling introduced in v0.12.0a0 (#2829)
• Improve legend fore new features in categorical scatterplots (#2828)
• Fix inner boxes with unpaired split violins (#2814)

Distribution plots

• Fix some edgecases in histplotwhen specifying binwidth (#2813)
• Fix histplot/kdeplot normalization when using hue and weights (#2812)

v0.12.0a0

This is the first alpha for seaborn v0.12.0, a major release that introduces an entirely new interface in the seaborn.objects namespace.

For more information about the new interface, see the development docs at http://seaborn.pydata.org/nextgen.

Please experiment with the alpha version and provide feedback on things that are confusing or don't work, but expect some rough edges and instability.

v0.11.2 (August 2021)

This is a minor release that addresses issues in the v0.11 series and adds a small number of targeted enhancements. It is a recommended upgrade for all users.

• |Docs| A paper describing seaborn has been published in the Journal of Open Source Software. The paper serves as an introduction to the library and can be used to cite seaborn if it has been integral to a scientific publication.

• |API| |Feature| In lmplot, added a new facet_kws parameter and deprecated the sharex, sharey, and legend_out parameters from the function signature; pass them in a facet_kws dictionary instead (#2576).

• |Feature| Added a move_legend convenience function for repositioning the legend on an existing axes or figure, along with updating its properties. This function should be preferred over calling ax.legend with no legend data, which does not reliably work across seaborn plot types (#2643).

• |Feature| In histplot, added stat="percent" as an option for normalization such that bar heights sum to 100 and stat="proportion" as an alias for the existing stat="probability" (#2461, #2634).

• |Feature| Added FacetGrid.refline and JointGrid.refline methods for plotting horizontal and/or vertical reference lines on every subplot in one step (#2620).

• |Feature| In kdeplot, added a warn_singular parameter to silence the warning about data with zero variance (#2566).

• |Enhancement| In histplot, improved performance with large datasets and many groupings/facets (#2559, #2570).

• |Enhancement| The FacetGrid, PairGrid, and JointGrid objects now reference the underlying matplotlib figure with a .figure attribute. The existing .fig attribute still exists but is discouraged and may eventually be deprecated. The effect is that you can now call obj.figure on the return value from any seaborn function to access the matplotlib object (#2639).

• |Enhancement| In FacetGrid and functions that use it, visibility of the interior axis labels is now disabled, and exterior axis labels are no longer erased when adding additional layers. This produces the same results for plots made by seaborn functions, but it may produce different (better, in most cases) results for customized facet plots (#2583).

• |Enhancement| In FacetGrid, PairGrid, and functions that use them, the matplotlib figure.autolayout parameter is disabled to avoid having the legend overlap the plot (#2571).

• |Enhancement| The load_dataset helper now produces a more informative error when fed a dataframe, easing a common beginner mistake (#2604).

• |Fix| |Enhancement| Improved robustness to missing data, including some additional support for the pd.NA type (#2417, #2435).

• |Fix| In ecdfplot and rugplot, fixed a bug where results were incorrect if the data axis had a log scale before plotting (#2504).

• |Fix| In histplot, fixed a bug where using shrink with non-discrete bins shifted bar positions inaccurately (#2477).

• |Fix| In displot, fixed a bug where common_norm=False was ignored when faceting was used without assigning hue (#2468).

• |Fix| In histplot, fixed two bugs where automatically computed edge widths were too thick for log-scaled histograms and for categorical histograms on the y axis (#2522).

• |Fix| In histplot and kdeplot, fixed a bug where the alpha parameter was ignored when fill=False (#2460).

• |Fix| In histplot and kdeplot, fixed a bug where the multiple parameter was ignored when hue was provided as a vector without a name (#2462).

• |Fix| In displot, the default alpha value now adjusts to a provided multiple parameter even when hue is not assigned (#2462).

• |Fix| In displot, fixed a bug that caused faceted 2D histograms to error out with common_bins=False (#2640).

• |Fix| In rugplot, fixed a bug that prevented the use of datetime data (#2458).

• |Fix| In relplot and displot, fixed a bug where the dataframe attached to the returned FacetGrid object dropped columns that were not used in the plot (#2623).

• |Fix| In relplot, fixed an error that would be raised when one of the column names in the dataframe shared a name with one of the plot variables (#2581).

• |Fix| In the relational plots, fixed a bug where legend entries for the size semantic were incorrect when size_norm extrapolated beyond the range of the data (#2580).

• |Fix| In lmplot and regplot, fixed a bug where the x axis was clamped to the data limits with truncate=True (#2576).

• |Fix| In lmplot, fixed a bug where sharey=False did not always work as expected (#2576).

• |Fix| In heatmap, fixed a bug where vertically-rotated y-axis tick labels would be misaligned with their rows (#2574).

• |Fix| Fixed an issue that prevented Python from running in -OO mode while using seaborn (#2473).

• |Docs| Improved the API documentation for theme-related functions (#2573).

• |Docs| Added docstring pages for all methods on documented classes (#2644).

v0.11.2.rc0

This is the first release candidate for seaborn v0.11.2, a backwards-compatible release with bug fixes and targeted enhancements.

Please test and report any bugs or changed behavior though GitHub issues.

seaborn: statistical data visualization

This is a duplicate tag for seaborn v0.11.1.

It is being created so that Zenodo will mint a DOI for the repository corresponding to seaborn's JOSS paper.

v0.11.1 (December 2020)

This a bug fix release and is a recommended upgrade for all users on v0.11.0.

Complete release notes are available on the seaborn website.

v0.11.0 (Sepetmber 2020)

This is a major release with important new features, enhancements to existing functions, and changes to the library. Highlights include an overhaul and modernization of the distributions plotting functions, more flexible data specification, new colormaps, and better narrative documentation.

Complete release notes are available on the seaborn website.

v0.11.0.rc0

This is the first release candidate for v0.11.0, a major release with several important new features and changes to the library.

Highlights of the new version include:

• A modernization of the distributions module, with the introduction of displot, histplot, and ecdfplot, a complete rewrite of kdeplot, and substantial enhancements to jointplot and pairplot
• Centralized input data processing allowing for both standardization and increased flexibility of long- and wide-form variable specification
• Substantial internal refactoring to support the new distributions functions and planned improvements in other modules
• Warning-based enforcement of keyword-only parameters in most functions
• New perceptually uniform colormaps and better tools for creating custom numeric color palettes
• Improvements to the narrative documentation, including user guide chapters on function types and data structures, along with better cross-linking within the seaborn docs and between the seaborn and matplotlib docs
• Numerous other targeted enhancements and bug fixes

Please test the release by installing from here or with python -m pip install --upgrade --pre seaborn

v0.10.1 (April 2020)

This is minor release with bug fixes for issues identified since 0.10.0.

• Fixed a bug that appeared within the bootstrapping algorithm on
  32-bit systems.
• Fixed a bug where regplot would crash on singleton inputs. Now a
  crash is avoided and regression estimation/plotting is skipped.
• Fixed a bug where heatmap would ignore user-specified
  under/over/bad values when recentering a colormap.
• Fixed a bug where heatmap would use values from masked cells when
  computing default colormap limits.
• Fixed a bug where despine would cause an error when trying to trim
  spines on a matplotlib categorical axis.
• Adapted to a change in matplotlib that caused problems with single
  swarm plots.
• Added the showfliers parameter to boxenplot to suppress plotting
  of outlier data points, matching the API of boxplot.
• Avoided seeing an error from statmodels when data with an IQR of 0
  is passed to kdeplot.
• Added the legend.title_fontsize to the plotting_context
  definition.
• Deprecated several utility functions that are no longer used
  internally (percentiles, sig_stars, pmf_hist, and sort_df).