INTCHK Version 3.9

Description:

   This program is used to check interpolation stencil quality using grid
   coordinates from the grid file and stencils/interpolation coefficients
   from the INTOUT or XINTOUT files. The program also writes out statistics for

   1. Histogram for distance between interpolated fringe point and fringe point.
      An output data file is readable by OVERGRID for displaying fringe points
      within a specified range of distance values. Max distance and locations
      are written to a file called intchk.maxerr.

   2. Fringe/interpolation stencil compatibility using a cell volume ratio measure.
      An output data file is readable by OVERGRID for displaying fringe points
      within a specified range of donor cell size compatibilty values.

   3. Donor stencil quality.
      An output data file is readable by OVERGRID for displaying fringe points
      within a specified range of donor stencil quality.

   Output includes average, min, max, and histogram data.

   The grid file is assumed to be called x.save. Three interpolation stencil data
   file formats are accepted:
   (i) Old INTOUT format generated by a version of OVERFLOW that is earlier than 2.0y.
   (ii) XINTOUT format
   (iii) New INTOUT format generated by OVERFLOW version 2.0y or later.

Usage:

     intchk
or
     intchk < intchk.i > intchk.o
or
intchk -eps epsval < intchk.i > intchk.o
or
intchk -i GFILE -dfile DPIfile -cfile COMPfile -sqfile SQFILE -inttype IType -nf NFRINGE -ffr IFFR -qsten QSTENCIL -eps epsval -tol TOL -v

The optional parameters are as follows:
     GFILE name of grid file
     DPIFILE name of output file containing fringe point distances.
     CFILE name of output file containing compatibility info.
     SQFILE name of output file containing stencil quality info.
     IType Type of INTOUT/XINTOUT file.
     NFRINGE Number of fringe layes.
     IFFR 1 to filter fringe points, 0 for no filter.
     QSTENCIL 1 to interrogate fringe point stecil, 0 not to.
     epsval controls the reporting of donor stencils whose interpolation coefficients lie outside of [ -EPSVAL, 1.0+EPSVAL ]
     TOL tolerance.

Sample Input File:

2, 1.0         ITYPE(1/2/3), TOL
2              NFRINGE
0              IFFR(0/1)
distfile
compatfile
stenqualfile
0              QSTENCIL(0/1)

where
ITYPE        = interpolation stencil data format (1=old INTOUT, 2=XINTOUT, 3=new INTOUT)
TOL          = report fringe point location if distance between fringe point and
               interpolated fringe point is greater than TOL
NFRINGE      = number of fringe layers
IFFR         = 0   do not apply fringe layer filtering (OVERFLOW-DCF and C3P)
               1   apply fringe layer filtering (PEGASUS5)
distfile     = fringe point and interpolated fringe point distance data filename (output)
compatfile   = cell volume compatibility ratio data filename (output)
stenqualfile = donor stencil quality data filename (output)
QSTENCIL     = 0   do not query individual fringe point donor stencil
               1   query individual fringe point stencil