ncargex(1)

1NCARGEX(1NCARG)                  NCAR GRAPHICS                 NCARGEX(1NCARG)
2
3
4

NAME

6       ncargex - NCAR Graphics Fortran and C Low-Level Utility Examples
7

SYNOPSIS

9       ncargex [-A] [-E] [-F] [-P] [-T]
10       [-U] [-C] [-Fortran] [-class] [-ps]
11       [-x11] [-W workstation_type] [-areas]
12       [-autograph] [-bivar] [-colconv] [-conpack]
13       [-conpackt] [-conran_family] [-conrec_family]
14       [-csagrid] [-cssgrid] [-dashline] [-dashpack]
15       [-dsgrid] [-ezmap] [-field_flow] [-fitgrid]
16       [-gflash] [-gks] [-gridall] [-halftone]
17       [-histogram] [-isosrfhr] [-isosurface] [-labelbar]
18       [-natgrid] [-ngmath] [-ngmisc] [-plotchar]
19       [-polypack] [-pwrite_family] [-scrolled_title]
20       [-seter] [-shgrid] [-softfill] [-spps]
21       [-streamlines] [-surface] [-tdpack] [-threed]
22       [-vaspackt] [-vectors] [-wmap] [-misc]
23       [-clean] [-n] [-ncarbd] [-noX11] [-onebyone]
24       example_name ...
25

DESCRIPTION

27       ncargex provides the user with access to over 300 complete example NCAR
28       Graphics Fortran and C source codes, including the examples in the NCAR
29       Graphics  Tutorial.  ncargex  copies  the source code for the specified
30       example(s) into the current directory and  then  compiles,  links,  and
31       executes  the  example.  Depending on the type of workstation specified
32       on the command line, the output may either be an  NCGM  (NCAR  Graphics
33       Metafile)  file, one of many types of PostScript files, or a text dump.
34       It is also possible for no output to be  produced  if  you  select  the
35       "x11"  workstation, in which case each frame is displayed directly to a
36       separate X window after it is generated.  If no workstation  is  speci‐
37       fied  on  the  command  line, then it defaults to an "NCGM", unless the
38       example is a special one which is discussed below.
39
40       If you select one of the workstation  types  that  produces  an  output
41       file,  then  the  file  name will have the same name as the example and
42       ending with an appropriate suffix: ".ncgm", ".txt", ".ps", etc.
43
44       Certain examples were created to  demonstrate  a  particular  function,
45       like  how  to  rename your metafile from within the program, how to use
46       the full page when going to PostScript  output,  how  to  use  the  X11
47       driver  and produce a graphic file at the same time, etc.  If the exam‐
48       ple that you ask for is one of these, a message will be printed to this
49       effect to alert you.
50
51       In  order  to  run  ncargex,  you must have your NCARG_ROOT environment
52       variable set to the parent directory where the NCAR Graphics libraries,
53       binaries,  and include files were installed.  If this environment vari‐
54       able is not set, ncargex will attempt to set it for you.  If  the  NCAR
55       Graphics  libraries,  binaries,  and  include  files were not installed
56       under one parent directory, then you will need to set  the  environment
57       variables  NCARG_LIB, NCARG_BIN, and NCARG_INCLUDE instead.  Please see
58       "man ncargintro" for more information.
59
60

OPTIONS

