Metadata-Version: 2.1
Name: cli-plot
Version: 1.0
Summary: A commandline app for plotting datafiles
Home-page: https://github.com/John-Lee-Cooper/cli_plot
Author: John Lee Cooper
Author-email: cooperjl90@gmail.com
License: MIT
Download-URL: https://github.com/John-Lee-Cooper/cli_plot/archive/1.0.0.tar.gz
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: click (==7.1.2)
Requires-Dist: cycler (==0.10.0)
Requires-Dist: kiwisolver (==1.2.0)
Requires-Dist: matplotlib (==3.3.0)
Requires-Dist: numpy (==1.19.1)
Requires-Dist: pandas (==1.0.5)
Requires-Dist: Pillow (==7.2.0)
Requires-Dist: pyparsing (==2.4.7)
Requires-Dist: python-dateutil (==2.8.1)
Requires-Dist: pytz (==2020.1)
Requires-Dist: scipy (==1.5.2)
Requires-Dist: seaborn (==0.10.1)
Requires-Dist: six (==1.15.0)
Requires-Dist: typer (==0.3.1)

# CLI Plot

A commandline app for parsing and plotting text data files.

# Installation

## Using Pip

```bash
  $ pip install cli-plot
```

## Manual

```bash
  $ git clone https://bitbucket.org/lee-cooper/plot
  $ cd cli_plot
  $ python setup.py install
```

# Usage

```bash
$ cli_plot --version
$ cli_plot --help
```

## Generate demo

Generate and display some sample data, written to demo.dat

```bash
$ cli_plot --demo
```
![cli-plot](https://github.com/John-Lee-Cooper/cli_plot/raw/master/image/plot1.png)

## User Interface

 Key    | Result
 :---:  | :---  
 g      | Toggle Grid
 t      | Cycle Plot Type
 m      | Toggle Series Markers
 1-9    | Toggle Series 1-9 Display
 enter  | Save Plot to png Image
 escape | Exit

Holding the left mouse button down and moving the mouse will pan the plot.
Rolling the mouse wheel up and down will zoom the plot where the mouse is located.




## Display head of file
```bash
$ cli_plot demo.dat --type=head
```

## Plot specific columns

Plot sin and growth against time:

```bash
$ cli_plot demo.dat time sin damp
```
![cli-plot](https://github.com/John-Lee-Cooper/cli_plot/raw/master/image/plot2.png)

## Plot pairs of columns

Plot columns 2 against column 1 and column 4 against column 3:

```bash
$ cli_plot demo.dat 2,3 1,4
```
![cli-plot](https://github.com/John-Lee-Cooper/cli_plot/raw/master/image/plot3.png)

## Specify plot type

Plot data as a scatter plot:

```bash
$ cli_plot demo.dat --type=scatter
```
![cli-plot](https://github.com/John-Lee-Cooper/cli_plot/raw/master/image/plot4.png)


