ncl_conop4 - Man Page

sets option switches and specifys various CHARACTER parameters to be used by the Conran_family utility.

Synopsis

CONOP4 (IOPT,CHARS,NUMC,IFMT)

Description

IOPT

Character, input -- Selects an internal parameter and sets an option switch.  The possibilities are:

 'DAS=ON', 'DAS=OFF', 'DAS=GTR', 'DAS=EQU', 'DAS=LSS', and 'DAS=ALL'
 'FMT=ON' or 'FMT=OFF'
 'TLE=ON' or 'TLE=OFF'

If the value of an IOPT option is 'OFF', then the next three arguments of the CONOP4 call, CHARS, NUMC, and IFMT can be given any dummy value. Option settings will be returned to their default values.

If an option is other than 'OFF', then the CHARS, NUMC, and IFMT arguments can be used to override the default settings of that option.

CHARS

Character, input -- A string of up to 64 characters.

NUMC

Integer, input -- The number of characters in string CHARS.

IFMT

Integer, input -- The maximum number of digits which can be printed by the output format loaded into CHARS when IOPT='FMT=ON'.  IFMT is not used with any other value of IOPT.

The following options are defined by this subroutine:

DAS

This parameter determines which contours are represented by dashed lines.  The dashed line pattern is set in argument CHARS.  Arguments NUMC and IFMT are not used.  They can assume any dummy value.

If IOPT='DAS=OFF', only solid lines are used.  This is the default.

All solid lines: CALL CONOP4('DAS=OFF',' ',0,0)

To assign a specified line pattern to all contours:

CALL CONOP4('DAS=ALL',CHARS,0,0)

To assign a specified line pattern to selected contours:

Contour > DBP:  CALL CONOP4('DAS=GTR',CHARS,0,0)

Contour = DBP:  CALL CONOP4('DAS=EQU',CHARS,0,0)

Contour < DBP:  CALL CONOP4('DAS=LSS',CHARS,0,0)

The breakpoint for changing the line pattern, parameter DBP, is set by a call to entry CONOP3.  DBP = 0. is the default. See parameter DBP in "man conop3".

If DAS has a value other than OFF, CHARS is a dashed line pattern described by a ten character string with a dollar sign ($) for solid and a single quote (') for blank.  Recall that in FORTRAN 77, in a quoted string a single quote is represented by two single quotes ('').

Example:  CALL CONOP4('DAS=GTR','$$$$$''$$$$',0,0)

FMT

A parameter which specifies a format for output of the data values.

If FMT=ON, the user must specify values for CHARS, NUMC, and IFMT. CHARS is an output print format.  It has beginning and ending parenthesis as in (F8.2). NUMC is the number of characters in CHARS.  It is 6 for (F8.2). IFMT is the maximum number of digits which can be printed by this format.  It is 8 for an F8.2.

Example:
CHARS = '(F8.2)'
NUMC  = 6
IFMT = 8
CALL CONOP4('FMT=ON',CHARS,NUMC,IFMT)

Warning:  IFMT cannot be greater than 10; however, CONRAN will not test for a valid format.  Thus, a format which results in IFMT > 10 will cause an undetected error.

If FMT=OFF, the default values are: CHARS='(G10.3)', NUMC=7, and IFMT=10, respectively.

To return to default settings use:
CALL CONOP4('FMT=OFF',' ',0,0)

TLE

The parameter to place a title at the top of the plot. CHARS contains the title, NUMC is the number of characters in the title and IFMT is not used.

Example: CALL CONOP4('TLE=ON','VECTOR REVIEW',13,0)

Usage

CONOP4 is called to set parameters of type CHARACTER before entries CONRAN, CONRAS, or CONRAQ are called to generate the contour plots.

Examples

Use the ncargex command to see pertinent examples tconaq, tconas and tconan.

Access

To use CONOP4 load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Messages

See the conran_family man page for a description of all Conran_family error messages and/or informational messages.

See Also

Online: conran_family, conran_family_params, conran, conraq, conras, conop1, conop2, conop3, conpack, conpack_params Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

Info

March 1993 UNIX NCAR GRAPHICS