PSCCONTOUR - PostScript Contour plot of a data CUBE		        

 pscubecontour n1= n2= n3= [optional parameters] <binaryfile >postscriptfile	
    or									
 pscubecontour n1= n2= n3= front= side= top= [optional parameters] >postscriptfile

 Data formats supported:						
	1. Entire cube read from stdin (n1*n2*n3 floats) [default format]
	2. Faces read from stdin (n1*n2 floats for front, followed by n1*n3
	   floats for side, and n2*n3 floats for top) [specify faces=1]	
	3. Faces read from separate data files [specify filenames]	

 Required Parameters:							
 n1                     number of samples in 1st (fastest) dimension	
 n2                     number of samples in 2nd dimension		
 n3                     number of samples in 3rd (slowest) dimension	

 Optional Parameters:							
 front                  name of file containing front panel		
 side                   name of file containing side panel		
 top                    name of file containing top panel		
 faces=0                =1 to read faces from stdin (data format 2)	
 d1=1.0                 sampling interval in 1st dimension		
 f1=0.0                 first sample in 1st dimension			
 d2=1.0                 sampling interval in 2nd dimension		
 f2=0.0                 first sample in 2nd dimension			
 d3=1.0                 sampling interval in 3rd dimension		
 f3=0.0                 first sample in 3rd dimension			
 d1s=1.0                factor by which to scale d1 before imaging	
 d2s=1.0                factor by which to scale d2 before imaging	
 d3s=1.0                factor by which to scale d3 before imaging	
 nc=5                   number of contour values			
 dc=(zmax-zmin)/nc      contour interval				
 fc=min+dc              first contour					
 c=fc,fc+dc,...         array of contour values			
 cwidth=1.0,...         array of contour line widths			
 cgray=0.0,...          array of contour grays (0.0=black to 1.0=white)
 ccolor=none,...        array of contour colors; none means use cgray	
 cdash=0.0,...          array of dash spacings (0.0 for solid)		
 labelcf=1              first labeled contour (1,2,3,...)		
 labelcper=1            label every labelcper-th contour		
 nlabelc=nc             number of labeled contours (0 no contour label)
 nplaces=6              number of decimal places in contour label      
 xbox=1.5               offset in inches of left side of axes box	
 ybox=1.5               offset in inches of bottom side of axes box	
 size1=4.0              size in inches of 1st axes (vertical)		
 size2=4.0              size in inches of 2nd axes (horizontal)	
 size3=3.0              size in inches of 3rd axes (projected)		
 angle=45               projection angle of cube in degrees (0<angle<90)
                        (angle between 2nd axis and projected 3rd axis)
 x1end=x1max            value at which axis 1 ends			
 d1num=0.0              numbered tic interval on axis 1 (0.0 for automatic)
 f1num=x1min            first numbered tic on axis 1 (used if d1num not 0.0)
 n1tic=1                number of tics per numbered tic on axis 1	
 grid1=none             grid lines on axis 1 - none, dot, dash, or solid
 label1=                label on axis 1				
 x2beg=x2min            value at which axis 2 begins			
 d2num=0.0              numbered tic interval on axis 2 (0.0 for automatic)
 f2num=x2min            first numbered tic on axis 2 (used if d2num not 0.0)
 n2tic=1                number of tics per numbered tic on axis 2	
 grid2=none             grid lines on axis 2 - none, dot, dash, or solid
 label2=                label on axis 2				
 x3end=x3max            value at which axis 3 ends			
 d3num=0.0              numbered tic interval on axis 3 (0.0 for automatic)
 f3num=x3min            first numbered tic on axis 3 (used if d3num not 0.0)
 n3tic=1                number of tics per numbered tic on axis 3	
 grid3=none             grid lines on axis 3 - none, dot, dash, or solid
 label3=                label on axis 3				
 labelfont=Helvetica    font name for axes labels			
 labelsize=18           font size for axes labels			
 title=                 title of plot					
 titlefont=Helvetica-Bold font name for title				
 titlesize=24           font size for title				
 titlecolor=black       color of title					
 labelcfont=Helvetica-Bold font name for contour labels		
 labelcsize=6           font size of contour labels   			
 labelccolor=black      color of contour labels   			
 axescolor=black        color of axes					
 gridcolor=black        color of grid					

 All color specifications may also be made in X Window style Hex format
 example:   axescolor=#255						

 Note: The values of x1beg=x1min, x2end=x2max and x3beg=x3min cannot   
 be changed.								



 (Original codes pscontour and pscube)

 AUTHOR:  Craig Artley, Colorado School of Mines, 03/12/93
 NOTE:  Original written by Zhiming Li & Dave Hale, CSM, 07/01/90
	  Completely rewritten, the code now bears more similarity to
	  psimage than the previous pscube.  Faces of cube now rendered
	  as three separate images, rather than as a single image.  The
	  output no longer suffers from stretching artifacts, and the
	  code is simpler.  -Craig
 MODIFIED:  Craig Artley, Colorado School of Mines, 12/17/93
 	  Added color options.

 PSCCONTOUR: mashed together from pscube and pscontour 
 to generate 3d contour plots by Claudia Vanelle, Institute of Geophysics,
 University of Hamburg, Germany somewhen in 2000

 PSCUBE was "merged" with PSCONTOUR to create PSCUBECONTOUR 
 by Claudia Vanelle, Applied Geophysics Group Hamburg
 somewhen in 2000