shellplot 0.2.0

Plotting from the command line

shellplot

“We should have never left the command line.”

Shellplot is the plotting package that you didn’t know you needed. Plotting, straight outta the command line.

Please take a look at the documentation, which contains many examples.

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/.