STINIT(3NCARG)

✨ NAME ✨

okay so bestie, STINIT is the lil' pre-game ritual 💅 — she does all the initialization tasks you have to do before STREAM can be called to create a streamline field flow plot. Like, the way she copies info about your input data arrays into internal common block variables and then sets up the coordinate system mappings and boundaries? it's giving responsible queen. no cap.

---

🎀 SYNOPSIS 🎀

CALL STINIT (U,LU,V,LV,P,LP,M,N,WRK,LW)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_stinit(float *u, int lu, float *v, int lv,
              float *p, int lp, int m, int n,
              float *wrk, int lw)

---

🌸 DESCRIPTION 🌸

here's the whole squad of arguments, one by one, no skips, no cuts 💖

• U — (REAL 2-dimensional array, dimensioned LU x n: n >= N, input) by default she's assumed to contain the first dimensional Cartesian components of the vector field. BUT — plot twist — if PLR is non-zero, she gets treated as containing the vector magnitudes instead. 🙈
• LU — (INTEGER, input) the actual value of the first dimension of array U.
• V — (REAL 2-dimensional array, dimensioned LV 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, she's treated as containing the vector angles. 🌈
• LV — (INTEGER, input) the actual value of the first dimension of array V.
• P — (REAL, input, DUMMY) this one is literally just vibing rn — she's currently ignored and you may assign her a dummy value. 💀
• LP — (INTEGER, input, DUMMY) the first dimension of array P. not currently used, so bestie should be assigned the integer value 0.
• M — (INTEGER, input) number of contiguous elements along the first dimensional axis containing data to be processed in each of the arrays, U and V.
• N — (INTEGER, input) number of contiguous elements along the second dimensional axis containing data to be processed in each of the arrays, U and V.
• WRK — (REAL, array dimensioned n: n >= LW, input/output) the work array 🛠️ used to store normalized values of the U and V vector components while the streamlines are calculated. she also holds bit flags indicating whether a grid location is eligible for starting a streamline or placing a directional arrowhead. multi-talented fr fr.
• LW — (INTEGER, input) the assumed size of the array WRK. currently it must be greater or equal to 2*M*N. ⭐

---

🧚 C-BINDING DESCRIPTION 🧚

the C-binding argument descriptions are the same as the FORTRAN argument descriptions, with the following exceptions (yes there's a plot twist, there always is):

• lu — the second dimension of u in the calling program.
• lv — the second dimension of v in the calling program.
• lp — the second dimension of p in the calling program.
• m — number of contiguous elements along the second dimension containing data to be processed in each of the arrays, u and v.
• n — number of contiguous elements along the first dimension containing data to be processed in each of the arrays, u and v.

---

💜 USAGE 💜

call STINIT before the first invocation of STREAM, and again any time you modify the contents of the input data arrays. periodt.

you may precede an STINIT call with any number of calls to the parameter setting routines, STSETR and STSETI. however — and listen, this part matters — although it is possible to call STSETI or STSETR between calls to STINIT and STREAM, changing the setting of many of Streamline's parameters at this point will result in incorrect behavior. 😭 so when in doubt, set your parameters before the STINIT call; go check the streamlines_params man page for more info.

set up the two vector component arrays prior to calling STINIT. to permit multiple purpose use of the array space, the STINIT argument list includes both the actual size and an assumed size for the first dimension of each input array. due to FORTRAN array ordering conventions, only the assumed size needs to be specified for the second dimension. (note: when using the C bindings, mentally exchange all references to first and second dimensions in this discussion. 🧠✨) the arguments LU and LV contain the actual size of the first dimensions of U and V, respectively. since the grid locations for each of the data arrays are assumed to coincide, a single argument, M, represents the assumed size of the first dimension for both arrays. similarly, the argument N is the assumed size of the second dimension. the only requirement for the actual second dimension size is that it be greater than or equal to N for each array.

the P and LP arguments are intended for future enhancement of the Streamlines utility. they are not currently used or examined in any way. for maximum assurance of compatibility with future changes to the code, give the LP argument the INTEGER value 0. 🫶

WRK is an array used to store normalized values of the U and V vector components while the streamlines are calculated. she also holds bit flags indicating whether a grid location is eligible for starting a streamline or placing a directional arrowhead. her assumed size is specified by the argument LW. and LW must have a value greater or equal to 2*M*N. 👑

---

🔥 EXAMPLES 🔥

use the ncargex command to see the following relevant examples: ffex00, ffex01, ffex03, ffex04, fstream, stex01, stex02, stex03.

---

🌟 ACCESS 🌟

to use STINIT or c_stinit, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. don't be chaotic about it bestie. 💅

---

💌 MESSAGES 💌

see the streamlines man page for a description of all Streamlines error messages and/or informational messages.

---

👑 SEE ALSO 👑

Online: stgetc, stgeti, stgetr, stream, streamlines, streamlines_params, strset, stsetc, stseti, stsetr, stuixy, stumsl, stumta, stumxy, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

---

🌸 COPYRIGHT 🌸

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

---

okay that's the whole page, you ate that 🍓 this was STINIT(3NCARG) from the NCAR Graphics manual — the UNIX flavor, dated April 1993 💖 go make some streamlines, main character ✨