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

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.5
File Size Uploaded
plottoolbox-105.2.5.tar.gz 38.8 MB Details

Built distribution (wheel)

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

Total release size: 73.5 MB

Release files / plottoolbox-105.2.5.tar.gz

Download URL plottoolbox-105.2.5.tar.gz
Size 38.8 MB
Tags Source
SHA-256 checksum
How to use checksums
fd843902d9573670b9c9e8910c331e438b838104eb3d3953685dfafb3337eaa1
BLAKE2b-256 checksum
How to use checksums
368eace4de94779b19b75504b7651b0b6f968376ba45f72a1fc9edb92c100315
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 7, 2026.

Transparency log

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

Download URL plottoolbox-105.2.5-py3-none-any.whl
Size 34.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
da3c5c6e323ef9ed2ddcd0959bbd1fcc5068967186aff4b5d012afe0992741fa
BLAKE2b-256 checksum
How to use checksums
4171c306ba6b32b303f01a44c4cef403ac9aa599bca6bf411560ebd62fb38e61
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 7, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

105.2.5 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