# START of the fortsub.rc.  Integer parameter follows.
numIntParm	9
numDblParm	6
xPnts		60
yPnts		60
axisSys		0
numChunk	60
isStack		0
nHotArray	80
nArray1		50
# The following are double precision parameters.
xMax		1.0
yMax		360.0
zMax		1.0
xMin		0.0
yMin		0.0
zMin		-1.0
# The following are configure option parameters.
nColors		32
hueColor	0
chromColor	40
minColorV	30
maxColorV	85
# This is the end of fortsub.rc data.


************This file is the setup file the surfing program************
		

			0. FEATURES 

SURF is an Xlib based program to debug, monitor, and control large-
scale numerical simulations, written in either fortran or C.  3D results
are displayed on a 2D coordinate system while color shades are used to
display the third coordinate (z).  At present, only cylindrical and Cartesian
systems are supported.  Up to 22 integer and 22 double precision parameters
to be passed to and from your subroutine can be set via a file during startup
as well as being changed interactively as the simulation progresses.  One
scalar variable and upto two arrays of any sizes can be monitored during
the progress of simulation.

SURF is written using Xlib to run with minimum system resource demand
and thus should provide an effective means for large-scale simulation:

	* 3-dimensional real-time display of results;
	* real-time interactive control up to 22 integer and 22 double
	  precision parameters;
	* real-time display of one scalar variable (hot-value);
	* real-time display of CPU time usage at each step of simulation.
	* up to two arbitrary-size arrays of double precision variables
	  displayed at each simulation step and are compared with the initial
	  value;
	* values of z along the two pointer-selected axes can be displayed
	  at any step of simulation.
	* on-line help pop-up window;
	* pop-up window display showing present set up of the parameters;
	* customizable color.


				1.  INSTALLATION

After unpacked the surf-1.02.tar.gz with

	gzip -dc surf-1.02.tar.gz |tar xvf -

it will create a directory ./surf. 
	* If you are using an HP9000 runing HPUX, copy Makefile.HPUX to Makefile,
	* If you are using an IBM RS6k, copy Makefile.AIX to Makefile,
	* If you are running Linux, the copy Makefile.LINUX to Makefile.
Now, you should type make to build the files.  It will generate an executable
surf to start a demo session.  The demo program is produced from a fortransub
written in C.  The program surf can only be generated where inter-language
(between C and Fortran) function call is supported.
	
The fortsub.rc program is provided for demonstration purpose.  You can let
the program read the README file at the command line to start a session in
cylindrical system.  As always, you can read these files interactively after
the program starts.

Once you are familiar with the program, you can provide your own subroutine
fortransub to do some real job.  This can be done manually by linking your
object codes with surf.o and draw.o.

	f77 -o surf surf.o draw.o mycode.o -lm -lX11
Or, you can slightly modify the Makefile and then type "make surf".

