ng4ex(1Nhl)

✨ NAME ✨

okay so bestie, welcome to ng4ex (full glow-up name: ng4ex(1Nhl)) — it's literally the NCAR Graphics High Level Utilities Example Programs. 💖 that's the whole vibe. example programs. for the HLUs. iconic behavior.

---

🌸 SYNOPSIS 🌸

ng4ex [-A] [-C] [-Fortran] [-NCL] [-cdf] [-csagrid] [-cssgrid] [-gui]
[-anno] [-gsun] [-W workstation_type] [-app] [-basic] [-contourplot]
[-fitgrid] [-labelbar] [-legend] [-primitives] [-mapplot] [-natgrid]
[-ngmath] [-streamplot] [-shgrid] [-textitem] [-tickmark] [-title]
[-vectorplot] [-xyplot] [-list] [-clean] [-n] name ...

---

💅 DESCRIPTION 💅

so like. ng4ex hands you the keys to a whole closet full of C, Fortran, and NCL examples that show off how the NCAR Graphics HLUs (that's High Level Utilities, iykyk) and NCL actually get used. 💖

🚨 lowkey important: NCL is not available for Cray systems. just so you know, bestie.

here's the whole plot: ng4ex copies the source code for the example(s) you asked for into the current directory, and then — depending on what it is — either compiles, links, and executes it (if it's a Fortran or C program) or runs NCL on it (if it's an NCL script file). slay. 🫶

depending on which example you pick, the output might get sent to an NCGM (NCAR Graphics Metafile) file and/or displayed to an X window right there on your screen. you must be running X and have your DISPLAY environment set correctly for the X window examples to actually execute properly. no DISPLAY, no vibes. 😭

if the example you requested creates an NCGM file, it's gonna have the same name as the example, just with .ncgm stuck on the end. cute, consistent, we love her. ✨

there's an option that lets you ask for only the source code to be copied to your directory, no compiling, no running, just the code, periodt. and there's another option that lets you ask for only the NCGM file to be left behind, with every other file ng4ex created getting deleted. the argument name can be picked from the lists further down. 🌈

---

🎀 OPTIONS 🎀

• -A — Generate all available examples. every single one. the whole menu. 👑
• -C — Generate all C examples.
• -Fortran — Generate all Fortran examples.
• -NCL — Generate all NCL examples.
• -cdf — Generate all the examples that use netCDF files. heads up bestie: for the C and Fortran examples, this one requires that you have the netCDF library installed on your system. no library, no examples, that's just the rules. 🍓
• -gui — Generate all GUI examples. this one requires that you have the Motif libraries on your system. 💅
• -anno — Generate all annotation examples.
• -W — Specify the workstation type. this argument can only be specified as a string. some examples are meant to display to the X workstation, to an NCGM file, or to a PostScript file only — in which case this option may be ignored (she's just gonna do her own thing 🙈). you cannot specify more than one workstation type. and if you don't specify one, a default one gets used. here are the valid workstation_type strings:
  • ncgm — NCGM file
  • x11 — X11 window
  • ps — PostScript file
  • pdf — PDF file
• -app — Generate all the app Fortran, C, and NCL examples that show how to do specific things with resources.
• -basic — Generate all the basic Fortran, C, and NCL examples that relate to the basic examples discussed in the Quick Start Guide.
• -contourplot — Generate all Fortran, C, and NCL ContourPlot examples.
• -csagrid — Generate all NCL Csagrid examples.
• -cssgrid — Generate all NCL Cssgrid examples.
• -dsgrid — Generate all Fortran, C, and NCL Dsgrid examples.
• -fitgrid — Generate all NCL Natgrid examples.
• -labelbar — Generate all Fortran, C, and NCL Labelbar examples.
• -legend — Generate all Fortran, C, and NCL Legend examples.
• -natgrid — Generate all Fortran, C, and NCL Natgrid examples.
• -primitives — Generate all Fortran, C, and NCL GraphicStyle examples.
• -mapplot — Generate all Fortran, C, and NCL MapPlot examples.
• -ngmath — Generate all Fortran, C, and NCL Ngmath examples.
• -shgrid — Generate all NCL Shgrid examples.
• -streamlineplot — Generate all Fortran, C, and NCL StreamlinePlot examples.
• -textitem — Generate all Fortran, C, and NCL TextItem examples.
• -tickmark — Generate all Fortran, C, and NCL TickMark examples.
• -title — Generate all Fortran, C, and NCL Title examples.
• -vectorplot — Generate all Fortran, C, and NCL VectorPlot examples.
• -xyplot — Generate all Fortran, C, and NCL xyPlot examples.
• -gsun — Generate all the GSUN examples (NCL scripts only).
• -list — Specifies that the names of the selected examples should be echoed to the screen instead of being copied or generated. this option must be used with one of the other options that selects a particular subset of examples. like, for example, if you want to see a list of all the available examples, then use -list in conjunction with the -A option. if you want to see a list of all the ContourPlot examples, then use -list with the -contourplot option (and so on). 🦋
• -clean — Remove everything but the .ncgm file.
• -n — Specifies that the example should just be copied, and not linked or executed.
• name(s) — Name(s) of example programs to generate.

---

👑 EXAMPLES AVAILABLE 👑

quick heads-up before we dive in: the C examples end with the letter c, the Fortran examples end with the letter f, and NCL examples end with the letter n. see the pattern? she's consistent. 🧚

ap01c, ap01f, ap01n

Demonstrates various ways to use resource files.

basic01c, basic01f, basic01n

Demonstrates how to draw a contour plot using mostly defaults. No data is used in this example.

basic02c, basic02f, basic02n

Demonstrates how to set the view port and how to produce multiple plots on a single frame.

basic03c, basic03f, basic03n

Demonstrates how to create a scalar data object, set resources using a resource file, set resources during object creation, and set resources after object creation.

basic04c, basic04f, basic04n

Demonstrates how to select and change the workstation device for drawing your output to an NCGM file or an X workstation window.

basic05c, basic05f, basic05n

Demonstrates how to read and manipulate colormaps.

basic06c, basic06f, basic06n

Demonstrates how to position objects on an output device and how to change their sizes.

basic07c, basic07f, basic07n

Demonstrates creating three simultaneous workstations.

basic08c, basic08f, basic08n

Demonstrates use of a procedure that limits a plot, including annotations that extend outside the plot viewport, to a pre-defined bounding box within NDC space.

basic09c, basic09f, basic09n

Lists all the fonts with their number, name, and what the font looks like.

cn01c, cn01f, cn01n

Shows all the default settings for the ContourPlot resources using a simple data set.

cn02c, cn02f, cn02n

Demonstrates basic features of the ContourPlot object.

cn03c, cn03f, cn03n

Demonstrates basic features of the ContourPlot object. The first frame emulates the contour plot drawn in cn01.

cn04c, cn04f, cn04n

Emulates the output of the ncargex example "cpex02".

cn05c, cn05f, cn05n

Demonstrates how to create a map plot animation with a contour overlay and labelbar annotation.

cn06c, cn06f, cn06n

Shows how to read a netCDF file and produce a series of temperature contour plots.

cn07c, cn07f, cn07n

Shows how to read a netCDF file and produce a series of contour plots.

cn08c, cn08f, cn08n

Shows how to read a netCDF file and draw a vertical profiles of temperature for longitude separated by 5 degrees.

cn09c, cn09f, cn09n

Shows how to read a netCDF file and produce a series of surface pressure contour plots.

cn10f, cn10c, cn10n

Demonstrates how to read a netCDF file and produce three contour plots, an xyplot, and a map plot.

cn11c, cn11f

Demonstrates how to combine LLU and HLU calls.

cn12c, cn12f, cn12n

Emulates example "cpex08" and draws a filled contour plot over a map of Africa with a labelbar.

cn13c, cn13f, cn13n

Emulates example "mpex10" and draws a raster contour plot over a map using inverse map transformations.

cn14c, cn14f, cn14n

Shows how to do a contour/map overlay with tick marks showing the lat/lon locations.

cn15c, cn15f, cn15n

Shows how to combine contour plot and xy plot on a single frame. Also shows how to do multiple workstation outputs, and how to position your PostScript output on the page.

cn16c, cn16f, cn16n

Shows how to combine a vector fill contour plot, a raster contour plot, and a map plot on a single frame.

cn17c, cn17f, cn17n

Shows how to restrict a contour plot to a certain area over a satellite projection, how to label the US states with AnnoManager, how to use NhlDataPoly{line,marker} to draw lines/markers on a map projection, and how to mix LLUs/HLUs to draw text in the map projection. The NCL version doesn't have the LLU/HLU part.

lb01c, lb01f, lb01n

Shows all the default settings for the LabelBar resources.

lb02c, lb02f, lb02n

Shows how to modify some of the default resources to create a solid filled set of boxes.

lg01c, lg01f, lg01n

Shows all the default settings for the Legend resources.

lg02c, lg02f, lg02n

Shows how to modify some of the default resources to create a legend of five markers.

lg03c, lg03f, lg03n

Shows how to create a legend of five lines.

pr01c, pr01f, pr01n

Demonstrates basic GraphicStyle capabilities.

pr02c, pr02f, pr02n

Demonstrates GraphicStyle capabilities and how to some GS resources.

pr03c, pr03f, pr03n

Demonstrates graphics primitives drawn in NDC space and how clipping works.

pr04c, pr04f, pr04n

Demonstrates graphics primitives drawn into an IrregularPlot object.

pr05c, pr05f, pr05n

Demonstrates overlaying graphics primitives on a MapPlot.

mp01c, mp01f, mp01n

Demonstrates basic MapPlot capabilities.

mp02c, mp02f, mp02n

Demonstrates individual control of MapPlot areas.

mp03c, mp03f, mp03n

Demonstrates MapPlot masking; loosely emulates the ncargex example "colcon".

okay bestie, the example roster keeps going — no heading repeat, just straight into the good stuff:

• mp04c,mp04f,mp04n — shows how AnnoManager objects vibe with MapPlot objects.
• mp05c,mp05f,mp05n — shows you how to create all ten different map projections.
• mp06c,mp06f,mp06n — shows how to draw county lines in the United States.
• mp07c,mp07f,mp07n — shows how to use the high resolution RANGS/GSHHS map database.
• nm01c,nm01f,nm01n — simple example of natural neighbor linear interpolation.
• nm02c,nm02f,nm02n — simple example of natural neighbor linear regridding.
• nm03c,nm03f,nm03n — shows how to retrieve aspects and slopes of an interpolation.
• nm04c,nm04f,nm04n — shows a simple 3D interpolation.
• nm05c,nm05f,nm05n — shows how to vary the exponent of the distances in a simple 2D interpolation.
• nm06c,nm06f,nm06n — smoothing in a simple 2D interpolation.
• nm07n — illustrates use of ftcurv, ftcurv, and ftcurvi.
• nm08n — illustrates use of ftcurvp and ftcurvpi.
• nm09n — illustrates use of ftcurvs and ftcurvps.
• nm10n — illustrates use of ftkurv and ftkurvd.
• nm11n — illustrates use of ftkurvp and ftkurvpd.
• nm12n — illustrates use of ftsurf.
• nm13n — illustrates the use of csa1s.
• nm14n — illustrates the effect of weighting the input points using csa1xs.
• nm15n — illustrates extrapolation into data sparse regions using csa1xs.
• nm16n — illustrates two-dimensional approximation and second-order mixed partial using csa2s and csa2xs.
• nm17n,nm18n — illustrates the use of csa3s.
• nm19n — illustrates the use of csa2ls.
• nm20n — illustrates the use of triangulation and Voronoi diagram capabilities of the cssgrid package.
• nm21n — illustrates the use of the interpolation capabilities of the cssgrid package.
• nm22n — illustrates the use of shgrid. cssgrid package.
• st01c,st01f,st01n — demonstrates basic StreamlinePlot example.
• st02c,st02f,st02n — demonstrates line-drawn streamline arrows and some basic resources.
• st03c,st03f,st03n — shows how to overlay a StreamlinePlot on a map projection.
• st04c,st04f,st04n — shows a StreamlinePlot of wind vector data over a MapPlot.
• ti01c,ti01f,ti01n — shows all the default settings for the Title resources which results in a blank plot.
• ti02c,ti01f,ti01n — turns on the main, x-axis, and y-axis strings to produce a plot with three titles.
• ti03c,ti03f,ti03n — shows how to change resources to get high quality filled and colored titles.
• tm01c,tm01f,tm01n — shows all the default settings for the TickMark resources.
• tm02c,tm02f,tm02n — shows how to modify the resources to create tick marks on the axes.
• tm03c,tm03f,tm03n — shows how to modify the resources to change the scaling and the tick mark labels.
• tx01c,tx01f,tx01n — shows all the default settings for the TextItem resources.
• tx02c,tx02f,tx02n — shows how to modify default resources to produce a text string.
• tx03c,tx03f,tx03n — uses the same resources as example tx02c, except 114 frames are produced with varying background colors.
• tx04c,tx04f,tx04n — shows how to use the TextItem object of the HLU library.
• tx05c,tx05f,tx05n — demonstrates the TextItem object with text having various heights and various angles.
• tx06c,tx06f,tx06n — demonstrates TextItem text justifications.
• tx07c,tx07f,tx07n — demonstrates TextItem text spacings and aspect ratios.
• tx08c,tx08f,tx08n — simple Annotation example.
• vc01c,vc01f,vc01n — basic VectorPlot example.
• vc02c,vc02f,vc02n — demonstrates line-drawn vector arrows and the use of some basic VectorPlot resources.
• vc03c,vc03f,vc03n — manipulates the FillArrow resources to demonstrate some of the possible stylistic variations on the appearance of filled vector arrows.
• vc04c,vc04f,vc04n — demonstrates how to rotate a VectorPlot 90 degrees while preserving the original relationship of the data elements.
• vc05c,vc05f,vc05n — demonstrates how to overlay a VectorPlot on a MapPlot.
• vc06c,vc06f,vc06n — demonstrates how to use a scalarfield to determine the color of the vector arrow fill.
• vc07c,vc07f,vc07n — emulates the LLU example fcover; shows how to overlay contours and vectors on a MapPlot.
• vc08c,vc08f,vc08n — plots wind vectors at a grid stride of 3. Vectors are colored by wind speed.
• vc09c,vc09f,vc09n — plots an animation of the January 1996 snow storm using wind vectors colored by temperature over a pressure field contour plot.
• xy01c,xy01f,xy01n — shows all the default resources for an xyPlot object.
• xy02c,xy02f,xy02n — the same as example xy01c, only with some of the X and Y axis resources tweaked.
• xy03c,xy03f,xy03n — the same as example xy01c, but with the data modified a little, and the line resources tweaked.
• xy04c,xy04f,xy04n — demonstrates how to create an xyPlot with multiple lines. Some of the line resources are tweaked.
• xy05c,xy05f,xy05n — demonstrates how to create an XyPlot with multiple lines, using multiple data items (except for xy05c, which uses the CoordArrTable object).
• xy06c,xy06f,xy06n — demonstrates how to read in netCDF files to generate various xy plots.
• xy07c,xy07f,xy07n — demonstrates how to draw a "scattergram".
• xy08c,xy08f,xy08n — shows how to use irregular points to change the transformation of your plot.
• xy09c,xy09f,xy09n — shows how to create different kinds of axes.
• xy10c,xy10f,xy10n — shows how to overlay an XyPlot on a MapPlot.
• xy11c,xy11f,xy11n — demonstrates how to display an xyPlot to an X Window, and then copy it to a meta file.
• xy12c — demonstrates how to incorporate the HLU library with a GUI. It uses an X/Motif interface, and also allows the user to copy frames from the X Window to a meta file.
• xy13c — shows how to interactively retrieve data values from a plot by pointing and clicking on the plot.
• xy14c,xy14f,xy14n — demonstrates the data manipulation capabilities of NCL.
• xy15c,xy15f,xy15n — demonstrates the creation of a set of four stacked XyPlots.
• xy16c,xy16f,xy16n — demonstrates how to draw three different xy lines on the same plot, but with different axis scales.
• xy17c,xy17f,xy17n — demonstrates how to stack three xy plots.

---

👀 SEE ALSO 👀

bestie if you want more, go peek at ncargex(1NCARG) — that's the whole mood. slay.

---

📜 COPYRIGHT 📜

so legal tea, no cap: Copyright (C) 1987-2000 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

and that's the entire NCARG Nhl EXAMPLES page for ng4ex(1Nhl). the footer says source/version is NCARG Nhl EXAMPLES and the page is ng4ex(1Nhl) — no date in sight, so we're keeping it timeless. bye bestie, go run an example 💅✨