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(1NCARG) NCAR GRAPHICS NCARGEX(1NCARG)
NAME
ncargex - NCAR Graphics Fortran and C Low-Level Utility
Examples
SYNOPSIS
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 ...
DESCRIPTION
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
information.
OPTIONS
-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
mode.
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
mode.
30 - monochrome Encapsulated PostScript
(EPS) in landscape mode.
31 - monochrome Encapsulated PostScript
Interchange format (EPSI) in landscape
mode.
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.
port.mono.ps - 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-
ples.
- 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
examples.
-C Generate all available C examples.
-Fortran Generate all available Fortran examples.
-class Generate all available class C/Fortran
examples.
-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-
ples.
-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
examples.
-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-
ples.
-isosrfhr Generate all isosrfhr Fortran examples.
-isosurface Generate all isosurface C/Fortran exam-
ples.
-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-
ples.
-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-
ples.
- misc Generate all miscellaneous C/Fortran
examples.
-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.
EXAMPLES AVAILABLE
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:
thafto
HISTOGRAM Examples:
thstgr thstmv c_thstmv
ISOSRFHR Example:
tisohr
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
c_ftex06
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:
tseter
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
c_fthex01
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
SEE ALSO
Online: ncargf77(1NCARG), ncargcc(1NCARG),
ncargfile(1NCARG), ng4ex(1NCARG), ncarg_cbind(5NCARG),
ncargintro(5NCARG)
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
COPYRIGHT
Copyright (C) 1987-1999
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.