This release has many changes, check out the changelog. A version of the changes is included below.
API Changes
-
The
draw
parameter ofgeom_map
has been removed. Shapefiles should contain only one type of geometry and that is the geometry that is drawn. -
Ordinal (Ordered categorical) columns are now mapped to ordinal scales. This creates different plots.
-
The default mapping for the computed aesthetic size of
stat_sum
has changed to'stat(n)'
. This also changes the default plot forgeom_count
.
New Features
geom_text
gained theadjust_text
parameter, and can now repel text.- Added
annotation_logticks
. - Added
geom_sina
- Added scales for ordinal (ordered categorical) columns.
geom_step
gained the optionmid
for the direction parameter. The steps are taken mid-way between adjacent x values.- Added
annotation_stripes
.
Bug Fixes
-
Fixed bug where facetting would fail if done on a plot with annotation(s) and one of the facetting columns was also a variable in the environment.
-
Fixed bug where
coord_flip
would not flip geoms created bygeom_rug
(GH216). -
Fixed bug where plots with
theme_xkcd
cannot be saved twice (GH199) -
Fixed bug that made it impossible to map to columns with the same name as a calculated columns of the stat. (GH234)
-
Fixed bug in
geom_smooth
that made it difficult to use it with stats other thanstat_smooth
. (GH242) -
Fixed bug in
position_dodge
where by bar plot could get thinner when facetting and useingpreserve = 'single'
. (GH224) -
Fixed bug in
coord_trans
where if the transformation reversed the original limits, the order in which the data was laid out remained unchanged. (GH253) -
Fixed bug in
stat_count
wherefloat
weights were rounded and lead to a wrong plot. (GH260) -
Fixed bug where one could not use the British spelling
colour
to rename a color scale. (GH264) -
Fixed bug in
lims
,xlim
, andylim
wheredatetime
andtimedelta
limits resulted in an error. -
Fixed bug where
geom_rect
could not be used withcoord_trans
. (GH256) -
Fixed bug where using free scales with facetting and flipping the coordinate axes could give unexpected results. (GH286)
-
Fixed unwanted tick along the axis for versions of Matplotlib >= 3.1.0.
-
Fixed
geom_text
not to error when usinghjust
andvjust
. (GH287) -
Fixed bug where
geom_abline
geom_hline
andgeom_vline
could give wrong results when used withcoord_trans
. -
Fixed bug where layers with only infinite values would lead to an exception if they were the first layer encountered when choosing a scale.
Enhancements
-
Legends are now plotted in a predictable order which dedends on how the plot is constructed.
-
The spokes drawn by
geom_spoke
can now have a fixed angle. -
Aesthetics that share a scale (e.g. color and fill can have the same scale) get different guides if mapped to different columns.
-
When the transform of a specialised (one that is not and identity scale) continuous scale is altered, the user is warned about a possible error in what they expect. (GH254, GH255)
-
The
method_args
parameter instat_smooth
can now differentiate between arguments for initialising and those for fitting the smoothing model. -
position_nudge
can now deal with more geoms e.g.geom_boxplot
. -
The
limits
parameter ofscale_x_discrete
andscale_y_discrete
can now be a function. -
The
width
of the boxplot can now be set irrespective of the stat. -
The mid-point color of
scale_color_distiller
now matches that of the trainned data. -
The way in which layers are created has been refactored to give packages that that extend plotnine more flexibility in manipulating the layers.
-
You can now specify one sided limits for coordinates. e.g.
coord_cartesian(limits=(None, 10))
. -
All the themeables have been lifted into the definition of
theme
so they can be suggested autocomplete.