Skip to content

Commit 956d0f3

Browse files
Greg Lamprobert
authored andcommitted
Squash all commit history so that repo clones faster
Otherwise the massive data files in the history cause it to take forever to clone the repo. See https://github.com/glamp/bashplotlib for the git history.
0 parents commit 956d0f3

25 files changed

+766
-0
lines changed

.gitignore

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
*.pyc
2+
env
3+
*.txt
4+
bashplotlib.egg-info
5+
build
6+
dist
7+

LICENSE.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Copyright (c) 2013 Greg Lamp
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4+
5+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6+
7+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

MANIFEST

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# file GENERATED by distutils, do NOT edit
2+
setup.py
3+
bashplotlib/__init__.py
4+
bashplotlib/histogram.py
5+
bashplotlib/scatterplot.py

README.md

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# bashplotlib
2+
*plotting in the terminal*
3+
4+
<img src="examples/img/basichist.png">
5+
6+
## what is it?
7+
bashplotlib is a python package and command line tool for making basic plots in the terminal. It's a quick way to visualize data when you don't have a GUI. It's written in pure python and can quickly be installed anywhere using pip.
8+
9+
## installation
10+
### install with pip
11+
```
12+
$ pip install bashplotlib
13+
```
14+
### install from source
15+
```
16+
$ git clone git@github.com:glamp/bashplotlib.git
17+
$ cd bashplotlib
18+
$ python setup.py install
19+
```
20+
21+
Either method will install the bashplotlib python package and will also add <code>hist</code> and <code>scatter</code>
22+
to your python scripts folder. This folder should be on your path (add it if it's not).
23+
24+
## features
25+
26+
- quick plotting from the command line
27+
- customize the color, size, title, and shape of plots
28+
- pipe data into plots with stdin
29+
30+
31+
## usage
32+
### command line
33+
<code>hist</code> takes input from either stdin or specified using the -f parameter. Input should be a single column of numbers.
34+
<img src="examples/img/histhelp.png">
35+
<code>scatter</code> takes x and y coordinates as input form either a comma delimited file using -f or from 2 different files using -x and -y.
36+
<img src="examples/img/scatterhelp.png">
37+
38+
### in python
39+
If you want to use bashplotlib from python, just import histogram and scatterplot.
40+
```
41+
from bashplotlib.scatterplot import plot_scatter
42+
```
43+
<img src="examples/img/scatterplothelp.png">
44+
45+
```
46+
from bashplotlib.histogram import plot_hist
47+
```
48+
49+
<img src="examples/img/histogramhelp.png">
50+
51+
## examples
52+
```
53+
$ scatter --file data/texas.txt --pch .
54+
```
55+
<img src="examples/img/texas.png">
56+
57+
```
58+
$ hist --file data/exp.txt
59+
```
60+
<img src="examples/img/histogram.png">
61+
62+
```
63+
$ scatter -x data/x_test.txt -y data/y_test.txt
64+
```
65+
<img src="examples/img/scatter.png">
66+
67+
## todo
68+
69+
- sideways numbers for x-axis of histograms
70+
- colors for individual points
71+
- line charts
72+
- trendlines
73+
74+

README.rst

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
bashplotlib
2+
===========
3+
4+
*plotting in the terminal*
5+
6+
what is it?
7+
-----------
8+
9+
bashplotlib is a python package and command line tool for making basic
10+
plots in the terminal. It's a quick way to visualize data when you don't
11+
have a GUI. It's written in pure python and can quickly be installed
12+
anywhere using pip.
13+
14+
installation
15+
------------
16+
17+
install with pip
18+
~~~~~~~~~~~~~~~~
19+
20+
::
21+
22+
$ pip install bashplotlib
23+
24+
install from source
25+
~~~~~~~~~~~~~~~~~~~
26+
27+
::
28+
29+
$ git clone git@github.com:glamp/bashplotlib.git
30+
$ cd bashplotlib
31+
$ python setup.py install
32+
33+
Either method will install the bashplotlib python package and will also
34+
add hist and scatter to your python scripts folder. This folder should
35+
be on your path (add it if it's not).
36+
37+
features
38+
--------
39+
40+
- quick plotting from the command line
41+
- customize the color, size, title, and shape of plots
42+
- pipe data into plots with stdin
43+
44+
usage
45+
-----
46+
47+
command line
48+
~~~~~~~~~~~~
49+
50+
hist takes input from either stdin or specified using the -f parameter.
51+
Input should be a single column of numbers. scatter takes x and y
52+
coordinates as input form either a comma delimited file using -f or from
53+
2 different files using -x and -y.
54+
55+
in python
56+
~~~~~~~~~
57+
58+
If you want to use bashplotlib from python, just import histogram and
59+
scatterplot.
60+
61+
::
62+
63+
from bashplotlib.scatterplot import plot_scatter
64+
65+
::
66+
67+
from bashplotlib.histogram import plot_hist
68+
69+
examples
70+
--------
71+
72+
::
73+
74+
$ scatter --file data/texas.txt --pch .
75+
76+
::
77+
78+
$ hist --file data/exp.txt
79+
80+
::
81+
82+
$ scatter -x data/x_test.txt -y data/y_test.txt
83+
84+
todo
85+
----
86+
87+
- sideways numbers for x-axis of histograms
88+
- colors for individual points
89+
- line charts
90+
- trendlines
91+

bashplotlib/__init__.py

Whitespace-only changes.

0 commit comments

Comments
 (0)