Skip to main content
Tests Test Coverage Latest release BSD-3 clause license PyPI - Python Version

plottoolbox - Quick Guide

The plottoolbox is a Python script to manipulate time-series on the command line or by function calls within Python. Uses pandas (http://pandas.pydata.org/) or numpy (http://numpy.scipy.org) for any heavy lifting.

Requirements

  • pandas

Installation

pip

pip install plottoolbox

conda

conda install -c conda-forge plottoolbox

Usage - Command Line

Just run ‘plottoolbox –help’ to get a list of subcommands:

usage: plottoolbox [-h]
                   {autocorrelation, bar, bar_stacked, barh, barh_stacked,
                   bootstrap, boxplot, double_mass, heatmap, histogram,
                   kde, kde_time, lag_plot, lognorm_xaxis, lognorm_yaxis,
                   norm_xaxis, norm_yaxis, probability_density,
                   scatter_matrix, target, taylor, time, weibull_xaxis,
                   weibull_yaxis, xy, about} ...

positional arguments:
  {autocorrelation, bar, bar_stacked, barh, barh_stacked, bootstrap,
  boxplot, double_mass, heatmap, histogram, kde, kde_time, lag_plot,
  lognorm_xaxis, lognorm_yaxis, norm_xaxis, norm_yaxis,
  probability_density, scatter_matrix, target, taylor, time, weibull_xaxis,
  weibull_yaxis, xy, about}

autocorrelation
    Autocorrelation plot.
bar
    Bar plot, sometimes called a "column" plot.
bar_stacked
    Stacked vertical bar, sometimes called a stacked column plot.
barh
    Bar plot, sometimes called a "column" plot.
barh_stacked
    Horizontal stacked bar plot.
bootstrap
    Bootstrap plot randomly selects a subset of the imput time-series.
boxplot
    Box and whiskers plot.
double_mass
    Double mass curve - cumulative sum of x against cumulative sum of y.
heatmap
    2D heatmap of daily data.
histogram
    Histogram.
kde
    Kernel density estimation of probability density function.
kde_time
    A time-series plot with a kernel density estimation (KDE) plot.
lag_plot
    Lag plot.
lognorm_xaxis
    Log-normal x-axis.
lognorm_yaxis
    Log-normal y-axis.
norm_xaxis
    Normal x-axis.
norm_yaxis
    Normal y-axis.
probability_density
    Probability plot.
scatter_matrix
    Plots all columns against each other in matrix of plots.
target
    Creates a "target" diagram to plot goodness of fit.
taylor
    Taylor diagram to plot goodness of fit.
time
    Time-series plot.
weibull_xaxis
    Weibull x-axis.
weibull_yaxis
    Weibull y-axis.
xy
    Creates an 'x,y' plot, also known as a scatter plot.
about
    Display version number and system information.

optional arguments:
  -h, --help            show this help message and exit

The default for all of the subcommands is to accept data from stdin (typically a pipe). If a subcommand accepts an input file for an argument, you can use “–input_ts=input_file_name.csv”, or to explicitly specify from stdin (the default) “–input_ts=’-‘”.

For the subcommands that output data it is printed to the screen and you can then redirect to a file.

Usage - API

You can use all of the command line subcommands as functions. The function signature is identical to the command line subcommands. The return is always a PANDAS DataFrame. Input can be a CSV or TAB separated file, or a PANDAS DataFrame and is supplied to the function via the ‘input_ts’ keyword.

Simply import plottoolbox:

from plottoolbox import plottoolbox

# Then you could call the functions
plt = plottoolbox.time(input_ts='tests/test_fill_01.csv')

Metadata

Release files for plottoolbox 105.2.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plottoolbox 105.2.4
File Size Uploaded
plottoolbox-105.2.4.tar.gz 38.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for plottoolbox 105.2.4
File Interpreter ABI Platform
plottoolbox-105.2.4-py3-none-any.whl Python 3 none any Details

Total release size: 73.5 MB

Release files / plottoolbox-105.2.4.tar.gz

Download URL plottoolbox-105.2.4.tar.gz
Size 38.8 MB
Tags Source
SHA-256 checksum
How to use checksums
0cd4be50a28dec6301c9b3d2be88b8ad9cb65c85814cc6539b6498b268b8f04e
BLAKE2b-256 checksum
How to use checksums
6da993c366c55dda7abed81fa699e573f6617f07c75d33c7a2cb8e98a20344b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 22, 2026.

Transparency log

Release files / plottoolbox-105.2.4-py3-none-any.whl

Download URL plottoolbox-105.2.4-py3-none-any.whl
Size 34.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9f4a5bd76abb7798809826d7958c965ce1fb4b7e93f6c006696883e0828362b1
BLAKE2b-256 checksum
How to use checksums
402bd6108e6fad97f36171251e6505c2d3c5752fc60b3598e4f906517346e2c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 22, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

105.2.4 This release

2 release files

105.0.1

1 release file

105.0.0

1 release file

104.4.1

1 release file

104.4.0

1 release file

104.3.1

1 release file

104.3.0

1 release file

104.2.0

1 release file

104.0.1

1 release file

102.1.0

1 release file

102.0.0

1 release file

101.6.4

1 release file

101.6.3

1 release file

101.6.2

1 release file

101.6.1

1 release file

101.6.0

1 release file

101.5.0

1 release file

101.4.9

1 release file

101.4.8

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page