62       -W     Specify the workstation type.  This argument can be specified as
63              a number or as a string, where the number has the same value you
64              would use in a call to GOPWK.  The following numbers are valid:
65
66                    1    -  NCGM
67
68                    8    -  X11 window.
69
70                   10    -  text dump of graphics output.
71
72                   20    -  color PostScript in portrait mode.
73
74                   21    -  color Encapsulated PostScript  (EPS)  in  portrait
75                         mode.
76
77                   22    -   color  Encapsulated PostScript Interchange format
78                         (EPSI) in portrait mode.
79
80                   23    -  monochrome PostScript in portrait mode.
81
82                   24    -  monochrome Encapsulated PostScript (EPS)  in  por‐
83                         trait mode.
84
85                   25    -   monochrome  Encapsulated  PostScript  Interchange
86                         format (EPSI) in portrait mode.
87
88                   26    -  color PostScript in landscape mode.
89
90                   27    -  color Encapsulated PostScript (EPS)  in  landscape
91                         mode.
92
93                   28    -   color  Encapsulated PostScript Interchange format
94                         (EPSI) in landscape mode.
95
96                   29    -  monochrome PostScript in landscape mode.
97
98                   30    -  monochrome Encapsulated PostScript (EPS) in  land‐
99                         scape mode.
100
101                   31    -   monochrome  Encapsulated  PostScript  Interchange
102                         format (EPSI) in landscape mode.
103
104
105
106       If you want to specify the workstation as a string, then  there  are  a
107       few  ways  this  can  be  done.  For example, the following workstation
108       types are valid:
109
110                    ncgm -  NCGM
111
112                    x11  -  X11 window
113
114                   text  -  text dump of graphics output
115
116
117
118       For PostScript output, there are more attributes:  the  type  of  Post‐
119       Script  you  file want ("ps", "eps", or "epsi"), whether you want color
120       or monochrome ("color" or "mono"), and whether  you  want  portrait  or
121       landscape mode ("port" or "land").  The orientation and the color pref‐
122       erence can be omitted (as they will will default to "port" and  "color"
123       respectively),  but  you  must  specify the PostScript file type.  Each
124       attribute can be entered in any order, separated by periods.  The  fol‐
125       lowing are examples of valid PostScript workstation types:
126
127       ps.color          - color PostScript in portrait mode.
128
129       land.eps.mono     -  monochrome Encapsulated PostScript format (EPS) in
130                         landscape mode.
131
132       epsi              - color Encapsulated  PostScript  Interchange  format
133                         (EPSI) in portrait mode.
134
135       port.mono.ps      -  monochrome PostScript in portrait mode.
136
137                         Any  combination  of  these three types of attributes
138                         can be used, as long as one of them is the PostScript
139                         file type.
140
141
142       -A                Generate  all  available  C/Fortran  examples, tests,
143                         programmer doc, fundamental and tutorial examples.
144
145
146       -E                Generate all available C/Fortran examples.
147
148
149       -F                Generate all available  fundamental  C/Fortran  exam‐
150                         ples.
151
152
153       -P                Generate all available programmer doc C/Fortran exam‐
154                         ples.
155
156
157       -T                Generate all available tests.
158
159
160       -U                Generate all available tutorial C/Fortran examples.
161
162
163       -C                Generate all available C examples.
164
165
166       -Fortran          Generate all available Fortran examples.
167
168
169       -class            Generate all available class C/Fortran examples.
170
171
172       -ps               Generate all C/Fortran examples that  use  the  Post‐
173                         Script driver.
174
175
176       -x11              Generate  all  C/Fortran  examples  that  use the X11
177                         driver.
178
179
180       -areas            Generate all Areas C/Fortran examples.
181
182
183       -autograph        Generate all Autograph C/Fortran examples.
184
185
186       -bivar            Generate all bivar C/Fortran examples.
187
188
189       -colconv          Generate all Colconv C/Fortran examples.
190
191
192       -conpack          Generate all Conpack C/Fortran examples.
193
194
195       -conpackt         Generate all Conpackt C/Fortran examples.
196
197
198       -conran_family    Generate all Conran Fortran examples.
199
200
201       -conrec_family    Generate all Conrec Fortran examples.
202
203
204       -csagrid          Generate all Ngmath Csagrid C/Fortran examples.
205
206
207       -cssgrid          Generate all Ngmath Cssgrid C/Fortran examples.
208
209
210       -dashline         Generate all Dashline C/Fortran examples.
211
212
213       -dashpack         Generate all Dashpack C/Fortran examples.
214
215
216       -dsgrid           Generate all Ngmath Dsgrid C/Fortran examples.
217
218
219       -ezmap            Generate all Ezmap C/Fortran examples.
220
221
222       -field_flow       Generate all Field_flow C/Fortran examples.  Includes
223                         streamlines and vectors examples.
224
225
226       -fitgrid          Generate all Ngmath Fitgrid C/Fortran examples.
227
228
229       -gflash           Generate all Gflash C/Fortran examples.
230
231
232       -gks              Generate all GKS C/Fortran examples.
233
234
235       -gridall          Generate all Gridall C/Fortran examples.
236
237
238       -halftone         Generate all Halftone Fortran examples.
239
240
241       -histogram        Generate all Histogram C/Fortran examples.
242
243
244       -isosrfhr         Generate all Isosrfhr Fortran examples.
245
246
247       -isosurface       Generate all Isosurface C/Fortran examples.
248
249
250       -labelbar         Generate all Labelbar C/Fortran examples.
251
252
253       -natgrid          Generate all Ngmath Natgrid C/Fortran examples.
254
255
256       -ngmath           Generate all Ngmath C/Fortran examples.
257
258
259       -ngmisc           Generate all Ngmisc C/Fortran examples.
260
261
262       -plotchar         Generate all Plotchar C/Fortran examples.
263
264
265       -polypack         Generate all Polypack C/Fortran examples.
266
267
268       -pwritx_family    Generate all Pwrite Fortran examples.
269
270
271       -scrolled_title   Generate all Scrolled title C/Fortran examples.
272
273
274       -seter            Generate all Seter C/Fortran examples.
275
276
277       -shgrid           Generate all Ngmath Shgrid C/Fortran examples.
278
279
280       -softfill         Generate all Softfill C/Fortran examples.
281
282
283       -spps             Generate all SPPS C/Fortran examples.
284
285
286       -streamlines      Generate all Streamlines C/Fortran examples.
287
288
289       -surface          Generate all Surface C/Fortran examples.
290
291
292       -tdpack           Generate all Tdpack C/Fortran examples.
293
294
295       -threed           Generate all Threed C/Fortran examples.
296
297
298       -vaspackt         Generate all Vaspackt C/Fortran examples.
299
300
301       -vectors          Generate all Vectors C/Fortran examples.
302
303
304       -wmap             Generate all Weather map C/Fortran examples.
305
306
307       -misc             Generate all miscellaneous C/Fortran examples.
308
309
310       -clean            Remove everything but the ".ncgm" file.
311
312
313       -n                Specifies  that  the  example should not be compiled,
314                         linked, or run,  but  just  copied  into  your  local
315                         directory.
316
317
318       -ncarbd           Use  this option for compilers that appear to be hav‐
319                         ing trouble initializing blockdata variables. It will
320                         cause  one  or  two small subroutines to be linked in
321                         that helps force the loading of blockdata initializa‐
322                         tion routines.
323
324
325       -ngmathbd         Use  this option for compilers that appear to be hav‐
326                         ing trouble initializing blockdata variables. It will
327                         cause  a  small subroutine to be linked in that helps
328                         force the loading of  blockdata  initialization  rou‐
329                         tines.
330
331                         Note:  this option doesn't need to be specified sepa‐
332                         rately if you are already including the -ncarbd   and
333                         -ngmath options.
334
335
336       -noX11            Do  not  link  in  the  X  library  when  linking the
337                         selected examples  and/or  tests.   A  stub  will  be
338                         linked instead.
339
340
341       -onebyone         Specifies  that  the  selected  examples and/or tests
342                         should be generated one at a time and viewed as  they
343                         are generated.  This is intended for use during test‐
344                         ing of new releases at NCAR.
345
346                         Below is a list of all the  available  ncargex  exam‐
347                         ples.   They  are  listed  according to which utility
348                         they belong with.
349
350

