README
¶
DataDash
A data visualization tool for the terminal.
Input streaming or tabular data inside the terminal via pipe or file, and an interactive graph will be generated.
Chart types
datadash currently supports following chart types:
- Line
- Plot tabular or streaming data as line graph
- Line graph supports zooming with the scroll wheel or trackpad
- Supports X-Axis Auto scaling
- Displays the average value with the -a option (customize how many values to consider using -z)
- Different color lines for each graph
- Supports scrolling for streaming data applications (disable with the --no-scroll option)
- Displays up to five graphs simultaneously
- Displays Min, Mean, Max, and Outliers
- Customize the screen redraw interval and input seek interval for high latency or low bandwidth environments
- No dependencies, only one file is required
- Sample datasets included
- Bar
- Support for Bar Graphs (Beta)
- SparkLine
- Support for SparkLine Graphs (Beta)
Streaming Data: (Linechart)
Streaming Data: (Barchart)
Streaming Data: (SparkLines)
This will continue scrolling to the right, displaying the most recent data first and removing the older data to the left.
seq 4000 | awk 'BEGIN{OFS="\t"; print "x"}{x=$1/10; print cos(x) system("sleep 0.01")}' | ./datadash --label-mode time --scroll
Tabular Data:
seq 4000 | awk 'BEGIN{OFS="\t"; print "x","sin(x)"}{x=$1/10; print x,sin(x); system("sleep 0.02")}' | ./datadash --label-mode time
seq 4000 | awk 'BEGIN{OFS="\t"; print "x","sin(x)","cos(x)", "rand(x)", "rand(x)", "rand(x)"}{x=$1/10; print x,sin(x),cos(x),rand(x),rand(x),rand(x); system("sleep 0.02")}' | ./datadash -a
Installation
go get -u github.com/keithknott26/datadash
go build cmd/datadash ; cd cmd
./datadash --help
datadash can accept tabular data like CSV, TSV, or you can use a custom delimiter with the -d option. The default delimiter is tab.
Input Methods
Input data from stdin or file.
$ cat data.txt | datadash
$ datadash data.txt
Data Structure
Below are examples of the accepted data structure. More examples can be found under /tools/sampledata
50
60
70
time\tRowLabel1\tRowLabel2
00:00\t50\t100
00:01\t60\t90
00:02\t70\t80
00:08\t80\t70
23:50\t10\t10
Arguments
$ usage: datadash [<flags>] [<input file>]
Flags:
--help Show context-sensitive help (also try --help-long and --help-man).
--debug Enable Debug Mode
-d, --delimiter="\t" Record Delimiter:
-m, --label-mode="first" X-Axis Labels: 'first' (use the first record in the column) or 'time' (use the current time)
-s, --scroll Whether or not to scroll chart data
-a, --average-line Enables the line representing the average of values
-z, --average-seek=500 The number of values to consider when displaying the average line: (50,100,500...)
-r, --redraw-interval=10ms The interval at which objects on the screen are redrawn: (100ms,250ms,1s,5s..)
-l, --seek-interval=20ms The interval at which records (lines) are read from the datasource: (100ms,250ms,1s,5s..)
Args:
[<input file>] A file containing a label header, and data in columns separated by a delimiter 'd'. Data piped from Stdin uses the same format
License
MIT
Documentation
¶
Index ¶
- func Float64s(a []float64) int
- func Float64sAreUnique(a []float64) bool
- func Ints(a []int) int
- func IntsAreUnique(a []int) bool
- func IsUnique(data Interface) bool
- func Stable(data Interface) int
- func Strings(a []string) int
- func StringsAreUnique(a []string) bool
- func Uniq(data Interface) int
- type Interface
- type Panel
- type Row
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Float64sAreUnique ¶
Float64sAreUnique tests whether the slice of float64 is sorted and unique.
func IntsAreUnique ¶
IntsAreUnique tests whether the slice of int is sorted and unique.
func Stable ¶
Stable moves the first unique elements to the beginning of the *sorted* collection and returns the number of unique elements, but also keeps the original order of duplicate elements.
It makes one call to data.Len, O(n) calls to data.Less, and O(n*log(n)) calls to data.Swap.
func StringsAreUnique ¶
StringsAreUnique tests whether the slice of string is sorted and unique.
func Uniq ¶
Uniq moves the first unique elements to the beginning of the *sorted* collection and returns the number of unique elements.
It makes one call to data.Len to determine n, n-1 calls to data.Less, and O(n) calls to data.Swap. The unique elements remain in original sorted order, but the duplicate elements do not.
Types ¶
type Interface ¶
type Interface interface {
// Len returns the number of elements.
Len() int
// Less tells if the element at index i should come
// before the element at index j.
Less(i, j int) bool
// Swap swaps the elements at indexes i and j.
Swap(i, j int)
}
Interface to use the uniq package. Identical to sort.Interface.
type Row ¶
type Row struct {
ID int
Label string
Scroll bool
Average bool
Labels *stringRingBuffer
Context context.Context
Data *float64RingBuffer
Averages *float64RingBuffer
LineChart *linechart.LineChart
BarChart *barchart.BarChart
SparkLine *sparkline.SparkLine
Textbox *text.Text
DataContainer []float64
LabelContainer []string
AverageContainer []float64
RedrawInterval time.Duration
SeekInterval time.Duration
}
Source Files
Directories