txdnorm - normalize data sets
(c) 2005 (Artistic License) by Thomas Orgis <thomas@orgis.org> textdata version x
Usage: pipe | txdnorm [parameters] | pipe
These are the general rules for specifying parameters to this program:
txdnorm -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".
The available parameters are these, default values (in Perl-compatible syntax) at the time of generating this document following the long/short names:
0
instead of overwriting existing column, append a new one (you may want to modify titles afterwards!)
ignore whitespace at beginning and end of line (disables strict mode) (from Text::NumericData)
2
column to normalize, starting at 1
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)
-1
normalize from this (division) - means this value in input becomes the "to" value in output, if < 0, then normalize to maximum found
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)
normalize from the value corresponding to this x value
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)
strictly split data lines at configured separator (otherwise more fuzzy logic is involved) (from Text::NumericData)
1
allow text as data (not first column) (from Text::NumericData)
normalize to this (multiplication)
Give note about error conditions beyond the initial parameter checks (normalizing with zero, etc.).
print out the program version
if > 0: choose from value via given value in this column (the x data) - see pos parameter
Thomas Orgis <thomas@orgis.org>
Copyright (c) 2005-2013 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.