From d7ef40e13e5b4ea665d27501d10971b896a0f6ee Mon Sep 17 00:00:00 2001 From: Michael Waskom Date: Fri, 29 Sep 2023 06:54:55 -0400 Subject: [PATCH] Further updates --- doc/_tutorial/categorical.ipynb | 9 +++------ doc/whatsnew/v0.13.0.rst | 8 ++++---- 2 files changed, 7 insertions(+), 10 deletions(-) diff --git a/doc/_tutorial/categorical.ipynb b/doc/_tutorial/categorical.ipynb index 2ac6bd4173..33c589c243 100644 --- a/doc/_tutorial/categorical.ipynb +++ b/doc/_tutorial/categorical.ipynb @@ -221,7 +221,7 @@ "cell_type": "raw", "metadata": {}, "source": [ - "When adding a ``hue`` semantic, the box for each level of the semantic variable is moved along the categorical axis so they don't overlap:" + "When adding a ``hue`` semantic, the box for each level of the semantic variable is made narrower and shifted along the categorical axis:" ] }, { @@ -237,7 +237,7 @@ "cell_type": "raw", "metadata": {}, "source": [ - "This behavior is called \"dodging\" and is turned on by default because it is assumed that the semantic variable is nested within the main categorical variable. If that's not the case, you can disable the dodging:" + "This behavior is called \"dodging\", and it is controlled by the `dodge` parameter. By default (as of v0.13.0), elements dodge only if they would otherwise overlap:" ] }, { @@ -247,10 +247,7 @@ "outputs": [], "source": [ "tips[\"weekend\"] = tips[\"day\"].isin([\"Sat\", \"Sun\"])\n", - "sns.catplot(\n", - " data=tips, x=\"day\", y=\"total_bill\", hue=\"weekend\",\n", - " kind=\"box\", dodge=False,\n", - ")" + "sns.catplot(data=tips, x=\"day\", y=\"total_bill\", hue=\"weekend\", kind=\"box\")" ] }, { diff --git a/doc/whatsnew/v0.13.0.rst b/doc/whatsnew/v0.13.0.rst index cb5c390b39..670a525c5b 100644 --- a/doc/whatsnew/v0.13.0.rst +++ b/doc/whatsnew/v0.13.0.rst @@ -1,5 +1,5 @@ -v0.13.0 (Unreleased) --------------------- +v0.13.0 (September 2023) +------------------------ This is a major release with a number of important new features and changes. The highlight is a major overhaul to seaborn's categorical plotting functions, providing them with many new capabilities and better aligning their API with the rest of the library. There is also provisional support for alternate dataframe libraries like `polars `_, a new theme and display configuration system for :class:`objects.Plot`, and many smaller bugfixes and enhancements. @@ -34,8 +34,8 @@ Two related idiosyncratic color specifications are deprecated, but they will con Finally, like other seaborn functions, the default palette now depends on the variable type, and a sequential palette will be used with numeric data. To retain the previous behavior, pass the name of a qualitative palette (e.g., `palette="deep"` for seaborn's default). Accordingly, the functions have gained a parameter to control numeric color mappings (`hue_norm`). -Other features, enhancements, and changes to categorical plots -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Other features, enhancements, and changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following updates apply to multiple categorical functions.