Ruby program to read a series of datasets from a csv-formatted file and
visualize the data as terminal output. The first line of data will be drawn
as the bottom line in the visualized output.
You can choose between the following output:
Visualization of a dataset from a series of data
Visualization of the value differences of two datasets
Visualization of a timeline from a point within the data domain
Animation of all datasets
Interpolation of a value of a dataset within the data domain
Current version: v0.9.2
Usage & Help
```
script usage: ruby
TerminalVis help:
-h, –help show help text
-v, –version prints the current version of the project
-f, –file argument: ; optional parameter that indicates a filepath to a readable file
-e, --extreme marks the extreme values in a dataset with ++ for a maximum and -- for a minimum, also prints the coordinates of the extreme values below the legend, excludes -c
-m, --meta process the file containing meta data
-a, --all argument: ; prints all specified datasets of a dataseries with a pause between the output of every dataset defined by speed: 0 means manual, a value > 0 an animation speed in seconds, excludes -i, -d and -t
-i, --index argument: ; shows the dataset at index, if index lies within [1,2, ..., # datasets], excludes -a, -d and -t
-o, --options argument:
Invalid parameter combinations:
-a + -d, -a + -i, -a + -t
-r + -t, -r + -i
-c + -e, -c + -t
-d + -i, -d + -t
Available configuration parameter:
Timeline: number of interval steps in y-dimension [5,100]
Color legend: extended informations about the intervals
Scaling: automatic scaling of the output to the size of the calling terminal (atm standard dataset output, e.g. -i only)
```
Invalid parameter combinations
-a + -d, -a + -i, -a + -t
-r + -t, -r + -i
-c + -e, -c + -t
-d + -i, -d + -t
Configuration options
Configuration parameter
Configuration paramters can be specified by the parameter -o. From their they
can inserted manually or from a file. The current parameters are:
Timeline y-dimension: specifies how much interval steps in y-dimension should
be used; value interval [5, 100]
Extended color legend information: specifies if the interval values should
be displayed
Output scaling: scales the visualized output to fit in the terminal, that
started the script
Default values
Timeline y-dimension: 20
Extended color legend information: off
Output scaling: off
Examples
Reading a data series from <filename> with meta data and visualizing the first
dataset:
ruby terminal_vis.rb -m <filename>
Reading a data series from <filename> without meta data and visualizing the
dataset at <index>:
ruby terminal_vis.rb -i <index> <filename>
Reading a data series from <filename> with meta data and creating a timeline
for the coordinate (<x>,<y>):
ruby terminal_vis.rb -m -t <x> <y> <filename>
Reading a data series from <filename> with meta data and animating a specific
interval from the data series:
ruby terminal_vis.rb -m -r <start> <end> -a <speed> <filename>
Running the script to visualize a dataset from <filename> and entering
configuration option through the menu:
ruby terminal_vis.rb -m -i <index> -o menu <filename>
Running the script to visualize a specific region of a dataset from
<filename>:
ruby terminal_vis.rb -m -i <index> -c <x> <y> -s <interval> <delta> <filename>
Documentation
Documentation is written in yard and can be created by running the shell-script
create_yard.sh. Yard needs to be installed on the system in order to do that.
The documentation can also be found online here.
Meta data format (in single line):
#### Two dimensional data set:
```
,
,,,,
,,,
```
#### Three dimensional data set:
```
,
,,,,
,,,,
,,,
```
## Used version
Written with Ruby 2.2.2 - 2.4.1
## Tested
* Linux: running on ArchLinux with Ruby > 2.2.2
* Windows: not tested
* MAC: not tested
## Requirements
* Ruby with a version > 2.2
* [ruby_utils](https://github.com/SettRaziel/ruby_utils)
* matrix (core, all)
* csv (all)
* Win32/Console/ANSI (Windows)
* yard (for Documentation only)
## License
see LICENSE
## Roadmap
* adding a mechanism to allow some configuration parameters to be set and
stored within a configuartion file (done with update v0.7.1)
* adding an option to interpolate for a region of the considered x- and
y-dimenstion (done with update v0.8.0)
* adding a mechanism to scale the output automatically to the dimension of
the used terminal (done for standard dataset output in v0.8.2, delta output
and animation in v0.8.3; timeline in v0.9.0)
* statistics for a single or multiple data set(s); see:[(Issue)](https://github.com/SettRaziel/ruby_visualization/issues/2) and see:[(Issue)](https://github.com/SettRaziel/ruby_visualization/issues/3)
* refactoring of error messages; see:[(Issue)](https://github.com/SettRaziel/ruby_visualization/issues/1)
* adding more features from suggestions
## Contributing
* Fork it
* Create your feature branch (git checkout -b my-new-feature)
* Commit your changes (git commit -am 'add some feature')
* Push to the branch (git push origin my-new-feature)
* Create an issue describing your work
* Create a new pull request
created by: Benjamin Held, May 2015
