Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 2 days 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 (5 months ago)
- Last Synced: 2024-06-23T02:02:15.397Z (5 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/)