TDEZ3D(3NCARG)

✨ NAME ✨

TDEZ3D — bestie, this is the glow-up shortcut into TDPACK for drawing isosurfaces 💅

(It lives in the NCAR Graphics manual, section 3NCARG, if you were wondering where we are rn 🦋)

---

🎀 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 💜

okay so the arguments of TDEZ3D are, one by one, no skipping, we're doing all of them:

• NX — (an input constant or variable of type INTEGER) the size of the input array X down below 👇
• NY — (an input constant or variable of type INTEGER) the size of the input array Y down below 👇
• NZ — (an input constant or variable of type INTEGER) the size of the input array Z down below 👇
• X — (an input array variable of type REAL) a 1-dimensional array giving the X-coordinate values 📍
• Y — (an input array variable of type REAL) a 1-dimensional array giving the Y-coordinate values 📍
• Z — (an input array variable of type REAL) a 1-dimensional array giving the Z-coordinate values 📍
• U — (an input array variable of type REAL) an array NX by NY by NZ holding the functional values; Z(I,J,K) is a functional value at coordinate (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 what decides 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 that defines the colors used to shade the isosurface, like this:
  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.

If IST is positive, then black is used for the background and white for the foreground color; if IST is the negative of any of the above values, then white is used for the background color and black for the foreground color 🖤🤍

If the value for IST falls outside the legal range, it is defaulted to 6. no cap, that's just what it does 🙈

🌸 C-BINDING DESCRIPTION 🌸

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical, we're not retyping all that 💀

---

👑 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. periodt.

If the image is too small, decrease the size of RMULT; if the image is too large, increase the size of RMULT 🔍 (yes, it's that kind of relationship).

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. 😭 so if you had a cute color table, bestie... it's gone now. The color table that gets 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 💫 (order matters, iykyk).

---

🌈 SEE ALSO 🌈

Online, aka your reading list, go off:

• 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.

---

and that's the whole page, bestie 💅 this one came from the UNIX manual, June 1998 edition, filed under TDEZ3D(3NCARG) — iconic behavior from 1998 fr fr 🌸🦋 go draw an isosurface, you've got this 💜