EZSTRM(3NCARG)

💖 EZSTRM 💖 — the NCAR Graphics era

okay bestie, so this whole thing lives in the NCAR Graphics manual, and EZSTRM is literally the drive-thru version of STRMLN. It's a front-end to STRMLN with a simpler interface, and just like STRMLN, it plots a streamline representation of field flow data in a single call. one call, one plot, no thoughts head empty. ✨

---

🌸 STATUS 🌸

ngl, this one is obsolete. 💀 It's only still here to provide compatibility with old NCAR Graphics codes — like, it's the ancestor who refuses to leave the group chat.

BUT. The compatibility mode parameter, CPM, offers a number of options to help ease the transition to the new version of the utility. So there's a lil escape hatch, iykyk.

When you're writing new code you are encouraged not to use this entry point, because it provides less capability than the standard Streamlines interface, and it may eventually be phased out. it's giving "beloved but doomed". 😭

---

✨ SYNOPSIS ✨

CALL EZSTRM (U,V,WORK,IMAX,JMAX)

🎀 C-BINDING SYNOPSIS 🎀

#include <ncarg/ncargC.h>

void c_ezstrm (float *u, float *v, float *work,
               int imax, int jmax)

---

💅 DESCRIPTION 💅

okay so here's the cast of characters, everybody's got a role:

• U — (REAL 2-dimensional array, dimensioned IMAX x n: n >= JMAX, input) By default, we assume it holds the first dimensional Cartesian components of the vector field. HOWEVER 💫 if PLR is non-zero, it gets treated as holding the vector magnitudes instead.
• V — (REAL 2-dimensional array, dimensioned IMAX x n: n >= JMAX, input) By default, we assume it holds the second dimensional Cartesian components of the vector field. BUT 🫶 if PLR is non-zero, it gets treated as holding the vector angles.
• WORK — (REAL array, dimensioned n: n >= 2*IMAX*JMAX working space): user provided work array, used to store the normalized vector component values, and also to keep track of the grid boxes eligible for starting a streamline or placement of a directional arrow. it's the backstage crew fr fr. 🧚
• IMAX — (INTEGER, input) Actual size of the first dimension of arrays U and V.
• JMAX — (INTEGER, input) Assumed size of the second dimension of arrays U and V.

---

🌈 C-BINDING DESCRIPTION 🌈

The C-binding argument descriptions are the same as the FORTRAN argument descriptions, with the following exceptions — pay attention bestie, the dimensions get a lil swapped 🙈:

• imax — The actual size of the second dimension of arrays u and v.
• jmax — The assumed size of the first dimension of arrays u and v.

---

🔥 USAGE 🔥

U and V are 2-dimensional vector component arrays, whose actual first dimensions must be equal to the value of IMAX, and whose second dimensions must equal or exceed the value of JMAX. The WORK array must, at minimum, be of length 2*IMAX*JMAX. like, that's the floor, don't come in under it. ⭐

Assuming the default value of the compatibility mode parameter, CPM, Streamlines always performs a SET call and draws a perimeter around the plot when accessed through the EZSTRM interface. Before the return from EZSTRM, another call to SET restores the previous coordinate system mapping. so it sets up, draws the lil border, and then puts everything back exactly how it found it. respectful queen. 👑

By modifying the value of CPM, you may take more control over the utility than originally possible using this entry point. For instance, you can override the default value of the SET parameter, or use the Version 3.2 coordinate system mapping routines instead of the old FX and FY functions. main character energy, honestly. 💜

Nevertheless, when creating new code, use the STINIT/STREAM interface, since its capabilities are greater and more likely to improve with time. this is the "bestie pls" of the whole page. 🥺

---

💖 ACCESS 💖

To use EZSTRM, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't be chaotic. ✨

---

🦋 SEE ALSO 🦋

Online: fx, stgetc, stgeti, stgetr, stinit, stream, streamlines, streamlines_params, strset, stsetc, stseti, stsetr, stuixy, stumsl, stumta, stumxy, ncarg_cbind. go read the whole friend group, they're all iconic. 🌸

---

👑 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 dropped way back in April 1993 as part of the UNIX man pages, filed under EZSTRM(3NCARG). old school, but still slaying in the archive. 🎀