Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

graphics(1G)

gps(4)



stat(1G)                                                 stat(1G)



NAME
     abs, af, bar, bucket, ceil, cor, cusum, exp, floor, gamma,
     gas, hilo, hist, label, list, log, lreg, mean, mod, pair,
     pie, plot, point, power, prime, prod, qsort, rand, rank,
     root, round, siline, sin, subset, title, total, var - sta-
     tistical network usef l with graphical commands

SYNOPSIS
     node-name [options] [files]

DESCRIPTION
     stat is a collection of command level functions (nodes) that
     can be interconnected using sh(1) to form a statistical net-
     work.  The nodes reside in /usr/bin/graf (see graphics(1G)).
     Data is passed through the network as sequences of numbers
     (vectors), where a number is of the form:

          [sign](digits)(.digits)[e[sign]digits]

     evaluated in the usual way.  Brackets and parentheses sur-
     round fields.  All fields are optional, but at least one of
     the fields surrounded by parentheses must be present.  Any
     character input to a node that is not part of a number is
     taken as a delimiter.

     stat nodes are divided into four classes.

          Transformers,       which map input vector elements
                              into output vector elements;

          Summarizers,        which calculate statistics of a
                              vector;

          Translators,        which convert among formats; and

          Generators,         which are sources of definable vec-
                              tors.

     Below is a list of synopses for stat nodes.  Most nodes
     accept options indicated by a leading minus (-).  In gen-
     eral, an option is specified by a character followed by a
     value, such as c5.  This is interpreted as c := 5 (c is
     assigned 5).  The following keys are used to designate the
     expected type of the value:

          c       characters,

          i       integer,

          f       floating point or integer,

          file    file name, and



Page 1                              CX/UX User's Reference Manual





stat(1G)                                                 stat(1G)



          string  string of characters, surrounded by quotes to
                  include a Shell argument delimiter.

     Options without keys are flags.  All nodes except generators
     accept files as input, hence it is not indicated in the
     synopses.

     Transformers:

          abs       [-ci] - absolute value
                    columns     (similarly for -c options that
                    follow)

          af        [-ci t v] - arithmetic function
                    titled output, verbose

          ceil      [-ci] - round up to next integer

          cusum     [-ci] - cumulative sum

          exp       [-ci] - exponential

          floor     [-ci] - round down to next integer

          gamma     [-ci] - gamma

          list      [-ci dstring] - list vector elements
                    delimiter(s)

          log       [-ci bf] - logarithm
                    base

          mod       [-ci mf] - modulus
                    modulus

          pair      [-ci Ffile xi] - pair elements
                    File containing base vector, x group size

          power     [-ci pf] - raise to a power
                    power

          root      [-ci rf] - take a root
                    root

          round     [-cipisi] - round to nearest integer, .5
                    rounds to 1
                    places after decimal point,
                    significant digits

          siline    [-ciifnisf] - generate a line given slope and
                    intercept
                    intercept, number of positive integers, slope



Page 2                              CX/UX User's Reference Manual





stat(1G)                                                 stat(1G)



          sin       [-ci] - sine

          subset    [-af bf ci Ffile ii lf nl np pf si ti] - gen-
                    erate a subset
                    above, below, File with master vector, inter-
                    val, leave, master contains element numbers
                    to leave, master contains element numbers to
                    pick, pick, start, terminate

     Summarizers:

          bucket     [-ai ci Ffile hf ii lf ni] - break into
                    buckets
                    average size, File containing bucket boun-
                    daries, high, interval, low, number
                    Input data should be sorted

          cor       [-Ffile] - correlation coefficient
                    File containing base vector

          hilo      [- h l o ox oy]- find high and low values
                    high only, low only, option form, option form
                    with x prepended, option form with y
                    prepended

          lreg      [-Ffile i o s] - linear regression
                    File containing base vector, intercept only,
                    option form for siline, slope only

          mean      [-ff ni pf] - (trimmed) arithmetic mean
                    fraction, number, percent

          point     [-ff ni pf s] - point from empirical cumula-
                    tive density function
                    fraction, number, percent, sorted input

          prod      - internal product

          qsort     [-ci] - quick sort

          rank      - vector rank

          total     - sum total

          var       - variance










Page 3                              CX/UX User's Reference Manual





stat(1G)                                                 stat(1G)



     Translators:

          bar       [-a b f g riwixf xa yfya ylf yhf ] - build a
                    bar chart
                    suppress axes, bold, suppress frame, suppress
                    grid, region, width in percent, x origin,
                    suppress x-axis label, y origin, suppress y-
                    axis label, y-axis lower bound, y-axis high
                    bound
                    Data is rounded off to integers.

          hist      [-a b f g rixf xa yfya ylf yhf ] - build a
                    histogram
                    suppress axes, bold, suppress frame, suppress
                    grid, region, x origin, suppress x-axis
                    label, y origin, suppress y-axis label, y-
                    axis lower bound, y-axis high bound

          label     [-b c Ffile h p ri x xu y yr] - label the
                    axis of a GPS file
                    bar chart input, retain case, label File,
                    histogram input, plot input, rotation, x-
                    axis, upper x-axis, y-axis, right y-axis

          pie       [-b o p pni ppi ri v xi yi] - build a pie
                    chart
                    bold, values outside pie, value as percen-
                    tage(:=100), value as percentage(:=i), draw
                    percent of pie, region, no values, x origin,
                    y origin
                    Unlike other nodes, input is lines of the
                    form
                         [< i e f cc >] value [label]
                         ignore (do not draw) slice, explode
                         slice, fill slice, color slice c=(
                         black, red, green, blue)

          plot      [-a b cstringd f Ffileg m ri xfxa xifxhf
                    xlfxnixt yfya yifyhf ylfyniyt] - plot a graph
                    suppress axes, bold, plotting characters,
                    disconnected, suppress frame, File containing
                    x vector, suppress grid, mark points, region,
                    x origin, suppress x-axis label, x interval,
                    x high bound, x low bound, number of ticks on
                    x-axis, suppress x-axis title, y origin,
                    suppress y-axis label, y interval, y high
                    bound, y low bound, number of ticks on y-
                    axis, suppress y-axis title

          title     [-b c lstringvstringustring ] - title a vec-
                    tor or a GPS
                    title bold, retain case, lower title, upper



Page 4                              CX/UX User's Reference Manual





stat(1G)                                                 stat(1G)



                    title, vector title

     Generators:

          gas       [-ci if ni sf tf] - generate additive
                    sequence
                    interval, number, start, terminate

          prime     [-ci hi li ni] - generate prime numbers
                    high, low, number

          rand      [-ci hf lf mf ni si] - generate random
                    sequence
                    high, low, multiplier, number, seed

RESTRICTIONS
     Some nodes have a limit on the size of the input vector.

SEE ALSO
     graphics(1G).
     gps(4) in the CX/UX Programmer's Reference Manual.


































Page 5                              CX/UX User's Reference Manual



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026