Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

graphics(1G)

gps(4)



STAT(1G)                 DOMAIN/IX SYS5                  STAT(1G)



NAME
     stat - statistical network useful with graphical commands

USAGE
     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 node-names 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

          string  string of characters, surrounded by quotes to



Printed 12/4/86                                            STAT-1







STAT(1G)                 DOMAIN/IX SYS5                  STAT(1G)



                  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



STAT-2                                            Printed 12/4/86







STAT(1G)                 DOMAIN/IX SYS5                  STAT(1G)



                    intercept, number of positive integers, slope

          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 buck-
                    ets
                    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






Printed 12/4/86                                            STAT-3







STAT(1G)                 DOMAIN/IX SYS5                  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



STAT-4                                            Printed 12/4/86







STAT(1G)                 DOMAIN/IX SYS5                  STAT(1G)



                    vector or a GPS
                    title bold, retain case, lower title, upper
                    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.

RELATED INFORMATION
     graphics(1G).
     gps(4) in the UNIX System Programmer Reference Manual.






























Printed 12/4/86                                            STAT-5





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