separate project repository

[barcat.git] / graph

diff --git a/graph b/graph
index 6da39b9c1af485b7688f672cdc24bb2e3471cb03..501ac3c24f4ce3a86585c785537320ce3eb532a2 100755 (executable)
--- a/graph
+++ b/graph
@@ -5,7 +5,7 @@ use utf8;
 use List::Util qw( min max sum );
 use open qw( :std :utf8 );
 
-our $VERSION = '1.00';
+our $VERSION = '1.01';
 
 use Getopt::Long '2.33', qw( :config gnu_getopt );
 sub podexit { require Pod::Usage; Pod::Usage::pod2usage(-exitval => 0, @_) }
@@ -24,23 +24,26 @@ my @lines = readline or exit;
 chomp for @lines;
 my @values = map { s/^\h* ( -? [0-9]* (?:\.[0-9]+)? )//x and $1 } @lines;
 my @order  = sort { $b <=> $a } grep { length } @values;
-if ($opt{trim}) {
+if (defined $opt{trim}) {
        my $trimpos = abs $opt{trim};
-       length > 1 + $trimpos and substr($_, $trimpos) = '…' for @lines;
+       $trimpos <= 1 ? ($_ = substr($_, 0, 1)) :
+       (length > $trimpos and substr($_, $trimpos - 1) = '…') for @lines;
 }
 
 my $maxval = $order[0];
 my $minval = min $order[-1], 0;
 my $lenval = max map { length } @order;
-my $len    = defined $opt{trim} && $opt{trim} < 0 ? -$opt{trim} + 2 :
+my $len    = defined $opt{trim} && $opt{trim} <= 0 ? -$opt{trim} + 1 :
        1 + max map { length } @lines;  # left padding
 my $size   = ($maxval - $minval) &&
        ($opt{width} - $lenval - $len) / ($maxval - $minval);  # bar multiplication
 
 my @barmark;
-if ($opt{markers} // 1) {
+if ($opt{markers} // 1 and $size > 0) {
        sub orderpos { (($order[$_[0]] + $order[$_[0] + .5]) / 2 - $minval) * $size }
        $barmark[ (sum(@order) / @order - $minval) * $size ] = '=';  # average
+       $barmark[ orderpos($#order * .31731) ] = '>';
+       $barmark[ orderpos($#order * .68269) ] = '<';
        $barmark[ orderpos($#order / 2) ] = '+';  # mean
        $barmark[ -$minval * $size ] = '|' if $minval < 0;  # zero
        defined and $opt{color} and $_ = "\e[36m$_\e[0m" for @barmark;
@@ -58,7 +61,7 @@ for my $nr (0 .. $#lines) {
                print "\e[0m" if $color;
        }
        printf '%-*s', $len, $lines[$nr];
-       print $barmark[$_] // '-' for 1 .. (($val || 0) - $minval) * $size;
+       print $barmark[$_] // '-' for 1 .. $size && (($val || 0) - $minval) * $size;
        say '';
 }
 
@@ -88,7 +91,8 @@ Disable colored output of values and bar markers.
 
 Trim line contents (between number and bars)
 to a maximum number of characters.
-The exceeding part is replaced by an abbreviation sign.
+The exceeding part is replaced by an abbreviation sign,
+unless C<--length=0>.
 
 Prepend a dash (i.e. make negative) to enforce padding
 regardless of encountered contents.
@@ -110,9 +114,20 @@ the sum of all values divided by the number of counted lines.
 
 =item B<+>
 
-Median:
+Mean, median:
 the middle value or average between middle values.
 
+=item B<<>
+
+Standard deviation left of the mean.
+Only 16% of all values are lower.
+
+=item B<< > >>
+
+Standard deviation right of the mean.
+The part between B<< <--> >> encompass all I<normal> results,
+or 68% of all entries.
+
 =back
 
 =item -w, --width=<columns>