INTRO(1G)               COMMAND REFERENCE               INTRO(1G)



NAME
     intro - introduction to the UTek Graphics Tools

DESCRIPTION
     The commands in section 1G comprise the UTek Graphics Tools.
     These include commands to generate and process numbers,
     commands to turn numbers into graphics, and commands to
     display and edit graphics on display terminals.

     The Graphics Tools commands produce the best results when
     used with a display terminal such as a Tektronix 4010 Series
     or 4100 Series terminal, or a graphics terminal emulator
     window on a 6000 Family display.  However, graphic
     information can be stored in a file.  You can create
     graphics files on any terminal for later display on a
     graphical device.

     To access the UTek Graphics Tools commands, type graphics.
     The shell variable $PATH is altered to include the Graphics
     Tools commands, the shell primary prompt is changed to ^,
     and a new shell is started up.  This is always a Bourne
     shell (sh(1sh)), even if your login shell is the C-shell
     (csh(1csh)).  To leave the graphics shell, type <CTRL-D> (or
     your eof character, if different: see stty(1)).  To log off
     from within the graphics shell, type quit.  (quit only works
     if your login shell is sh(1sh).)

     All of the Graphics Tools commands are of the same general
     form:

          command [ -option(s) ] [ file(s) ]

     If a command accepts multiple options, they can be specified
     in three ways:

          -o[value] -o[value] ...
          -o[value],o[value] ...
          -o[value]o[value] ...

     where o represents the one-letter or two-letter option name,
     and [value] represents the option's value.  Some options
     take numeric values, some take string values, and some take
     no value.  In a string value, any spaces or commas must be
     escaped (preceded by a backslash).

     Generally, if the file argument is omitted the command reads
     from the standard input.  A single minus sign (-) used as a
     filename also refers to the standard input.  The type of
     file that can be used depends on the command.

     Most of the numerical commands in the UTek Graphics Tools
     accept vectors as input and produce vectors as output.  A



Printed 4/6/89                                                  1

INTRO(1G)               COMMAND REFERENCE               INTRO(1G)



     vector is a text file containing numbers separated by non-
     numbers.  Numbers are constructed in the usual way:

          [sign]digits[.digits][e[sign]digits]

     or

          [sign][digits].digits[e[sign]digits]

     where sign is + or -, digits is any series of one or more
     digits (0 through 9), and optional groups are surrounded by
     brackets.  For example, the following are all legal numbers:

          15     -.239     1.77e-26     +63.2e+3

     Because anything that is not a number is a delimiter, the
     vector:

          1 melon, 2 cinnamon sticks, 3/4 cup milk, and 5 loons

     is equivalent to the vector:

          1 2 3 4 5

     Vectors are created by several of the UTek Graphics Tools,
     including gas(1g) (generate additive sequence) and rand(1g)
     (generate random numbers).  Vectors can also be created by a
     text editor or any other UTek command that produces text
     files.

     Some Graphics Tools commands, such as plot(1g) and hist(1g),
     accept vectors and produce Graphical Primitive Strings, or
     GPS.  A GPS is a text string that describes a picture.  The
     format of a GPS is described in gps(5g).

     You can display a GPS on a Tektronix terminal with td(1g),
     or on a Hewlett-Packard plotter with hpd(1g).  You can also
     edit or create a GPS with the graphical editor ged(1g) and
     get a human-readable listing of a GPS with gd(1g).

     All of the UTek Graphics Tools, with the exception of
     graphics(1g), reside in /bin/graf.  If you want to use
     Graphics Tools commands in a shell script, the script should
     begin with the following lines:

          #!/bin/sh
          PATH="/bin/graf:$PATH"
          export PATH

EXAMPLES
     The following example creates a vector of 100 random numbers
     with rand(1g), sorts it into ascending order with qsort(1g),



Printed 4/6/89                                                  2

INTRO(1G)               COMMAND REFERENCE               INTRO(1G)



     and counts the number of elements in a series of intervals
     with bucket(1g).  bucket produces a vector describing the
     number of elements in each interval, and hist(1g) turns that
     vector into a GPS describing a histogram.  Finally, td(1g)
     displays the GPS on a Tektronix terminal.

          rand -n100 | qsort | bucket | hist | td


FILES
     /bin/graf/*      Executable commands

     /usr/lib/graf/whatis.d/*
                      Brief descriptions of each command for
                      whatis(1g)

     /usr/lib/graf/ttoc.d/*
                      Ed(1) scripts for ttoc(1g)

SEE ALSO
     abs(1g), af(1g), bar(1g), bel(1g), bucket(1g), ceil(1g),
     cor(1g), cusum(1g), cvrtopt(1g), dtoc(1g), erase(1g),
     exp(1g), floor(1g), gamma(1g), gas(1g), gd(1g), ged(1g),
     graphics(1g), gtop(1g), hardcopy(1g), hilo(1g), hist(1g),
     hpd(1g), label(1g), list(1g), log(1g), lreg(1g), mean(1g),
     mod(1g), pair(1g), pd(1g), pie(1g), plot(1g), point(1g),
     power(1g), prime(1g), prod(1g), ptog(1g), qsort(1g),
     quit(1g), rand(1g), rank(1g), remcom(1g), root(1g),
     round(1g), siline(1g), sin(1g), subset(1g), td(1g),
     tekset(1g), title(1g), total(1g), ttoc(1g), var(1g),
     vtoc(1g), whatis(1g), yoo(1g), and gps(5g).

REFERENCES
     UTek Graphics Tools in UTek Tools, Volume 2.





















Printed 4/6/89                                                  3

%%index%%
na:288,99;
de:387,3017;3764,2053;
ex:5817,259;6436,453;
fi:6889,420;
se:7309,1451;
re:8760,245;
%%index%%000000000129