TDSORT(3NCARG)

✨ TDSORT ✨ (that's TDSORT(3NCARG) bestie, from the NCAR GRAPHICS fam 💖)

🌸 NAME 🌸

TDSORT — it's a generic sorting routine, and ngl it's normally used indirectly, by calling the routine TDOTRI. She's a background queen, she doesn't need the spotlight 👑

🎀 SYNOPSIS 🎀

CALL TDSORT (RWRK, NRWK, IORD, IWRK)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_tdsort(float *rwrk, int nwrk, int iord, int *iwrk)

💅 DESCRIPTION 💅

Okay so, real talk: this is an internal routine used for sorting. Originally it was not intended that a user should call this routine directly — but bestie, doing so will do no harm 💖. She's chill like that.

So here's the vibe: you hand her an array of NRWK reals sitting in an array RWRK, plus an "ordering flag" IORD, and TDSORT returns a permutation vector IWRK such that, for every I and J such that 1.LE.I.LE.J.LE.NWRK, if IORD is zero, then RWRK(IWRK(I)).LE.RWRK(IWRK(J)), else RWRK(IWRK(I)).GE.RWRK(IWRK(J)). Periodt ✨.

The arguments of TDSORT are as follows — pay attention, this is the important part 🫶:

• RWRK — an input array, of type REAL, dimensioned NWRK. It's an array of NWRK real numbers that are to be sorted. Here's the thing though: the contents of RWRK are returned unchanged 😌. The ordering is as specified by the contents of the array IWRK. She does not touch your data, she just tells you where it goes. Iconic behaviour honestly.
• NWRK — an input expression of type INTEGER, and it's the dimension of RWRK (and of IWRK). Yes, both. They match. Slay.
• IORD — an input expression of type INTEGER. If IORD is zero, the desired ordering is from smallest numeric value to largest. Otherwise, the desired ordering is from largest value to smallest. So like, 0 = ascending, not-0 = descending, that's the whole plot 💀.
• IWRK — an output array of type INTEGER, dimensioned at least NWRK. She comes back containing a permutation of the integers from 1 to NWRK. That's it, that's the whole job 🌈.

🧚 C-BINDING DESCRIPTION 🧚

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. No notes. Same energy, different syntax 💜.

🔥 ACCESS 🔥

To use TDSORT or c_tdsort, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. Order matters bestie, don't be chaotic 🙈.

⭐ SEE ALSO ⭐

Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdstri, tdstrs

(the whole td* friend group showed up, we love a supportive squad 🫶)

👑 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 it, you understood it, main character energy all around 💅✨ This was TDSORT(3NCARG) from the UNIX manual, dated July 1997 — yeah she's an elder but she's still thriving. Byeee, go sort something 🦋💖