Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/glamp/bashplotlib
plotting in the terminal
https://github.com/glamp/bashplotlib
Last synced: 3 days ago
JSON representation
plotting in the terminal
- Host: GitHub
- URL: https://github.com/glamp/bashplotlib
- Owner: glamp
- License: mit
- Created: 2012-12-13T04:01:10.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2024-06-23T22:00:04.000Z (7 months ago)
- Last Synced: 2025-01-07T15:10:40.046Z (10 days ago)
- Language: Python
- Homepage:
- Size: 75.4 MB
- Stars: 1,877
- Watchers: 45
- Forks: 141
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-python-resources - GitHub - 62% open · ⏱️ 31.03.2021): (命令行工具)
README
# bashplotlib
*plotting in the terminal*
## what is it?
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.
## installation
### install with pip
```
$ pip install bashplotlib
```
### install from source
```
$ git clone [email protected]:glamp/bashplotlib.git
$ cd bashplotlib
$ python setup.py install
```
Either method will install the bashplotlib python package and will also add hist and scatter
to your python scripts folder. This folder should be on your path (add it if it's not).
## features
- quick plotting from the command line
- customize the color, size, title, and shape of plots
- pipe data into plots with stdin
## usage
### command line
hist takes input from either stdin or specified using the -f parameter. Input should be a single column of numbers.
scatter takes x and y coordinates as input form either a comma delimited file using -f or from 2 different files using -x and -y.
### in python
If you want to use bashplotlib from python, just import histogram and scatterplot.
```
from bashplotlib.scatterplot import plot_scatter
```
```
from bashplotlib.histogram import plot_hist
```
## examples
```
$ scatter --file data/texas.txt --pch .
```
```
$ hist --file data/exp.txt
```
```
$ scatter -x data/x_test.txt -y data/y_test.txt
```
## todo
- sideways numbers for x-axis of histograms
- colors for individual points
- line charts
- trendlines