Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

clplot is a command line utility to create plots and pages of plots from csv-like files.

Project Description


clplot is a command line utility to create plots and pages of plots from csv-like files.

It is a thin wrapper over matplotlib with a few conveniences built in.


If you find yourself opening a csv file in a spreadsheet-like program to quickly plot and visualize your results, clplot may be a useful alternative for you.

It allows you to get summary information about columns in your dataset, plot given variables, plot all variables, and specify the manner in which plots (or pages of plots) are formatted.


$ pip install git+


  • numpy
  • matplotlib



Assume that the data file is named myfile.csv and that it has a header row with the names of the columns. Each subsequent row is assumed to have numerical values corresponding to the header field names. For the examples below, the header would have, at least, the field names (column headers) y1, y2, y3, y4, y5, and v1.

Show the help:

$ -h

Don’t make any plots; just list all of the column names that are present in the data file:

$ -l myfile.csv

Don’t make any plots; just list some statistics and information about columns ‘y1’ and ‘y2’:

$ -i -c y1 -c y2 myfile.csv

Plot all of the columns in the file using the default independent variable (the one in the first column):

$ myfile.csv

Plot just the columns ‘y1’ and ‘y2’ and use ‘v1’ as the independent variable:

$ -c y1 -c y2 -x v1 myfile.csv

Plot all of the columns except ‘y3’ and ‘y4’, put 12 plots on each figure, and make the axis font size large:

$  -e y3 -e y4 -n 12 --fontsize=20.0 myfile.csv

Plot columns matching the regular expression ‘y.(1|5)’ and put nine plots on each figure:*

$ -n 9 -cr 'y.*(1|5)' myfile.csv

(The regular expression may need different quoting, depending on the OS or shell)

Plot all of the data columns using red, dashed, thick lines:

$ --linecolor='red' --linestyle='--' --linewidth=5 myfile.csv

Plot all of the data except those column names matching the regular expression ‘.y.1’, and assume that the entries in the file are separated by tabs instead of commas:

$ -er '.*y.*1' -d '\t' myfile.csv

On Windows, use clplot.exe instead of in the lines above.


This program is freely available for anyone to use under an MIT license. Please consult the MIT-LICENSE file.

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(11.3 kB) Copy SHA256 Hash SHA256
Source Oct 28, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting