ncl_tdez3d(3)

1TDEZ3D(3NCARG)                   NCAR GRAPHICS                  TDEZ3D(3NCARG)
2
3
4

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_tdez3d (int nx, int ny, int nz, float *x, float *y,
16                      float *z, float *u, float value, float rmult,
17                      float theta, float phi, int ist)
18

DESCRIPTION

20       The arguments of TDEZ3D are as follows:
21
22       NX      (an input constant or variable of type INTEGER) - The size of
23               the input array X below.
24
25       NY      (an input constant or variable of type INTEGER) - The size of
26               the input array Y below.
27
28       NZ      (an input constant or variable of type INTEGER) - The size of
29               the input array Z below.
30
31       X       (an input array variable of type REAL) - A 1-dimensional array
32               specifying X-coordinate values.
33
34       Y       (an input array variable of type REAL) - A 1-dimensional array
35               specifying Y-coordinate values.
36
37       Z       (an input array variable of type REAL) - A 1-dimensional array
38               specifying Z-coordinate values.
39
40       U       (an input array variable of type REAL) - An array NX by NY by
41               NZ containing functional values; Z(I,J,K) is a functional value
42               at coordiante (X(I),Y(J),Z(K)) for I=1,NX, J=1,NY, and K=1,NZ.
43
44       VALUE   (an input array variable of type REAL) - An isovalue.
45
46       RMULT   (an input constant or variable of type REAL) - A multiplier of
47               the diagonal length (DL) of the box defined by the limits of
48               the X, Y, and Z arrays.  Together with THETA and PHI (defined
49               below), RMULT is used to determine the eye position (see
50               USAGE).
51
52       THETA   (an input constant or variable of type REAL) - An angle (in
53               degrees) in the XY plane measured positive counter-clockwise
54               from the X axis.  Together with RMULT (defined above) and PHI
55               (defined below), THETA is used to determine the eye position
56               (see USAGE).
57
58       PHI     (an input constant or variable of type REAL) - An angle (in
59               degrees) measured from the positive Z axis toward the XY plane.
60               Together with RMULT and THETA (defined above), PHI is used to
61               determine the eye position (see USAGE).
62
63       IST     (an input constant or variable of type INTEGER) - A style index
64               defining the colors used to shade the isosurface as per:
65
66               1  -  wire frame
67               2  -  gray shades underneath; gray shades on top.
68               3  -  gray shades underneath; red shades on top.
69               4  -  gray shades underneath; green shades on top.
70               5  -  gray shades underneath; blue shades on top.
71               6  -  gray shades underneath; cyan shades on top.
72               7  -  gray shades underneath; magenta shades on top.
73               8  -  gray shades underneath; yellow shades on top.
74
75
76               IST is positive, then black is used for the background or and
77               white for the foreground color; if IST is negative of any of
78               the above values, then white used for the background color and
79               black for the eground color.
80
81               If the value for IST falls outside the legal range, it is
82               defaulted to 6.
83

C-BINDING DESCRIPTION

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

USAGE

89       The coordinate (RMULT*DL,THETA,PHI) is the spherical coordinate for the
90       eye position.  If RMULT = THETA = PHI = 0., a default eye position (
91       2.5,-55.,70.) is chosen.  The point looked at is calculated to be the
92       center of the box defined by the limits of the X, Y, and Z arrays.
93
94       TDEZ3D does not call FRAME.
95
96       If the image is too small, decrease the size of RMULT; if the image is
97       too large, increase the size of RMULT.
98
99       When TDEZ3D is called, a color table is defined for all open
100       workstations that implements IST as described above.  *This color table
101       will supersede any color table that has been previously defined.*  The
102       color table that is defined is:
103
104
105             Color
106             index   Colors
107           -------   ----------------------------------------------------
108                 0   black if IST is positive; white if IST is negative
109                 1   white if IST is positive; black if IST is negative
110                 2   red
111                 3   green
112                 4   blue
113                 5   cyan
114                 6   magenta
115                 7   yellow
116             8- 37   grayscale from white to black.
117            38- 67   shades of gray
118            68- 97   shades of red
119            98-127   shades of green
120           128-157   shades of blue
121           158-187   shades of cyan
122           188-217   shades of magenta
123           218-247   shades of yellow
124
125

ACCESS

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

COPYRIGHT

137       Copyright (C) 1987-2009
138       University Corporation for Atmospheric Research
139       The use of this Software is governed by a License Agreement.
140
141
142
143UNIX                               June 1998                    TDEZ3D(3NCARG)