EXAMPLES AVAILABLE

352       AREAS Examples:
353
354       arex01 arex02 arex03 cardb1 cardb2 caredg carfill carline carmap tareas
355       c_tareas
356
357       AUTOGRAPH Examples:
358
359       agdp01  agex01  agex02 agex03 agex04 agex05 agex06 agex07 agex08 agex09
360       agex10  agex11  agex12  agex13  fagaxclr  fagaxlbl  fagaxmax   fagcuclr
361       fagcudsh  fagezmxy fagezmy fagezxy fagezy fagilclr fagovrvw tagupw tau‐
362       tog c_agex07
363
364       BIVAR Examples:
365
366       cbex01 cidsfft c_cbex01
367
368       COLCONV Examples:
369
370       coex01 coex02 coex03 fcce01 fcce02 tcolcv c_coex02
371
372       CONPACK Examples:
373
374       cbex01 ccpback ccpcff ccpcfx ccpcica ccpcir ccpcis ccpcit ccpclc ccpcld
375       ccpcldm ccpcldr ccpcll ccpclu ccpcnrc ccpdflt ccpezct ccpfil ccpga ccp‐
376       hand ccphcf ccphl ccphlt ccpila ccpils ccpilt  ccpklb  ccplbam  ccplbdr
377       ccpline ccpllb ccpllc ccplll ccpllo ccpllp ccpllt ccpllw ccpmap ccpmovi
378       ccpmpxy ccpncls ccpnet ccpnof ccpnsd ccppc ccppc1 ccppc2 ccppc3  ccppc4
379       ccppkcl ccppole ccprc ccprect ccprwc ccprwu ccpscam ccpset ccpsps1 ccp‐
380       sps2 ccpspv ccpt2d ccptitle ccpvp ccpvs cidsfft  colcon  cpex01  cpex02
381       cpex03  cpex04  cpex05 cpex06 cpex07 cpex08 cpex09 cpex10 cpex11 cpex12
382       cpex13 cpex14 cpex15 cpex16 tconpa c_cbex01 c_colcon
383
384       CONPACKT Examples:
385
386       ctcbay ctex01 ctex02 ctfite ctgaus ctgc23 ctgeo1 ctgeo2  ctgeo3  ctiscp
387       ctisc2  ctllg1  ctllg2 ctllg3 ctnccl ctorca ctpopg ctswth ctterr ctwng1
388       ctwng2 cttd01 cttd02 c_ctllg3
389
390       CONRAN FAMILY Examples:
391
392       tconan tconaq tconas
393
394       CONREC FAMILY Examples:
395
396       tcnqck tcnsmt tcnsup tconre
397
398       CSAGRID Examples:
399
400       csex01 csex02 csex03 csex04  csex05  csex06  csex07  c_csex01  c_csex02
401       c_csex03 c_csex04 c_csex05 c_csex06 c_csex07
402
403       CSSGRID Examples:
404
405       cssex01 cssex02 cssex03 c_cssex01 c_cssex02 c_cssex03
406
407       DASHLINE Examples:
408
409       fdlcurvd  fdldashc  fdldashd fdlsmth tdashc tdashl tdashp tdashs c_fdl‐
410       dashc
411
412       DASHPACK Examples:
413
414       tdshpk c_tdshpk
415
416       DSGRID Examples:
417
418       dsex01 dsex01d dsex02 dsex03 dsex04 dsex05  dsex06  c_dsex01  c_dsex01d
419       c_dsex02 c_dsex03 c_dsex04 c_dsex05 c_dsex06
420
421       EZMAP Examples:
422
423       cezmap1  cezmap2 cezmap3 cmpclr cmpdd cmpdrw cmpel cmpfil cmpgci cmpgrd
424       cmpgrp cmpita cmpitm cmplab cmplbl cmplot cmpmsk  cmpou  cmppos  cmpsat
425       cmpsup  cmptit  cmptra cmpusr eezmpa mpex01 mpex02 mpex03 mpex04 mpex05
426       mpex06 mpex07 mpex08 mpex09 mpex10 mpex11 mpex12 mpex13  mpex14  mpex15
427       mpexfi tezmap tezmpa tezmpb c_mpex05 c_eezmpa c_eezmpb
428
429       FIELD FLOW Examples:
430
431       ffex00  ffex01 ffex02 ffex03 ffex04 ffex05 fcover fstream stex01 stex02
432       stex03 vvex01 vvex02 vvex03 c_ffex03 c_vvex03
433
434       FITGRID Examples:
435
436       ftex01 ftex02 ftex03 ftex04 ftex05 ftex06  c_ftex01  c_ftex02  c_ftex03
437       c_ftex04 c_ftex05 c_ftex06
438
439       GFLASH Example:
440
441       tgflas c_tgflas
442
443       GKS Examples:
444
445       fcell  fcell0 fgke01 fgke02 fgke03 fgke04 fgkgpl fgkgpm fgkgtx fgklnclr
446       fgklnwth fcirc fgpm01 pgkex01 pgkex02 pgkex03 pgkex04  pgkex05  pgkex06
447       pgkex07 pgkex08 pgkex09 pgkex10 pgkex11 pgkex12 pgkex13 pgkex14 pgkex15
448       pgkex16 pgkex17 pgkex18 pgkex19 pgkex20 pgkex21 pgkex22 pgkex23 pgkex24
449       pgkex25 pgkex26 pgkex27 c_gtxpac c_pgkex21
450
451       GRIDALL Example:
452
453       ccpga tgrida c_tgrida
454
455       HALFTONE Example:
456
457       thafto
458
459       HISTOGRAM Examples:
460
461       thstgr thstmv c_thstmv
462
463       ISOSRFHR Example:
464
465       tisohr
466
467       ISOSURFACE Examples:
468
469       fisissrf fispwrzi tisosr tpwrzi c_tisosr
470
471       LABELBAR Examples:
472
473       elblba tlblba clbfil clbbar clblbr c_elblba
474
475       NATGRID Examples:
476
477       nnex01  nnex01d nnex02 nnex03 nnex04 nnex05 nnex06 nnex07 nnex08 nnex09
478       c_nnex01 c_nnex01d c_nnex02 c_nnex03 c_nnex06
479
480       NGMATH Examples:
481
482       csex01 csex02  csex03  csex04  csex05  csex06  csex07  cssex01  cssex02
483       cssex03 dsex01 dsex01d dsex02 dsex03 dsex04 dsex05 dsex06 ftex01 ftex02
484       ftex03 ftex04 ftex05 ftex06 nnex01 nnex01d nnex02 nnex03 nnex04  nnex05
485       nnex06  nnex07  nnex08  nnex09  shex01  shex02 shex03 c_csex01 c_csex02
486       c_csex03  c_csex04  c_csex05  c_csex06  c_csex07  c_cssex01   c_cssex02
487       c_cssex03   c_dsex01  c_dsex01d  c_dsex02  c_dsex03  c_dsex04  c_dsex05
488       c_dsex06 c_ftex01 c_ftex02 c_ftex03 c_ftex04 c_ftex05 c_ftex06 c_nnex01
489       c_nnex01d c_nnex02 c_nnex03 c_nnex06 c_shex01 c_shex02 c_shex03
490
491       NGMISC Examples:
492
493       fngngdts fngwsym c_fngwsym
494
495       PLOTCHAR Examples:
496
497       epltch fpchiqu fpcloqu fpcfonts tpltch c_epltch
498
499       POLYPACK Examples:
500
501       ppex01 tppack c_ppex01
502
503       PWRITE FAMILY Examples:
504
505       tpwrtx tpwry
506
507       SCROLLED TITLE Examples:
508
509       fslfont slex01 slex02 tstitl c_slex01
510
511       SETER Examples:
512
513       tseter
514
515       SHGRID Examples:
516
517       shex01 shex02 shex03 c_shex01 c_shex02 c_shex03
518
519       SOFTFILL Examples:
520
521       fsfsgfa fsfwrld sfex01 sfex02 tsoftf c_sfex02
522
523       SPPS Examples:
524
525       fcoord fcoord1 fcoord2 fspcurve fspline fsppoint fspponts splogy sprevx
526       c_fcoord2
527
528       STREAMLINES Examples:
529
530       fstream  ffex00  ffex01  ffex03  ffex04  stex01  stex02  stex03  tstrml
531       c_ffex03
532
533       SURFACE Examples:
534
535       fsrezsrf fsrpwrzs fsrsrfac srex01 tsrfac tpwrzs c_srex01
536
537       TDPACK Examples:
538
539       tdex01  tdex02  tdex03  tdex04  tdex05  tdex06  tdex07  tdex08 c_tdex01
540       c_tdex03
541
542       THREED Examples:
543
544       fthex01 fthex02 fthex03 fthex04 fthex05 tthree tpwrzt c_fthex01
545
546       VECTORS Examples:
547
548       ffex00 ffex01 ffex02 ffex05 fcover tvelvc vvex01 vvex02 vvex03 c_vvex03
549
550       WEATHER MAP Examples:
551
552       wmex01 wmex02 wmex03 wmex04 wmex05 wmex06 wmex07 wmex08  wmex09  wmex10
553       wmex11 wmex12 wmex13 wmex14 wmex15 c_wmex09
554
555       Miscellaneous Examples:
556
557       bnchmk example ncargworld
558
559       X11 Examples:
560
561       fgke01 fgke04 c_xwndws
562
563

COPYRIGHT

571       Copyright (C) 1987-2002
572       University Corporation for Atmospheric Research
573       The use of this Software is governed by a License Agreement.
574
575
576
577NCAR                               June 1998                   NCARGEX(1NCARG)

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES AVAILABLE

SEE ALSO

COPYRIGHT