Bbv is a minimalist data plotter/viewer for the command line

kermatt1 pts0 comments

GitHub - ftonneau/bbv: A minimalist data plotter/viewer for exploratory data analyses · GitHub

/" data-turbo-transient="true" />

Skip to content

Search/

Sign in<br>Sign upAppearance settings

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

ftonneau

bbv

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>31 Commits<br>31 Commits

LICENSE

LICENSE

README.md

README.md

bbv

bbv

columns.png

columns.png

pairwise.png

pairwise.png

View all files

Repository files navigation

bbv

Bbv (for "bare-bones viewer") is a minimalist data plotter/viewer for the<br>command line . Bbv is best suited for a quick look at functional relations<br>gathered during exploratory data analysis.

Bbv uses stdin as input and must be called from a pipe of shell commands:

command_1 | command_2 | ... | bbv

The data must be tab-separated, and there is only one option , x.

Piping your data into bbv will produce a line plot column by column.<br>For example:

Piping your data into bbv x will produce a scatter plot of pairwise (x, y)<br>values. For example:

Bbv, being written in POSIX shell and awk, requires only a functioning POSIX<br>system and does not tie you to any extra toolchain. You can use any lightweight<br>image viewer as back end, provided it reads the SVG format. Possible candidates<br>are, in alphabetical order:

eom (Eye of MATE)

feh

imv

loupe (GNOME Image Viewer)

pqiv

sxiv | nsxiv

viewnior

vimiv

All of these viewers open SVGs, permit image zooming (+/-), and allow you to use<br>keyboard arrows for paning. Some of these viewers also accept vim-like shortcuts<br>(h, j, k, l) for arrows.

Important

Bbv does not support real-time plotting of a long-term running process. If<br>dynamic plotting of a data stream is your use case, you will be better served<br>by feedgnuplot.

Installation

Download the provided bbv file.

Make the file executable (chmod +x bbv) and put it into your PATH.

Specify your image back end via the environment variable, BBV_BACKEND.

For example, if you want to use imv as image<br>viewer, write the following:

export BBV_BACKEND='imv'

in your .bashrc or equivalent.

You can include command-line options in what you specify as bbv's back end.<br>For example:

export BBV_BACKEND='imv -c overlay'

Usage

Typing bbv directly in the terminal will print a short help on usage.

Otherwise, usage is from a pipe, ... | bbv [x], x being optional.

The ranges of the resulting plot are the minima and maxima of your dataset.<br>While plotting, bbv skips missing values and non-numeric values.

It goes without saying that there are no options for titles, annotations,<br>legends, custom axes, axis transformations, custom labels, ticks, colors,<br>styles, plot types, and so on.

Note on output

The file that bbv produces from stdin (and that is opened by your chosen<br>back end) is saved in your working directory as tmp_bbv.svg. This is a<br>regular SVG file, fully editable in Inkscape (for example).

License

MIT

About<br>A minimalist data plotter/viewer for exploratory data analyses<br>Topics<br>command-lineexploratory-data-analysisplotplottingviewer<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>1 star<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository

Releases

Packages

Contributors

Languages

You can’t perform that action at this time.

data viewer file example image minimalist

Related Articles