Seaborn

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.

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](https://joss.theoj.org/papers/10.21105/joss.03021). 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 (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/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"` (https://github.com/mwaskom/seaborn/pull/2461, https://github.com/mwaskom/seaborn/pull/2634).

- \|Feature\| Added `FacetGrid.refline` and `JointGrid.refline` methods for plotting horizontal and/or vertical reference lines on every subplot in one step (https://github.com/mwaskom/seaborn/pull/2620).

- \|Feature\| In `kdeplot`, added a `warn_singular` parameter to silence the warning about data with zero variance (https://github.com/mwaskom/seaborn/pull/2566).

- \|Enhancement\| In `histplot`, improved performance with large datasets and many groupings/facets (https://github.com/mwaskom/seaborn/pull/2559, https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/2571).

- \|Enhancement\| The `load_dataset` helper now produces a more informative error when fed a dataframe, easing a common beginner mistake (https://github.com/mwaskom/seaborn/pull/2604).

- \|Fix\| \|Enhancement\| Improved robustness to missing data, including some additional support for the `pd.NA` type (https://github.com/mwaskom/seaborn/pull/2417, https://github.com/mwaskom/seaborn/pull/2435).

- \|Fix\| In `ecdfplot` and `rugplot`, fixed a bug where results were incorrect if the data axis had a log scale before plotting (https://github.com/mwaskom/seaborn/pull/2504).

- \|Fix\| In `histplot`, fixed a bug where using `shrink` with non-discrete bins shifted bar positions inaccurately (https://github.com/mwaskom/seaborn/pull/2477).

- \|Fix\| In `displot`, fixed a bug where `common_norm=False` was ignored when faceting was used without assigning `hue` (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/2522).

- \|Fix\| In `histplot` and `kdeplot`, fixed a bug where the `alpha` parameter was ignored when `fill=False` (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/2462).

- \|Fix\| In `displot`, the default alpha value now adjusts to a provided `multiple` parameter even when `hue` is not assigned (https://github.com/mwaskom/seaborn/pull/2462).

- \|Fix\| In `displot`, fixed a bug that caused faceted 2D histograms to error out with `common_bins=False` (https://github.com/mwaskom/seaborn/pull/2640).

- \|Fix\| In `rugplot`, fixed a bug that prevented the use of datetime data (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/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 (https://github.com/mwaskom/seaborn/pull/2580).

- \|Fix\| In `lmplot` and `regplot`, fixed a bug where the x axis was clamped to the data limits with `truncate=True` (https://github.com/mwaskom/seaborn/pull/2576).

- \|Fix\| In `lmplot`, fixed a bug where `sharey=False` did not always work as expected (https://github.com/mwaskom/seaborn/pull/2576).

- \|Fix\| In `heatmap`, fixed a bug where vertically-rotated y-axis tick labels would be misaligned with their rows (https://github.com/mwaskom/seaborn/pull/2574).

- \|Fix\| Fixed an issue that prevented Python from running in `-OO` mode while using seaborn (https://github.com/mwaskom/seaborn/pull/2473).

- \|Docs\| Improved the API documentation for theme-related functions (https://github.com/mwaskom/seaborn/pull/2573).

- \|Docs\| Added docstring pages for all methods on documented classes (https://github.com/mwaskom/seaborn/pull/2644).

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.

joss_paper
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.

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](http://seaborn.pydata.org/whatsnew.html#v0-11-1-december-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](https://seaborn.pydata.org/whatsnew.html).

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`](https://github.com/mwaskom/seaborn/pull/2157), [`histplot`](https://github.com/mwaskom/seaborn/pull/2125), and [`ecdfplot`](https://github.com/mwaskom/seaborn/pull/2141), a complete rewrite of [`kdeplot`](https://github.com/mwaskom/seaborn/pull/2104), and substantial enhancements to [`jointplot`](https://github.com/mwaskom/seaborn/pull/2210) and [`pairplot`](https://github.com/mwaskom/seaborn/pull/2234)
- Centralized [input data processing](https://github.com/mwaskom/seaborn/pull/2071) allowing for both standardization and increased flexibility of long- and wide-form variable specification
- Substantial [internal refactoring](https://github.com/mwaskom/seaborn/pull/2090) to support the new distributions functions and planned improvements in other modules
- Warning-based enforcement of [keyword-only parameters](https://github.com/mwaskom/seaborn/pull/2081) in most functions
- New [perceptually uniform colormaps](https://github.com/mwaskom/seaborn/pull/2237) 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](https://github.com/mwaskom/seaborn/blob/v0.11.0.rc0/doc/releases/v0.11.0.txt)

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