NGGSOG(3NCARG)

✨ NAME ✨

Bestie, gather round πŸ’– NGGSOG β€” the NCAR Graphics girlie (from the 3NCARG manual, hi) that returns the latitudes and longitudes of six points defining a five-pointed star at a given point on the surface of the globe. Yes, a literal star. On a globe. She's giving cartography but make it astrology πŸ’…β­


🌸 SYNOPSIS 🌸

CALL NGGSOG (SLAT,SLON,SRAD,ALAT,ALON)

πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

#include <ncarg/ncargC.h>

void c_nggsog(float slat, float slon, float srad, float *alat,
float *alon)

πŸ’œ DESCRIPTION πŸ’œ

okay so here's the whole cast of characters, no skips:

  • SLAT β€” (an input expression of type REAL) the latitude, in degrees, of a point on the globe defining the center of the star. That's the star's home base, basically.
  • SLON β€” (an input expression of type REAL) the longitude, in degrees, of that same point on the globe defining the center of the star. Where she lives, east-west edition.
  • SRAD β€” (an input expression of type REAL) specifies the great-circle distance, in degrees, from the center of the star to the end of one of its points. So like, how far the star's lil arms reach 🫢
  • ALAT β€” (an output array, of type REAL, dimensioned 6) the array where the latitudes of points on the star get returned. Six of them. She's thorough.
  • ALON β€” (an output array, of type REAL, dimensioned 6) the array where the longitudes of points on the star get returned. Also six. Matching set, periodt ✨

🌈 C-BINDING DESCRIPTION 🌈

The C binding argument descriptions are the same as the FORTRAN argument descriptions. Same vibes, different syntax, no notes πŸ’…


πŸ”₯ USAGE πŸ”₯

Let C represent (CLAT,CLON), let O represent the center of the globe, and let P represent the end of one point of the star. Then, the angle POC has the magnitude specified by SRAD. Like, that's the geometry, that's the whole relationship, iconic honestly.

SIN, COS, and TAN are used to generate points representing a star having the desired radius and centered at the the point with latitude 0 and longitude 0. (Yes, "the the" β€” that's canon, I don't make the rules 😭) These points are then subjected to two rotations β€” one that brings the star up to the desired latitude, and another that carries it to the desired longitude. Spin, spin, slay πŸŒ€

NGGSOG is intended to be used for relatively small stars marking points of interest on the surface of the globe; using SRAD = 90 degrees is guaranteed to get you into trouble and SRAD < 10 degrees is recommended.

🚨 bestie WARNING: SRAD = 90 degrees is guaranteed to get you into trouble. Not "might", not "could", guaranteed. Keep it under 10 degrees if you want peace in your life πŸ™ˆ

πŸŽ€ EXAMPLES πŸŽ€

Use the ncargex command to see the following relevant example: cpex10.


🧚 ACCESS 🧚

To use NGGSOG or c_nggsog, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. Order matters, don't fight it πŸ’–


⭐ MESSAGES ⭐

None.

(Not a single peep. Silent. Elegant. She communicates through geometry only πŸ‘‘)


🌸 SEE ALSO 🌸

Online: nggcog(3NCARG), ngritd(3NCARG).


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 up fr fr 🫢 this was NGGSOG(3NCARG) from the NCAR GRAPHICS manual, and this lil transmission came to you via UNIX, dated March 1993 β€” vintage but she still hits βœ¨πŸ’… go draw ur star, bestie, and keep SRAD small πŸ˜­πŸ’œ