Running LLU examples with the ncargex command

The ncargex command copies, compiles, and runs NCAR Graphics Low Level Utility (LLU) examples in your local directory. These examples demonstrate how to use the LLUs to create an NCAR Graphics application. A similar command called ng4ex is used to copy, compile, and run NCAR Graphics 4.x examples that demonstrate how to use the High Level utilities (HLUs) and NCL.

Depending on the example, the output graphic may be displayed in a workstation window or output to a file. More information on the ncargex command is provided in the ncargex man page; it is copied here:

     ncargex - NCAR Graphics  Fortran  and  C  Low-Level  Utility
     ncargex [-A] [-E] [-F] [-P] [-T] [-U] [-C] [ - Fortran]  [ -
     class]  [ -ps] [-x11] [-W workstation_type] [-areas] [-auto-
     graph] [-bivar] [-colconv] [-conpack] [- conran_family]  [ -
     conrec_family]  [ - dashline]  [ - dashpack]  [ - ezmap]  [-
     field_flow] [-gflash] [-gks] [-gridall] [-halftone] [-histo-
     gram]  [ - isosrfhr]  [-isosurface] [-labelbar] [-ngmath] [-
     ngmisc] [- plotchar]  [ - polypack]  [ - pwrite_family]  [ -
     scrolled_title]  [-seter] [-softfill] [-spps] [-streamlines]
     [-surface] [-threed] [-vectors] [-wmap] [-misc] [-clean] [ -
     n] [-noX11] [-onebyone] example_name ...
     ncargex provides the user with access to over  300  complete
     example  NCAR Graphics Fortran and C source codes, including
     the examples in the NCAR Graphics Tutorial.  ncargex  copies
     the  source  code  for  the  specified  example(s)  into the
     current directory and then compiles, links, and executes the
     example.   Depending on the type of workstation specified on
     the command line, the output may either  be  an  NCGM  (NCAR
     Graphics  Metafile)  file,  one  of many types of PostScript
     files, or a text dump.  It is also possible for no output to
     be  produced  if  you select the "x11" workstation, in which
     case each frame is displayed directly to a separate X window
     after  it  is  generated.  If no workstation is specified on
     the command line, then it defaults to an "NCGM", unless  the
     example is a special one which is discussed below.
     If you select one of the workstation types that produces  an
     output  file,  then the file name will have the same name as
     the example and ending with an appropriate suffix:  ".ncgm",
     ".txt", ".ps", etc.
     Certain examples were created to  demonstrate  a  particular
     function,  like  how to rename your metafile from within the
     program, how to use the full page when going  to  PostScript
     output, how to use the X11 driver and produce a graphic file
     at the same time, etc.  If the example that you ask  for  is
     one     alert you.
     In order to run  ncargex,  you  must  have  your  NCARG_ROOT
     environment  variable  set to the parent directory where the
     NCAR Graphics libraries, binaries, and  include  files  were
     installed.  If this environment variable is not set, ncargex
     will attempt to set  it  for  you.   If  the  NCAR  Graphics
     libraries,  binaries,  and  include files were not installed
     under one parent directory, then you will need  to  set  the
     environment     variables    NCARG_LIB,    NCARG_BIN,    and
     NCARG_INCLUDE instead.  Please see "man ncargintro" for more
     -W    Specify the workstation type.  This  argument  can  be
          specified  as a number or as a string, where the number
          has the same value you would use in a  call  to  GOPWK.
          The following numbers are valid:
                  1    -  NCGM
                  8    -  X11 window.
                 10    -  text dump of graphics output.
                 20    -  color PostScript in portrait mode.
                 21    -  color Encapsulated PostScript (EPS)  in
                       portrait mode.
                 22    -  color  Encapsulated  PostScript  Inter-
                       change format (EPSI) in portrait mode.

                 23    -  monochrome PostScript in portrait mode.
                 24    -   monochrome   Encapsulated   PostScript
                       (EPS) in portrait mode.
                 25    -   monochrome   Encapsulated   PostScript
                       Interchange   format  (EPSI)  in  portrait
                 26    -  color PostScript in landscape mode.
                 27    -  color Encapsulated PostScript (EPS)  in
                       landscape mode.
                 28    -  color  Encapsulated  PostScript  Inter-
                       change format (EPSI) in landscape mode.
                 29    -   monochrome  PostScript  in   landscape
                 30    -   monochrome   Encapsulated   PostScript

                       (EPS) in landscape mode.
                 31    -   monochrome   Encapsulated   PostScript
                       Interchange  format  (EPSI)  in  landscape
     If you want to specify the workstation  as  a  string,  then
     there  are  a  few  ways this can be done.  For example, the
     following workstation types are valid:
                  ncgm -  NCGM
                  x11  -  X11 window
                 text  -  text dump of graphics output
     For PostScript output, there are more attributes:  the  type
     of  PostScript  you  file  want  ("ps",  "eps",  or "epsi"),
     whether you want color or monochrome  ("color"  or  "mono"),
     and  whether  you want portrait or landscape mode ("port" or
     "land").  The orientation and the color  preference  can  be
     omitted  (as  they  will  will default to "port" and "color"
     respectively), but you  must  specify  the  PostScript  file
     type.  Each attribute can be entered in any order, separated
     by periods.  The following are examples of valid  PostScript
     workstation types:
     ps.color          - color PostScript in portrait mode.
     land.eps.mono     - monochrome Encapsulated PostScript  for-
                       mat (EPS) in landscape mode.
     epsi              -  color  Encapsulated  PostScript  Inter-
                       change format (EPSI) in portrait mode.      -  monochrome PostScript in portrait mode.
                       Any combination of these  three  types  of
                       attributes  can be used, as long as one of
                       them is the PostScript file type.
     -A                 Generate all  available  C/Fortran  exam-
                       ples,  tests,  programmer doc, fundamental
                       and tutorial examples.
     -E                 Generate all  available  C/Fortran  exam-
      - F                 Generate  all   available   fundamental
                       C/Fortran examples.
     -P                 Generate  all  available  programmer  doc
                       C/Fortran examples.
     -T                 Generate all available tests.
     -U                 Generate all available tutorial C/Fortran
     -C                 Generate all available C examples.
     -Fortran           Generate all available Fortran examples.
     -class             Generate all  available  class  C/Fortran
     -ps                Generate all C/Fortran examples that  use
                       the PostScript driver.
     -x11               Generate all C/Fortran examples that  use
                       the X11 driver.
     -areas             Generate all areas C/Fortran examples.
     -autograph         Generate all  autograph  C/Fortran  exam-
     -bivar             Generate all bivar C/Fortran examples.
     -colconv           Generate all colconv C/Fortran examples.
     -conpack           Generate all conpack C/Fortran examples.
     -conran_family     Generate all conran Fortran examples.
     -conrec_family     Generate all conrec Fortran examples.
     -dashline          Generate all dashline C/Fortran examples.
     -dashpack          Generate all dashpack C/Fortran examples.
     -ezmap             Generate all ezmap C/Fortran examples.
     -field_flow        Generate all field_flow  C/Fortran  exam-
                       ples.   Includes  streamlines  and vectors
     -gflash            Generate all gflash C/Fortran examples.
     -gks               Generate all gks C/Fortran examples.
     -gridall           Generate all gridall C/Fortran examples.
     -halftone          Generate all halftone Fortran examples.
     -histogram         Generate all  histogram  C/Fortran  exam-
     -isosrfhr          Generate all isosrfhr Fortran examples.
     -isosurface        Generate all isosurface  C/Fortran  exam-
     -labelbar          Generate all labelbar C/Fortran examples.
     -ngmath            Generate all ngmath C/Fortran examples.
     -ngmisc            Generate all ngmisc C/Fortran examples.
     -plotchar          Generate all plotchar C/Fortran examples.
     -polypack          Generate all polypack C/Fortran examples.
     -pwritx_family     Generate all pwrite Fortran examples.
     -scrolled_title    Generate all scrolled C/Fortran examples.
     -seter             Generate all seter C/Fortran examples.
     -softfill          Generate all softfill C/Fortran examples.
     -spps              Generate all spps C/Fortran examples.
     -streamlines       Generate all streamlines C/Fortran  exam-
     -surface           Generate all surface C/Fortran examples.
    -threed            Generate all threed C/Fortran examples.
     -vectors           Generate all vectors C/Fortran examples.
     -wmap              Generate all weather map C/Fortran  exam-
      - misc              Generate  all  miscellaneous  C/Fortran
     -clean             Remove everything but the ".ncgm" file.
     -n                 Specifies that the example should not  be
                       compiled,  linked, or run, but just copied
                       into your local directory.
     -noX11             Do not link in the X library when linking
                       the  selected  examples  and/or  tests.  A
                       stub will be linked instead.
     - onebyone          Specifies  that  the  selected  examples
                       and/or  tests should be generated one at a
                       time and viewed  as  they  are  generated.
                       This is intended for use during testing of
                       new releases at NCAR.
                       Below is a list of all the available ncar-
                       gex  examples.   They are listed according
                       to which utility they belong with.
     AREAS Examples:
     arex01 arex02 arex03 cardb1 cardb2  caredg  carfill  carline
     carmap tareas c_tareas
     AUTOGRAPH Examples:
     agex01 agex02 agex03  agex04  agex05  agex06  agex07  agex08
     agex09  agex10 agex11 agex12 agex13 fagaxclr fagaxlbl fagax-
     max  fagcuclr  fagcudsh  fagezmxy  fagezmy  fagezxy   fagezy
     fagilclr fagovrvw tagupw tautog c_agex07
     BIVAR Examples:
     cbex01 cidsfft c_cbex01
     COLCONV Examples:
     coex01 coex02 coex03 fcce01 fcce02 tcolcv c_coex02
     CONPACK Examples:
     cbex01 ccpback ccpcff ccpcfx ccpcica  ccpcir  ccpcis  ccpcit
     ccpclc  ccpcld ccpcldm ccpcldr ccpcll ccpclu ccpcnrc ccpdflt
     ccpezct ccpfil ccpga  ccphand  ccphcf  ccphl  ccphlt  ccpila
     ccpils  ccpilt  ccpklb ccplbam ccplbdr ccpline ccpllb ccpllc
     ccplll ccpllo ccpllp ccpllt ccpllw  ccpmap  ccpmovi  ccpmpxy
     ccpncls  ccpnet  ccpnof  ccpnsd  ccppc  ccppc1 ccppc2 ccppc3
     ccppc4 ccppkcl ccppole ccprc ccprect ccprwc  ccprwu  ccpscam
     ccpset  ccpsps1  ccpsps2  ccpspv ccpt2d ccptitle ccpvp ccpvs
     cidsfft colcon cpex01 cpex02  cpex03  cpex04  cpex05  cpex06
     cpex07  cpex08  cpex09  cpex10  cpex11  cpex12 cpex13 cpex14
     cpex15 tconpa c_cbex01 c_colcon
     CONRAN FAMILY Examples:
     tconan tconaq tconas
     CONREC FAMILY Examples:
     tcnqck tcnsmt tcnsup tconre
     DASHLINE Examples:
     fdlcurvd fdldashc  fdldashd  fdlsmth  tdashc  tdashl  tdashp
     tdashs c_fdldashc
     DASHPACK Examples:
     tdshpk c_tdshpk
     EZMAP Examples:
     cezmap1 cezmap2 cezmap3 cmpclr  cmpdd  cmpdrw  cmpel  cmpfil
     cmpgci  cmpgrd  cmpgrp  cmpita  cmpitm  cmplab cmplbl cmplot
     cmpmsk cmpou  cmppos  cmpsat  cmpsup  cmptit  cmptra  cmpusr
     eezmpa  mpex01  mpex02  mpex03  mpex04  mpex05 mpex06 mpex07
     mpex08 mpex09 mpex10  mpex11  mpex12  mpexfi  tezmap  tezmpa
     tezmpb c_mpex05 c_eezmpa
     FIELD FLOW Examples:
     ffex00 ffex01 ffex02 ffex03  ffex04  ffex05  fcover  fstream
     stex01 stex02 stex03 vvex01 vvex02 vvex03 c_ffex03 c_vvex03
     GFLASH Example:
     tgflas c_tgflas
     GKS Examples:
     fcell fcell0  fgke01  fgke02  fgke03  fgke04  fgkgpl  fgkgpm
     fgkgtx   fgklnclr  fgklnwth  fcirc  fgpm01  pgkex01  pgkex02
     pgkex03 pgkex04  pgkex05  pgkex06  pgkex07  pgkex08  pgkex09
     pgkex10  pgkex11  pgkex12  pgkex13  pgkex14  pgkex15 pgkex16
     pgkex17 pgkex18  pgkex19  pgkex20  pgkex21  pgkex22  pgkex23
     pgkex24 pgkex25 pgkex26 pgkex27 c_gtxpac c_pgkex21
     GRIDALL Example:
     ccpga tgrida c_tgrida
     HALFTONE Example:
     HISTOGRAM Examples:
     thstgr thstmv c_thstmv
     ISOSRFHR Example:
     ISOSURFACE Examples:
     fisissrf fispwrzi tisosr tpwrzi c_tisosr
     LABELBAR Examples:
     elblba tlblba clbfil clbbar clblbr c_elblba
     NGMATH Examples:
     csex01 csex02 csex03 csex04 csex05 csex06 csex07 dsex01 dsex02 dsex03
     dsex04 dsex05 dsex06 dsex01d nnex01 nnex02 nnex03 nnex04 nnex05 nnex06
     nnex07 nnex08 nnex09 nnex01d ftex01 ftex02 ftex03 ftex04 ftex05 ftex06
     c_csex01 c_csex02 c_csex03 c_csex04 c_csex05 c_csex06 c_csex07 c_dsex01
     c_dsex02 c_dsex03 c_dsex04 c_dsex05 c_dsex06 c_dsex01d c_nnex01 c_nnex02
     c_nnex03 c_nnex06 c_nnex01d c_ftex01 c_ftex02 c_ftex03 c_ftex04 c_ftex05
     NGMISC Examples:
     fngngdts fngwsym c_fngwsym

     PLOTCHAR Examples:
     epltch fpchiqu fpcloqu fpcfonts tpltch c_epltch
     POLYPACK Examples:
     ppex01 tppack c_ppex01
     PWRITE FAMILY Examples:
     tpwrtx tpwry
     SCROLLED TITLE Examples:
     fslfont slex01 slex02 tstitl c_slex01
     SETER Examples:
     SOFTFILL Examples:
     fsfsgfa fsfwrld sfex01 sfex02 tsoftf c_sfex02
     SPPS Examples:
     fcoord fcoord1 fcoord2 fspcurve  fspline  fsppoint  fspponts
     splogy sprevx c_fcoord2
     STREAMLINES Examples:
     fstream ffex00 ffex01 ffex03  ffex04  stex01  stex02  stex03
     tstrml c_ffex03
     SURFACE Examples:
     fsrezsrf fsrpwrzs fsrsrfac srex01 tsrfac tpwrzs c_srex01
     THREED Examples:
     fthex01  fthex02  fthex03  fthex04  fthex05  tthree   tpwrzt
     VECTORS Examples:
     ffex00 ffex01 ffex02  ffex05  fcover  tvelvc  vvex01  vvex02
     vvex03 c_vvex03
     WEATHER MAP Examples:
     wmex01 wmex02 wmex03  wmex04  wmex05  wmex06  wmex07  wmex08
     wmex09 wmex10 wmex11 wmex12 wmex13 wmex14 c_wmex09
     Miscellaneous Examples:
     bnchmk example ncargworld
     X11 Examples:
     fgke01 fgke04 c_xwndws
     Online:          ncargf77(1NCARG),          ncargcc(1NCARG),
     ncargfile(1NCARG),    ng4ex(1NCARG),    ncarg_cbind(5NCARG),
     Hardcopy:  NCAR Graphics Fundamentals, UNIX Version
     Copyright (C) 1987-1999
     University Corporation for Atmospheric Research
     The use of this Software is governed by a License Agreement.