EZVEC(3NCARG)

✨ EZVEC ✨ — the NCAR GRAPHICS glow-up page 💅

okay so bestie, welcome to EZVEC, a manual page from the NCAR GRAPHICS collection. this one lives in section 3NCARG, and it's all about a lil front-end situation. let's get into it 🫶

---

🌸 NAME 🌸

EZVEC — it's a front-end to VELVCT with a simpler interface. and like VELVCT, it plots a vector field in a single call. one call, whole vector field, no cap. ✨

---

🎀 SYNOPSIS 🎀

CALL EZVEC (U,V,M,N)

that's it. that's the whole vibe. four args and you're done. 💖

---

💀 STATUS 💀

okay so real talk: EZVEC is obsolete. it's only still here to provide compatibility with old NCAR Graphics codes. like, it's giving legacy. it's giving "we keep it around for the elders."

BUT — and this is the cute part — the compatibility mode parameter, CPM, offers a number of options to help ease the transition to the new version of the utility. so you're not stranded, bestie. 🫶

when you're writing new code, you are encouraged not to use this entry point, since it provides less capability than the standard Vectors interface, and may eventually be phased out. so… yeah. it might get axed. just saying. 🙈

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_ezvec (float *u, float *v, int m, int n)

C girlies, we got you. 💅

---

👑 DESCRIPTION 👑

the args, one by one, no skips

• U — (REAL 2-dimensional array, dimensioned M x n: n >= N, input) by default, this is assumed to contain the first dimensional Cartesian components of the vector field. BUT — plot twist — if PLR is non-zero, it gets treated as containing the vector magnitudes. 🌈
• V — (REAL 2-dimensional array, dimensioned M x n: n >= N, input) by default, assumed to contain the second dimensional Cartesian components of the vector field. however, if PLR is non-zero, it's treated as containing the vector angles. 📐
• M — (INTEGER, input) the actual size of the first dimension of arrays U and V.
• N — (INTEGER, input) the 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 — and yes, they do flip, pay attention bestie:

• m — the actual size of the second dimension of arrays u and v.
• n — the assumed size of the first dimension of arrays u and v.

see what they did there? sneaky. iconic, but sneaky. 😭

---

🔥 USAGE 🔥

U and V are 2-dimensional vector component arrays, whose actual first dimensions must be equal to the value of M, and whose second dimensions must equal or exceed the value of N. got that? equal for the first, equal-or-exceed for the second. 📏

assuming the default value of the compatibility mode parameter, CPM, Vectors always performs a SET call and draws a perimeter around the plot when accessed through the EZVEC interface. before the return from EZVEC, another call to SET restores the previous coordinate system mapping. so it puts a little fence around your plot and then puts everything back exactly how it found it. considerate 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, FY, MXF, and MYF functions. glow-up unlocked ✨

nevertheless — when creating new code, use the VVINIT/VVECTR interface, since its capabilities are greater and more likely to improve with time. fr fr. it's the main character. this one is the cameo. 🎬

---

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant example: tvelvc.

go look at it. it's right there. 💖

---

🌈 ACCESS 🌈

to use EZVEC, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters bestie, don't freestyle it. 🎀

---

🫶 SEE ALSO 🫶

online: vectors, vectors_params, fx, velvct, vvectr, vvgetc, vvgeti, vvgetr, vvinit, vvrset, vvsetc, vvseti, vvsetr, vvudmv, vvumxy, ncarg_cbind.

(the whole friend group, basically. go say hi. 👯)

---

💜 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 page!! this little time capsule is from UNIX, dated April 1993, filed under EZVEC(3NCARG) — literally a vintage. stan the classics, bestie. 💅✨🌸