Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mboljen/usageinfo-gnuplot

Convert time-dependent tabular 2D data to executable gnuplot scripts
https://github.com/mboljen/usageinfo-gnuplot

gnuplot-script logfile-parser monitoring perl

Last synced: about 1 month ago
JSON representation

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

Host: GitHub
URL: https://github.com/mboljen/usageinfo-gnuplot
Owner: mboljen
License: mit
Created: 2023-10-30T08:39:13.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-06-22T18:59:18.000Z (6 months ago)
Last Synced: 2024-06-23T02:02:15.397Z (6 months ago)
Topics: gnuplot-script, logfile-parser, monitoring, perl
Language: Perl
Homepage:
Size: 22.5 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: COPYING

Awesome Lists containing this project

README

# usageinfo-gnuplot

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

## Synopsis

```console
$ 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](https://metacpan.org/pod/Math::Derivative)
+ [Math::Spline - Cubic Spline Interpolation of data](https://metacpan.org/pod/Math::Spline)
+ [Spreadsheet::Read::Simple - Simple parsing of spreadsheets](https://github.com/mboljen/spreadsheet-read-simple-perl)
+ [Time::Piece - Object Oriented time objects](https://metacpan.org/pod/Time::Piece)
+ [Time::Seconds - API to convert seconds to other data values](https://metacpan.org/pod/Time::Seconds)

## Installation

Clone the remote repository and change into the local repository:

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

Use the following command to install this software:

```console
$ 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](https://choosealicense.com/licenses/mit/)