Provided by: libncarg-bin_6.3.0-6build1_amd64 
NAME
ng4ex - NCAR Graphics High Level Utilities Example Programs
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
ng4ex provides the user with access to several C, Fortran, and NCL examples illustrating
the use of the NCAR Graphics HLUs (High Level Utilities) and NCL. Please note that NCL is
not available for Cray systems.
ng4ex copies the source code for the specified example(s) into the current directory and
then compiles, links, and executes the example (if it's a Fortran or C program) or runs
NCL on it (if it's an NCL script file). Depending on the example, the output may be sent
to an NCGM (NCAR Graphics Metafile) file and/or displayed to an X window on your screen.
You must be running X and have your DISPLAY environment set correctly in order for the X
window examples to execute properly.
If the requested example creates an NCGM file, it will have the same name as the example,
suffixed with ".ncgm". An option allows you to request that only the source code be copied
to your directory, without compiling or running the example. Another option allows you to
request that only the NCGM file be left in your directory and that all other files created
by ng4ex be deleted. The argument name may be selected from the lists that appear below.
OPTIONS
-A Generate all available examples.
-C Generate all C examples.
-Fortran
Generate all Fortran examples.
-NCL Generate all NCL examples.
-cdf Generate all the examples that use netCDF files. For the C and Fortran examples,
this option requires that you have the netCDF library installed on your system.
-gui Generate all GUI examples. This option 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. You cannot specify
more than one workstation type. If you don't specify one, then a default one will
be used. The following workstation_type strings are valid:
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. 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
Please notice that the C examples end with the letter 'c', the Fortran examples end with
the letter 'f', and NCL examples with the letter 'n'.
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".
mp04c,mp04f,mp04n
Illustrates the use of AnnoManager objects with MapPlot objects.
mp05c,mp05f,mp05n
Shows how to create the ten different map projections.
mp06c,mp06f,mp06n
Shows how to draw county lines in the United States.
mp07c,mp07f,mp07n
Shows how to use 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
ncargex(1NCARG)
COPYRIGHT
Copyright (C) 1987-2000
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
NCARG Nhl EXAMPLES ng4ex(1Nhl)