1ng4ex(1Nhl) ng4ex(1Nhl)
2
6 ng4ex - NCAR Graphics High Level Utilities Example Programs
7
9 ng4ex [-A] [-C] [-Fortran] [-NCL] [-cdf] [-csagrid] [-cssgrid] [-gui]
10 [-anno] [-gsun] [-W workstation_type] [-app] [-basic] [-contourplot]
11 [-fitgrid] [-labelbar] [-legend] [-primitives] [-mapplot] [-natgrid]
12 [-ngmath] [-streamplot] [-shgrid] [-textitem] [-tickmark] [-title]
13 [-vectorplot] [-xyplot] [-list] [-clean] [-n] name ...
14
16 ng4ex provides the user with access to several C, Fortran, and NCL
17 examples illustrating the use of the NCAR Graphics HLUs (High Level
18 Utilities) and NCL. Please note that NCL is not available for Cray
19 systems.
20 ng4ex copies the source code for the specified example(s) into the
22 current directory and then compiles, links, and executes the example
23 (if it's a Fortran or C program) or runs NCL on it (if it's an NCL
24 script file). Depending on the example, the output may be sent to an
25 NCGM (NCAR Graphics Metafile) file and/or displayed to an X window on
26 your screen. You must be running X and have your DISPLAY environment
27 set correctly in order for the X window examples to execute properly.
28 If the requested example creates an NCGM file, it will have the same
30 name as the example, suffixed with ".ncgm". An option allows you to
31 request that only the source code be copied to your directory, without
32 compiling or running the example. Another option allows you to request
33 that only the NCGM file be left in your directory and that all other
34 files created by ng4ex be deleted. The argument name may be selected
35 from the lists that appear below.
36
38 -A Generate all available examples.
39 -C Generate all C examples.
42 -Fortran
45 Generate all Fortran examples.
46 -NCL Generate all NCL examples.
49 -cdf Generate all the examples that use netCDF files. For the C and
52 Fortran examples, this option requires that you have the netCDF
53 library installed on your system.
54 -gui Generate all GUI examples. This option requires that you have
57 the Motif libraries on your system.
58 -anno Generate all annotation examples.
62 -W Specify the workstation type. This argument can only be
65 specified as a string. Some examples are meant to display to
66 the X workstation, to an NCGM file, or to a PostScript file
67 only, in which case this option may be ignored. You cannot
68 specify more than one workstation type. If you don't specify
69 one, then a default one will be used. The following
70 workstation_type strings are valid:
71 ncgm - NCGM file
73 x11 - X11 window
75 ps - PostScript file
77 pdf - PDF file
79 -app Generate all the app Fortran, C, and NCL examples
82 that show how to do specific things with resources.
83 -basic Generate all the basic Fortran, C, and NCL examples
86 that relate to the basic examples discussed in the
87 Quick Start Guide.
88 -contourplot Generate all Fortran, C, and NCL ContourPlot
91 examples.
92 -csagrid Generate all NCL Csagrid examples.
95 -cssgrid Generate all NCL Cssgrid examples.
98 -dsgrid Generate all Fortran, C, and NCL Dsgrid examples.
101 -fitgrid Generate all NCL Natgrid examples.
104 -labelbar Generate all Fortran, C, and NCL Labelbar examples.
107 -legend Generate all Fortran, C, and NCL Legend examples.
110 -natgrid Generate all Fortran, C, and NCL Natgrid examples.
113 -primitives Generate all Fortran, C, and NCL GraphicStyle
116 examples.
117 -mapplot Generate all Fortran, C, and NCL MapPlot examples.
120 -ngmath Generate all Fortran, C, and NCL Ngmath examples.
123 -shgrid Generate all NCL Shgrid examples.
126 -streamlineplot Generate all Fortran, C, and NCL StreamlinePlot
129 examples.
130 -textitem Generate all Fortran, C, and NCL TextItem examples.
133 -tickmark Generate all Fortran, C, and NCL TickMark examples.
136 -title Generate all Fortran, C, and NCL Title examples.
139 -vectorplot Generate all Fortran, C, and NCL VectorPlot examples.
142 -xyplot Generate all Fortran, C, and NCL xyPlot examples.
145 -gsun Generate all the GSUN examples (NCL scripts only).
148 -list Specifies that the names of the selected examples
151 should be echoed to the screen instead of being
152 copied or generated. This option must be used with
153 one of the other options that selects a particular
154 subset of examples. For example, if you want to see
155 a list of all the available examples, then use -list
156 in conjunction with the -A option. If you want to
157 see a list of all the ContourPlot examples, then use
158 -list with the -contourplot option (and so on).
159 -clean Remove everything but the ".ncgm" file.
162 -n Specifies that the example should just be copied, and
165 not linked or executed.
166 name(s) Name(s) of example programs to generate.
169
171 Please notice that the C examples end with the letter 'c', the Fortran
172 examples end with the letter 'f', and NCL examples with the letter 'n'.
173 ap01c,ap01f,ap01n
175 Demonstrates various ways to use resource files.
176 basic01c,basic01f,basic01n
178 Demonstrates how to draw a contour plot using mostly
179 defaults. No data is used in this example.
180 basic02c,basic02f,basic02n
182 Demonstrates how to set the view port and how to produce
183 multiple plots on a single frame.
184 basic03c,basic03f,basic03n
186 Demonstrates how to create a scalar data object, set
187 resources using a resource file, set resources during object
188 creation, and set resources after object creation.
189 basic04c,basic04f,basic04n
191 Demonstrates how to select and change the workstation device
192 for drawing your output to an NCGM file or an X workstation
193 window.
194 basic05c,basic05f,basic05n
196 Demonstrates how to read and manipulate colormaps.
197 basic06c,basic06f,basic06n
199 Demonstrates how to position objects on an output device and
200 how to change their sizes.
201 basic07c,basic07f,basic07n
203 Demonstrates creating three simultaneous workstations.
204 basic08c,basic08f,basic08n
206 Demonstrates use of a procedure that limits a plot, including
207 annotations that extend outside the plot viewport, to a pre-
208 defined bounding box within NDC space.
209 basic09c,basic09f,basic09n
211 Lists all the fonts with their number, name, and what the
212 font looks like.
213 cn01c,cn01f,cn01n
215 Shows all the default settings for the ContourPlot resources
216 using a simple data set.
217 cn02c,cn02f,cn02n
219 Demonstrates basic features of the ContourPlot object.
220 cn03c,cn03f,cn03n
222 Demonstrates basic features of the ContourPlot object. The
223 first frame emulates the contour plot drawn in cn01.
224 cn04c,cn04f,cn04n
226 Emulates the output of the ncargex example "cpex02".
227 cn05c,cn05f,cn05n
229 Demonstrates how to create a map plot animation with a
230 contour overlay and labelbar annotation.
231 cn06c,cn06f,cn06n
233 Shows how to read a netCDF file and produce a series of
234 temperature contour plots.
235 cn07c,cn07f,cn07n
237 Shows how to read a netCDF file and produce a series of
238 contour plots.
239 cn08c,cn08f,cn08n
241 Shows how to read a netCDF file and draw a vertical profiles
242 of temperature for longitude separated by 5 degrees.
243 cn09c,cn09f,cn09n
245 Shows how to read a netCDF file and produce a series of
246 surface pressure contour plots.
247 cn10f,cn10c,cn10n
249 Demonstrates how to read a netCDF file and produce three
250 contour plots, an xyplot, and a map plot.
251 cn11c,cn11f
253 Demonstrates how to combine LLU and HLU calls.
254 cn12c,cn12f,cn12n
256 Emulates example "cpex08" and draws a filled contour plot
257 over a map of Africa with a labelbar.
258 cn13c,cn13f,cn13n
260 Emulates example "mpex10" and draws a raster contour plot
261 over a map using inverse map transformations.
262 cn14c,cn14f,cn14n
264 Shows how to do a contour/map overlay with tick marks showing
265 the lat/lon locations.
266 cn15c,cn15f,cn15n
268 Shows how to combine contour plot and xy plot on a single
269 frame. Also shows how to do multiple workstation outputs, and
270 how to position your PostScript output on the page.
271 cn16c,cn16f,cn16n
273 Shows how to combine a vector fill contour plot, a raster
274 contour plot, and a map plot on a single frame.
275 cn17c,cn17f,cn17n
277 Shows how to restrict a contour plot to a certain area over a
278 satellite projection, how to label the US states with
279 AnnoManager, how to use NhlDataPoly{line,marker} to draw
280 lines/markers on a map projection, and how to mix LLUs/HLUs
281 to draw text in the map projection. The NCL version doesn't
282 have the LLU/HLU part.
283 lb01c,lb01f,lb01n
285 Shows all the default settings for the LabelBar resources.
286 lb02c,lb02f,lb02n
288 Shows how to modify some of the default resources to create a
289 solid filled set of boxes.
290 lg01c,lg01f,lg01n
292 Shows all the default settings for the Legend resources.
293 lg02c,lg02f,lg02n
295 Shows how to modify some of the default resources to create a
296 legend of five markers.
297 lg03c,lg03f,lg03n
299 Shows how to create a legend of five lines.
300 pr01c,pr01f,pr01n
302 Demonstrates basic GraphicStyle capabilities.
303 pr02c,pr02f,pr02n
305 Demonstrates GraphicStyle capabilities and how to some GS
306 resources.
307 pr03c,pr03f,pr03n
309 Demonstrates graphics primitives drawn in NDC space and how
310 clipping works.
311 pr04c,pr04f,pr04n
313 Demonstrates graphics primitives drawn into an IrregularPlot
314 object.
315 pr05c,pr05f,pr05n
317 Demonstrates overlaying graphics primitives on a MapPlot.
318 mp01c,mp01f,mp01n
320 Demonstrates basic MapPlot capabilities.
321 mp02c,mp02f,mp02n
323 Demonstrates individual control of MapPlot areas.
324 mp03c,mp03f,mp03n
326 Demonstrates MapPlot masking; loosely emulates the ncargex
327 example "colcon".
328 mp04c,mp04f,mp04n
330 Illustrates the use of AnnoManager objects with MapPlot
331 objects.
332 mp05c,mp05f,mp05n
334 Shows how to create the ten different map projections.
335 mp06c,mp06f,mp06n
337 Shows how to draw county lines in the United States.
338 mp07c,mp07f,mp07n
340 Shows how to use high resolution RANGS/GSHHS map database.
341 nm01c,nm01f,nm01n
343 Simple example of natural neighbor linear interpolation.
344 nm02c,nm02f,nm02n
346 Simple example of natural neighbor linear regridding.
347 nm03c,nm03f,nm03n
349 Shows how to retrieve aspects and slopes of an interpolation.
350 nm04c,nm04f,nm04n
352 Shows a simple 3D interpolation.
353 nm05c,nm05f,nm05n
355 Shows how to vary the exponent of the distances in a simple
356 2D interpolation..
357 nm06c,nm06f,nm06n
359 Smoothing in a simple 2D interpolation.
360 nm07n Illustrates use of ftcurv, ftcurv, and ftcurvi.
362 nm08n Illustrates use of ftcurvp and ftcurvpi.
364 nm09n Illustrates use of ftcurvs and ftcurvps.
366 nm10n Illustrates use of ftkurv and ftkurvd.
368 nm11n Illustrates use of ftkurvp and ftkurvpd.
370 nm12n Illustrates use of ftsurf.
372 nm13n Illustrates the use of csa1s.
374 nm14n Illustrates the effect of weighting the input points using
376 csa1xs.
377 nm15n Illustrates extrapolation into data sparse regions using
379 csa1xs.
380 nm16n Illustrates two-dimensional approximation and second-order
382 mixed partial using csa2s and csa2xs.
383 nm17n,nm18n
385 Illustrates the use of csa3s.
386 nm19n Illustrates the use of csa2ls.
388 nm20n Illustrates the use of triangulation and Voronoi diagram
390 capabilities of the cssgrid package.
391 nm21n Illustrates the use of the interpolation capabilities of the
393 cssgrid package.
394 nm22n Illustrates the use of shgrid. cssgrid package.
396 st01c,st01f,st01n
398 Demonstrates basic StreamlinePlot example.
399 st02c,st02f,st02n
401 Demonstrates line-drawn streamline arrows and some basic
402 resources.
403 st03c,st03f,st03n
405 Shows how to overlay a StreamlinePlot on a map projection.
406 st04c,st04f,st04n
408 Shows a StreamlinePlot of wind vector data over a MapPlot.
409 ti01c,ti01f,ti01n
411 Shows all the default settings for the Title resources which
412 results in a blank plot.
413 ti02c,ti01f,ti01n
415 Turns on the main, x-axis, and y-axis strings to produce a
416 plot with three titles.
417 ti03c,ti03f,ti03n
419 Shows how to change resources to get high quality filled and
420 colored titles.
421 tm01c,tm01f,tm01n
423 Shows all the default settings for the TickMark resources.
424 tm02c,tm02f,tm02n
426 Shows how to modify the resources to create tick marks on the
427 axes.
428 tm03c,tm03f,tm03n
430 Shows how to modify the resources to change the scaling and
431 the tick mark labels.
432 tx01c,tx01f,tx01n
434 Shows all the default settings for the TextItem resources.
435 tx02c,tx02f,tx02n
437 Shows how to modify default resources to produce a text
438 string.
439 tx03c,tx03f,tx03n
441 Uses the same resources as example "tx02c", except 114 frames
442 are produced with varying background colors.
443 tx04c,tx04f,tx04n
445 Shows how to use the TextItem object of the HLU library.
446 tx05c,tx05f,tx05n
448 Demonstrates the TextItem object with text having various
449 heights and various angles.
450 tx06c,tx06f,tx06n
452 Demonstrates TextItem text justifications.
453 tx07c,tx07f,tx07n
455 Demonstrates TextItem text spacings and aspect ratios.
456 tx08c,tx08f,tx08n
458 Simple Annotation example.
459 vc01c,vc01f,vc01n
461 Basic VectorPlot example.
462 vc02c,vc02f,vc02n
464 Demonstrates line-drawn vector arrows and the use of some
465 basic VectorPlot resources.
466 vc03c,vc03f,vc03n
468 Manipulates the FillArrow resources to demonstrate some of
469 the possible stylistic variations on the appearance of filled
470 vector arrows.
471 vc04c,vc04f,vc04n
473 Demonstrates how to rotate a VectorPlot 90 degrees while
474 preserving the original relationship of the data elements.
475 vc05c,vc05f,vc05n
477 Demonstrates how to overlay a VectorPlot on a MapPlot.
478 vc06c,vc06f,vc06n
480 Demonstrates how to use a scalarfield to determine the color
481 of the vector arrow fill.
482 vc07c,vc07f,vc07n
484 Emulates the LLU example "fcover"; shows how to overlay
485 contours and vectors on a MapPlot.
486 vc08c,vc08f,vc08n
488 Plots wind vectors at a grid stride of 3. Vectors are colored
489 by wind speed.
490 vc09c,vc09f,vc09n
492 Plots an animation of the January 1996 snow storm using wind
493 vectors colored by temperature over a pressure field contour
494 plot.
495 xy01c,xy01f,xy01n
497 Shows all the default resources for an xyPlot object.
498 xy02c,xy02f,xy02n
500 The same as example xy01c, only with some of the X and Y axis
501 resources tweaked.
502 xy03c,xy03f,xy03n
504 The same as example xy01c, but with the data modified a
505 little, and the line resources tweaked.
506 xy04c,xy04f,xy04n
508 Demonstrates how to create an xyPlot with multiple lines.
509 Some of the line resources are tweaked.
510 xy05c,xy05f,xy05n
512 Demonstrates how to create an XyPlot with multiple lines,
513 using multiple data items (except for xy05c, which uses the
514 CoordArrTable object).
515 xy06c,xy06f,xy06n
517 Demonstrates how to read in netCDF files to generate various
518 xy plots.
519 xy07c,xy07f,xy07n
521 Demonstrates how to draw a "scattergram".
522 xy08c,xy08f,xy08n
524 Shows how to use irregular points to change the
525 transformation of your plot.
526 xy09c,xy09f,xy09n
528 Shows how to create different kinds of axes.
529 xy10c,xy10f,xy10n
531 Shows how to overlay an XyPlot on a MapPlot.
532 xy11c,xy11f,xy11n
534 Demonstrates how to display an xyPlot to an X Window, and
535 then copy it to a meta file.
536 xy12c Demonstrates how to incorporate the HLU library with a GUI.
538 It uses an X/Motif interface, and also allows the user to
539 copy frames from the X Window to a meta file.
540 xy13c Shows how to interactively retrieve data values from a plot
542 by pointing and clicking on the plot.
543 xy14c,xy14f,xy14n
545 Demonstrates the data manipulation capabilities of NCL.
546 xy15c,xy15f,xy15n
548 Demonstrates the creation of a set of four stacked XyPlots.
549 xy16c,xy16f,xy16n
551 Demonstrates how to draw three different xy lines on the same
552 plot, but with different axis scales.
553 xy17c,xy17f,xy17n
555 Demonstrates how to stack three xy plots.
556
558 ncargex(1NCARG)
559
561 Copyright (C) 1987-2000
562 University Corporation for Atmospheric Research
563 The use of this Software is governed by a License Agreement.
564 NCARG Nhl EXAMPLES ng4ex(1Nhl)