                                                                p_create
Chapter 14 Plotting and Reporting Operations

The power of set operations can be experienced with the plotting operations via
a pen file.  This file may be generated by the user with a p_create function
which permits (or prompts for) assignment of pen number(s) to set(s).  With a
multi-pen plotter, a user may utilize colors and/or tip sizes to represent
various sets of information.  Creating a pen file with the p_create command
provides tremendous plotting flexibility.

p_create

    Creates a pen file with assignments by set.

         p_create file argn

    Creates the specified file and writes to that file a 32-digit number.
    Each digit of that number contains a value in the range of 0 - 8.  That
    value represents the pen number assigned to the set number which is defined
    by the position of the digit within the argument (increasing left to right,
    from 0 to 31).  If there are less than 32 digits specified in the argument,
    then sets not shown are assumed to be assigned to pen 0 (no plot).  The
    named pen file is stored in the /u[sr]/ltp/pens directory.
    ___________________________________________________________________________
    Options/arguments:

         file      Name of pen file
         argn      Position dependent pen-to-set assignment
    ___________________________________________________________________________
    Example(s):

    To create a pen file called plot_a with the pen assignments of set4:pen3,
    s7:p2, s8:p4, s9:p8, s10:p1, s17:p7, s28:p3, s31:p4, and all other sets
    assigned to pen0, enter:
     
         p_create plot_a 00003002481000000700000000003004
     
    To create a pen file named plot1b with pen assignments of set2:pen3, s3:p4,
    s5:p2, s6:p2, s7:p2, s8:p1, s10:p6, and all other sets assigned to pen0,
    enter:

         p_create plot1b 00340222106
    ___________________________________________________________________________
    See also:

              config, plot
    ___________________________________________________________________________
