usageinfo-gnuplot

Convert time-dependent tabular 2D data to executable gnuplot scripts

Synopsis

$ usageinfo [OPTION]... INFILE

Options

• --man

  Print the manual page and exit.

• --help

  Print a brief help message and exit.

Reading data

Customize how data is read in.

• --sep = value

  Set separation character for plain text files.

• --sheet = value

  Set sheet number for spreadsheet files (default: 1).

• --column = abscol,ordcol

  Set numbers of abcissa column (default: 1) and ordinate column (default: 2) separated by a comma.

• --dtfmt = datespec

  Set date specifier accordint to strftime.

Writing data

Customize how data is output.

• -o, --out = filename

  Write output to specified output file instead of STDOUT.

• -t, --title = string

  Use specific Gnuplot title.

• --ylabel = value

  Use specific Gnuplot label for ordinate axis (default: undef).

• --xformat = value

  Use specific Gnuplot label for ordinate tics (default: undef).

• --yformat = value

  Uses specific Gnuplot label for ordinate tics (default: undef).

• --yrange = value

  Use specific Gnuplot range for ordinate axis (default: undef).

• -c, --color = colorspec

  Use specific Gnuplot color.

• -r, --rate = ratespec

  Show first derivative of ordinate values with respect to ratespec. Available options are: year, month, week, day, hour, min, sec. Alternatively, a custom period can be specified in seconds.

• -s, --scale = num

  Scale ordinate values by factor num (default: 1).

• --term = value

  Use sepecific Gnuplot terminal and option (default: undef).

• -g, --gnuplot [= command ]

  Run gnuplot on output and raise X window. Set terminal to qt. Submitting the command is optional. If no command is defined, the system will try to auto-detect the location of gnuplot.

Splitting data

Customize how data is split.

• -p, --period = string

  Split data with respect to periods into datasets. Avaliable options are year, month, week, day, hour (default: year).

• -m, --max = num

  Limit output to latest num datasets. Set to zero to include all available datasets (default: 0).

• --reset

  Reset ordinate values to zero at the start of each dataset.

Requirements

• Math::Derivative - Numeric 1st and 2nd order differentiation
• Math::Spline - Cubic Spline Interpolation of data
• Spreadsheet::Read::Simple - Simple parsing of spreadsheets
• Time::Piece - Object Oriented time objects
• Time::Seconds - API to convert seconds to other data values

Installation

Clone the remote repository and change into the local repository:

$ git clone https://github.com/mboljen/usageinfo-gnuplot
$ cd usageinfo-gnuplot

Use the following command to install this software:

$ make
$ make install

The default PREFIX is set to /usr/local. In order to successfully complete the installation, you need to have write permissions for the installation location.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT