API Changes

  • geom_smooth gained an extra parameter legend_fill_ratio that control the area of the legend that is filled to indicate confidence intervals. (GH32)
  • gained an extra parameter verbose. It no longer guesses when to print information and when not to.
  • plotnine.ggplot.draw() gained an extra parameter return_ggplot.
  • If the minor_breaks parameter of scales is a callable, it now expects one argument, the limits. Previously it accepted breaks and limits.

New Features

  • Added PlotnineAnimation for animations.
  • Added watermark for watermarks.
  • Added datetime scales for alpha, colour, fill and size aesthetics


  • Changed parameter settings for stat_smooth.

    1. Default span=0.75 instead of 2/3
    2. When using loess smoothing, the control parameter surface is only set to the value 'direct' if predictions will be made outside the data range.
  • Better control of scale limits. You can now specify individual limits of a scale.

    scale_y_continuous(limits=(0, None))
    xlim(None, 100)

    You can also use expand_limits()

  • Low and high scale limits can now be expanded separately with different factors multiplicative and additive factors.

  • The layer parameter show_legend can now accept a dict for finer grained control of which aesthetics to exclude in the legend.

  • Infinite values are removed before statistical computations stats (GH40).

    stats also gained new parameter na_rm, that controls whether missing values are removed before statistical computations.

  • qplot() can now use the name and a Pandas series to label the scales of the aesthetics.

  • You can now put stuff to add to a ggplot object into a list and add that that instead. No need to wrap the list around the internal class Layers.

    lst = [geom_point(), geom_line()]
    g = ggplot(df, aes('x', 'y'))
    print(g + lst)

    Using a list allows you to bundle up objects. I can be convenient when creating some complicated plots. See the Periodic Table Example.

Bug Fixes

  • Fixed bug where facetting led to a reordering of the data. This would manifest as a bug for geoms where order was important. (GH26)
  • Fix bug where facetting by a column whose name (eg. class) is a python keyword resulted in an exception. (GH28)
  • Fix bug where y-axis scaling was calculated from the xlim argument.
  • Fix bug where initialising geoms from stats, and positions from geoms, when passed as classes (e.g. stat_smooth(geom=geom_point), would fail.
  • Fixed bug in where specifying the width and height would mess up the strip_text and spacing for the facetted plots. (GH44).
  • Fixed bug in geom_abline, geom_hline and geom_vline where facetting on a column that is not mapped to an aesthetic fails. (GH48)
  • Fixed bug in geom_text, the fontstyle parameter was being ignored.
  • Fixed bug where boolean data was mapped to the same value on the coordinate axis. (GH57)
  • Fixed bug in facet_grid where the scales sometimes has no effect. (GH58)
  • Fixed bug in stat_boxplot where setting the width parameter caused an exception.



  • Fixed bug where manually setting the aesthetic fill=None or fill='None' could lead to a black fill instead of an empty fill.
  • Fixed bug where computed aesthetics could not be used in larger statements. (GH7)
  • Fixed bug in stat_summary where the you got an exception for some types of the x aesthetic values.
  • Fixed bug where ggplot(data=df) resulted in an exception.
  • Fixed missing axis ticks and labels for facet_wrap when the scales are allowed to vary (e.g scales='free') between the panels.
  • Fixed bug in stat_density where changing the x limits lead to an exception (GH22)



  • Fixed bug in scale_x_discrete and scale_y_discrete where if they were instantiated with parameter limits that is either a numpy array or a pandas series, plotting would fail with a ValueError.
  • Fixed exceptions when using pandas.pivot_table() for Pandas v0.20.0. The API was fixed.
  • Fixed issues where lines/paths with segments that all belonged in the same group had joins that in some cases were "butted".

API Changes

  • geom_text now uses ha and va as parameter names for the horizontal and vertical alignment. This is what matplotlib users expect. The previous names hjust and vjust are silently accepted.
  • Layers() can now be used to bundle up geoms and stats. This makes it easy to reuse geoms and stats or organise them in sensible bundles when making complex plots.



First public release