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  a  small subroutine to be linked in that helps
321                         force the loading of  blockdata  initialization  rou‐
322                         tines.
323
324                         Note:  this option doesn't need to be specified sepa‐
325                         rately if you are already including the -ncarbd   and
326                         -ngmath options.
327
328
329       -noX11            Do  not  link  in  the  X  library  when  linking the
330                         selected examples  and/or  tests.   A  stub  will  be
331                         linked instead.
332
333
334       -onebyone         Specifies  that  the  selected  examples and/or tests
335                         should be generated one at a time and viewed as  they
336                         are generated.  This is intended for use during test‐
337                         ing of new releases at NCAR.
338
339                         Below is a list of all the  available  ncargex  exam‐
340                         ples.   They  are  listed  according to which utility
341                         they belong with.
342
343

EXAMPLES AVAILABLE

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

COPYRIGHT

564       Copyright (C) 1987-2002
565       University Corporation for Atmospheric Research
566
567       This documentation is free software; you  can  redistribute  it  and/or
568       modify  it  under  the  terms of the GNU General Public License as pub‐
569       lished by the  Free  Software  Foundation;  either  version  2  of  the
570       License, or (at your option) any later version.
571
572       This  software  is  distributed in the hope that it will be useful, but
573       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
574       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
575       Public License for more details.
576
577       You should have received a copy of the GNU General Public License along
578       with  this  software;  if  not,  write to the Free Software Foundation,
579       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
580
581
582
583NCAR                               June 1998                   NCARGEX(1NCARG)

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES AVAILABLE

SEE ALSO

COPYRIGHT