txdrecycle - Rearrange lines (records) in files in accordance to changing the viewport along a cyclic coordinate.
This is experimental work, so no usage example yet. But one hint: I designed this one with moving the viewport of gnuplot plots of cyclic data. It assumest sorted data along the coordinate (ascending or descending). To make it work with 3D plots, it processes blocks of data (separated by blank line) as independent "scans" (for gnuplot pm3d mode, for example).
These are the general rules for specifying parameters to this program:
txdrecycle -s -xyz -s=value --long --long=value [--] [files/stuff]
You mention the parameters/switches you want to change in any order or even multiple times (they are processed in the oder given, later operations overriding/extending earlier settings. An only mentioned short/long name (no "=value") means setting to 1, which is true in the logical sense. Also, prepending + instead of the usual - negates this, setting the value to 0 (false). Specifying "-s" and "--long" is the same as "-s=1" and "--long=1", while "+s" and "++long" is the sames as "-s=0" and "--long=0".
There are also different operators than just "=" available, notably ".=", "+=", "-=", "*=" and "/=" for concatenation / appending array/hash elements and scalar arithmetic operations on the value. Arrays are appended to via "array.=element", hash elements are set via "hash.=name=value". You can also set more array/hash elements by specifying a separator after the long parameter line like this for comma separation: --array/,/=1,2,3 --hash/,/=name=val,name2=val2
The available parameters are these, default values (in Perl-compatible syntax) at the time of generating this document following the long/short names:
0
ignore whitespace at beginning and end of line (disables strict mode) (from Text::NumericData)
1
the column to use as coordiante
undef
comment character (if not set, deduce from data or use #) (from Text::NumericData)
'[#%]*[^\\S\\015\\012]*'
regex for matching comments (from Text::NumericData)
[]
Which configfile(s) to use (overriding automatic search in likely paths); special: just -I or --config causes printing a current config file to STDOUT
treat empty lines as empty data sets, preserving them in output (from Text::NumericData)
fill value for undefined data (from Text::NumericData)
show the help message; 1: normal help, >1: more help; "par": help for paramter "par" only
Additional fun with negative values, optionally followed by comma-separated list of parameter names: -1: list par names, -2: list one line per name, -3: -2 without builtins, -10: dump values (Perl style), -11: dump values (lines), -100: print POD.
line ending to use: (DOS, MAC, UNIX or be explicit if you can, taken from data if undefined, finally resorting to UNIX) (from Text::NumericData)
printf formats to use (if there is no "%" present at all, one will be prepended) (from Text::NumericData)
'[\\+\\-]?\\d*\\.?\\d*[eE]?\\+?\\-?\\d*'
regex for matching numbers (from Text::NumericData)
use this separator for output (leave undefined to use input separator, fallback to TAB) (from Text::NumericData)
quote titles (from Text::NumericData)
quote character to use (derived from input or ") (from Text::NumericData)
use this separator for input (otherwise deduce from data; TAB is another way to say "tabulator", fallback is ) (from Text::NumericData)
'0.25'
shift the viewport by that value (nearest existing data point), direction is subject to misunderstandings
strictly split data lines at configured separator (otherwise more fuzzy logic is involved) (from Text::NumericData)
allow text as data (not first column) (from Text::NumericData)
print out the program version
Thomas Orgis <thomas@orgis.org>
Copyright (c) 2005-2016 Thomas Orgis, Free Software licensed under the same terms as Perl 5.10
To install Text::NumericData, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Text::NumericData
CPAN shell
perl -MCPAN -e shell install Text::NumericData
For more information on module installation, please visit the detailed CPAN module installation guide.