NAME

       TDEZ3D - Provides a simplified interface to TDPACK for drawing isosurfaces.

SYNOPSIS

       CALL TDEZ3D(NX,NY,NZ,X,Y,Z,U,VALUE,RMULT,THETA,PHI,IST)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_tdez3d (int nx, int ny, int nz, float *x, float *y,
                      float *z, float *u, float value, float rmult,
                      float theta, float phi, int ist)

DESCRIPTION

       The arguments of TDEZ3D are as follows:

       NX      (an input constant or variable of type INTEGER) - The size of the input array X below.

       NY      (an input constant or variable of type INTEGER) - The size of the input array Y below.

       NZ      (an input constant or variable of type INTEGER) - The size of the input array Z below.

       X       (an input array variable of type REAL) - A 1-dimensional array specifying X-coordinate values.

       Y       (an input array variable of type REAL) - A 1-dimensional array specifying Y-coordinate values.

       Z       (an input array variable of type REAL) - A 1-dimensional array specifying Z-coordinate values.

       U       (an  input  array  variable of type REAL) - An array NX by NY by NZ containing functional values;
               Z(I,J,K) is a functional value at coordiante (X(I),Y(J),Z(K)) for I=1,NX, J=1,NY, and K=1,NZ.

       VALUE   (an input array variable of type REAL) - An isovalue.

       RMULT   (an input constant or variable of type REAL) - A multiplier of the diagonal length  (DL)  of  the
               box  defined  by  the  limits  of  the  X, Y, and Z arrays.  Together with THETA and PHI (defined
               below), RMULT is used to determine the eye position (see USAGE).

       THETA   (an input constant or variable of type REAL) - An angle (in degrees) in  the  XY  plane  measured
               positive counter-clockwise from the X axis.  Together with RMULT (defined above) and PHI (defined
               below), THETA is used to determine the eye position (see USAGE).

       PHI     (an input constant or variable of type REAL) - An angle (in degrees) measured from the positive Z
               axis  toward  the  XY  plane.   Together  with  RMULT  and  THETA (defined above), PHI is used to
               determine the eye position (see USAGE).

       IST     (an input constant or variable of type INTEGER) - A style index defining the colors used to shade
               the isosurface as per:

               1  -  wire frame
               2  -  gray shades underneath; gray shades on top.
               3  -  gray shades underneath; red shades on top.
               4  -  gray shades underneath; green shades on top.
               5  -  gray shades underneath; blue shades on top.
               6  -  gray shades underneath; cyan shades on top.
               7  -  gray shades underneath; magenta shades on top.
               8  -  gray shades underneath; yellow shades on top.

               IST is positive, then black is used for the background or and white for the foreground color;  if
               IST  is  negative  of any of the above values, then white used for the background color and black
               for the eground color.

               If the value for IST falls outside the legal range, it is defaulted to 6.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       The coordinate (RMULT*DL,THETA,PHI) is the spherical coordinate for the eye position.  If RMULT = THETA =
       PHI = 0., a default eye position ( 2.5,-55.,70.) is chosen.  The point looked at is calculated to be  the
       center of the box defined by the limits of the X, Y, and Z arrays.

       TDEZ3D does not call FRAME.

       If  the  image  is too small, decrease the size of RMULT; if the image is too large, increase the size of
       RMULT.

       When TDEZ3D is called, a color table is  defined  for  all  open  workstations  that  implements  IST  as
       described  above.   *This  color  table will supersede any color table that has been previously defined.*
       The color table that is defined is:

             Color
             index   Colors
           -------   ----------------------------------------------------
                 0   black if IST is positive; white if IST is negative
                 1   white if IST is positive; black if IST is negative
                 2   red
                 3   green
                 4   blue
                 5   cyan
                 6   magenta
                 7   yellow
             8- 37   grayscale from white to black.
            38- 67   shades of gray
            68- 97   shades of red
            98-127   shades of green
           128-157   shades of blue
           158-187   shades of cyan
           188-217   shades of magenta
           218-247   shades of yellow

ACCESS

       To use TDEZ3D or c_tdez3d, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably  in
       that order.

SEE ALSO

       Online:  tdclrs,  tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls,
       tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa,  tdprpi,  tdprpt,  tdsetr,
       tdsort, tdstri, tdstrs, tdez2d

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                                June 1998                                     TDEZ3D(3NCARG)