aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--README21
1 files changed, 15 insertions, 6 deletions
diff --git a/README b/README
index c7a8649..eea8c25 100644
--- a/README
+++ b/README
@@ -2,13 +2,25 @@ NAME
median - Calculate the median values for a set of groups
SYNOPSIS
- median < INPUT
+ median
DESCRIPTION
median takes the first blank space-separated column values
and the remainder as keys. It will then print the median for
- each key. As a side effect median will print the result
- sorted by the keys.
+ each key. Lines with the same key form a group.
+
+ median outputs the median value for each key, no order of
+ the output lines are prescribed. No order is prescribed for
+ the input lines.
+
+ Lines without a blank space are parsed as having the empty
+ string as the key, for lines with a blank space, the first
+ blank space is parsed as part of the key.
+
+ For groups with an even number of elements, if the mean of
+ the middle two values are used as the median if all values
+ in the group are numerical, otherwise the lower value is
+ used as the median.
EXAMPLES
$ cat <<EOF | median
@@ -38,6 +50,3 @@ RATIONALE
SEE ALSO
sort(1), expr(1), sets(1)
-
- Full documentation available locally via: info '(median)'
-