Skip to content

Remove deprecated hue_style from 1D plots #11787

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ShinoKana wants to merge 2 commits into
base: main
Choose a base branch
from
+6 −41
Open

Remove deprecated hue_style from 1D plots #11787

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1efca4c
Remove the deprecated hue_style argument of the 1D plot functions
ShinoKana Oct 22, 2026
7767566
Add PR number to whats-new
ShinoKana Oct 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions doc/whats-new.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,12 @@ Breaking Changes
deprecated since v0.16.1, have been removed. Pass them in
``dask_gufunc_kwargs`` instead (:issue:`11721`, :pull:`11755`).
By `Daisy DAI <https://github.com/ShinoKana>`_.
- The ``hue_style`` argument of the 1D plot functions (``lines`` and
``scatter`` for :py:class:`DataArray` and :py:class:`Dataset`), deprecated
since v2023.07.0, has been removed. Convert numbers to strings for a discrete
hue, and use ``add_legend`` or ``add_colorbar`` to choose the guide
(:issue:`11721`, :pull:`11787`).
By `Daisy DAI <https://github.com/ShinoKana>`_.


Deprecations
Expand Down
12 changes: 0 additions & 12 deletions xarray/plot/accessor.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,6 @@ def lines( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -183,7 +182,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -223,7 +221,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -307,7 +304,6 @@ def scatter( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -347,7 +343,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -387,7 +382,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1055,7 +1049,6 @@ def lines( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1095,7 +1088,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1135,7 +1127,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1179,7 +1170,6 @@ def scatter( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1219,7 +1209,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1259,7 +1248,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down
21 changes: 0 additions & 21 deletions xarray/plot/dataarray_plot.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,6 @@
from xarray.core.types import (
AspectOptions,
ExtendOptions,
HueStyleOptions,
ScaleOptions,
T_DataArray,
)
Expand Down Expand Up @@ -886,7 +885,6 @@ def newplotfunc(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
row: Hashable | None = None,
Expand Down Expand Up @@ -971,19 +969,6 @@ def newplotfunc(
del msg
del args

if hue_style is not None:
# TODO: Not used since 2022.10. Deprecated since 2023.07.
warnings.warn(
(
"hue_style is no longer used for plot1d plots "
"and the argument will eventually be removed. "
"Convert numbers to string for a discrete hue "
"and use add_legend or add_colorbar to control which guide to display."
),
FutureWarning,
stacklevel=2,
)

_is_facetgrid = kwargs.pop("_is_facetgrid", False)

if plotfunc.__name__ == "scatter":
Expand Down Expand Up @@ -1163,7 +1148,6 @@ def lines( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1204,7 +1188,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1245,7 +1228,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1333,7 +1315,6 @@ def scatter( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1374,7 +1355,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1415,7 +1395,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down
8 changes: 0 additions & 8 deletions xarray/plot/dataset_plot.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -758,7 +758,6 @@ def scatter( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -799,7 +798,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -840,7 +838,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -881,7 +878,6 @@ def scatter(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -929,7 +925,6 @@ def lines( # type: ignore[misc,unused-ignore] # None is hashable :(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -970,7 +965,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1011,7 +1005,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down Expand Up @@ -1052,7 +1045,6 @@ def lines(
y: Hashable | None = None,
z: Hashable | None = None,
hue: Hashable | None = None,
hue_style: HueStyleOptions = None,
markersize: Hashable | None = None,
linewidth: Hashable | None = None,
figsize: Iterable[float] | None = None,
Expand Down
Loading