CPIJ.TXT    Documentation for CPIJ and CPSIJ    2002/10/18

CPIJ displays longitude by latitude data and produces color PostScript
files on an IBM Risc 6000 workstation using GKS subroutine calls.
Invocation:  CPIJ [90x60] filex [filey filez]
Resolutions 72x46, 90x60, 120x90, 144x90, 360x180, and 720x360 read
read the appropriate Z file (e.g. Z5X4N) for ocean fraction.

CPSIJ accepts keyboard input (or from a script); and like CPIJ, it
produces color PostScript files.  Invocation is the same as CPIJ.

Input datafile records should have the format: TITLE(80),REAL4(IM,JM)

The user's  .profile  should contain the line:  export cnverr=yes

Color block definition tables should reside in the subdirectory
CPIJCBDT/  or in  /u/cmrun/CPIJCBDT/

File of default presentation parameters:  CPIJ.I  or  /u/cmrun/CPIJ.I

Text file of screen and PostScript colors:  COLORS  or  /u/cmrun/COLORS

Fortran SYSTEM call uses 'lp -d pub6 CPIJ.PS' to print PostScript file.

Additional information resides on CD-ROM in  CPIJ\PCCPIJ.DOC


CPIJ and CPSIJ commands
-----------------------
A    display data for all grid boxes
L    display data for Land grid boxes only
O    display data for Ocean grid boxes only

W    make continental outline or undisplayed grid boxes White
B    make continental outline or undisplayed grid boxes Black
Rn   rotate picture n grid boxes to the left

E    correct Error in previous command
Q    Quit program

X or Xn   display most recent or n-th record of file X
Y or Yn   display most recent or n-th record of file Y
Z or Zn   display most recent or n-th record of file Z

D or Dn   display most recent or n-th difference record
D = ...   calculate Different record, example: D = 2*X1 - Y + 273.16
          X or Y can be replaced by X, Y, Z or D
          If n is absent, display most recent record of file D

NX file n   load New file X and display n-th record
NY file n   load New file Y and display n-th record
NZ file n   load New file Z and display n-th record
            File definition accepts environment variables in .profile
            If n is absent, first record is displayed.

S             show current Scaling parameters
S CENV SDIF   use new Scaling parameters
  CENV = CENter Value on scale to left of plot
  SDIF = DIFference beteen Scale markers on left

C file   use new Color block definition table in [/u/cmrun/]CPIJCBDT/

T        edit current title (" retains current character in CPSIJ)

F        writes Files CPIJ.O of title,data and CPIJ.IF of parameters
         CPIJ.O is a datafile, CPIJ.IF can be appended to CPIJ.I

P  Xn      produce PostScript file CPIJ.PS of record Xn
PP Xn      produce PostScript file CPIJ.PS of record Xn and Print it
P  Xn Ym   produce PostScript file CPIJ.PS of record Xn and Ym
PP Xn Ym   produce PostScript file CPIJ.PS of record Xn,Ym and Print it
           X or Y can be replaced by X, Y, Z or D
           If n or m are absent, use most recently displayed records


Warning: CPIJ has been known to fill an entire workstation disk with
         the file  GKS99.ERLOG  due to errors in GKS software.  The
         file  GKS99.ERLOG  should be deleted.