shellplot 0.2.0

Installation

$ pip install shellplot

Quickstart

Shellplot loosely replicates the matplotlib API, offering both a figure and functional api. It currently supports scatter, line, histogram, bar and boxplots, with many options to customize the figure. It’s as easy as:

>>> import shellplot as plt
>>> df = plt.load_dataset("penguins")
>>> plt.plot(df["bill_length_mm"], df["flipper_length_mm"], color=df["species"])

flipper_length_mm
 232┤                                    o oo  oo    o o        o
    |                                     oo o  o       o
    |                                      oooo
    |                            o oooo ooo oo   o
    |                        oo oooo oo o o o o    o
 217┤                       o o oo ooooo ooo o
    |                   o   o o ooooo o o*oo
    |                     o oo + oooo oooo   *  *
    |                   +   oooo o       o      *       *
    |                   ++              o *  **   **
 202┤        +           +    *             ** **    *
    |      +    ++++   +  +      *    **   ****
    |        ++    +++ +++ +++ +  ** **   ***** **
    |     +++  ++++   ++ ++  +    *+**     * ***
    |   +  + ++++++++++ ++++     *+***  *   *
 187┤+    + + ++ +++++++*+ * *    **           *
    |    ++  ++++++ + +++            *
    |          + ++ +  + + *                                 *
    |  +        ++   +             *                              + Adelie
    |            +     +                                          * Chinstrap
 172┤             +                                               o Gentoo
    └┬----------┬---------┬----------┬----------┬----------┬------
     32         37        42         47         52         57
                            bill_length_mm

Shellplot also provides a convenient integration with pandas. Simply set the pandas plotting backend to shellplot:

>>> import pandas as pd
>>> pd.set_option("plotting.backend", "shellplot")

Please refer to pandas visualisation page for further details.

Note

This project has been set up using PyScaffold 3.2.3. For details and usage information on PyScaffold see https://pyscaffold.org/.