NAME

       ARDBPA - Produces a plot showing all of the edge segments in an area map that have a specified group
       identifier IGRP; if IGRP is less than or equal to zero, all groups are included.  Such plots allow one to
       debug problems with an area map.

SYNOPSIS

       CALL ARDBPA (MAP,IGRP,LABEL)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ardbpa (int *map, int igrp, char *label)

DESCRIPTION

       MAP         (an  input/output  array of type INTEGER) - An array containing an area map that has at least
                   been initialized by a call to ARINAM and to which edges will  probably  have  been  added  by
                   calls to AREDAM.

                   Note:  As  part  of  initializing the area map, ARINAM stores the dimension of MAP in MAP(1);
                   therefore, the dimension does not have to be given as an argument in calls to ARDBPA.)

       IGRP        (an input expression of type INTEGER) - The group identifier of the group that  you  want  to
                   examine.  If IGRP is less than or equal to zero, edges from all groups will be shown.

       LABEL       (an input constant or variable of type CHARACTER) - The label you want put on the plot.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       When ARDBPA is called, it draws the requested picture and then calls FRAME to advance to a new frame.

       By  default,  each edge segment in the plot appears in one of four different colors, depending on whether
       the area identifiers to the left and right are less than or equal  to  zero  or  greater  than  zero,  as
       follows:

       Color     Left area identifier      Right area identifier
       -----     --------------------      ---------------------

       Magenta   Less than or equal to 0   Less than or equal to 0
       Yellow    Less than or equal to 0   Greater than 0
       Cyan      Greater than 0            Less than or equal to 0
       White     Greater than 0            Greater than 0

       In  some  cases you may notice gray lines in your plot. This means that the same edge occurs in more than
       one group. In all but one of those groups, Areas negates the group identifier for the edge  in  the  area
       map.  This  allows Areas to include the edge when it is looking at a particular group (as in ARPRAM), but
       omit it when it is looking at the union of all the groups (as in ARSCAM).

       Color indices DC+1 through DC+5 are used for the required colors.  The default value of DC is 100, so, by
       default, ARDBPA redefines color indices 101 through 105.  If this would result in colors  that  you  have
       defined being redefined, you should change the value of DC to something else.

       Nominally,  each  edge  segment  is  shown  with  an  arrowhead, indicating the order in which the points
       defining the edge segment occur in the area map and therefore which side of the edge segment  is  to  the
       left  and  which  side is to the right.  In regions where putting an arrowhead on each edge segment would
       result in too much clutter, some of them may be omitted.

       The left and right area identifiers for each edge  segment  are  written  in  the  appropriate  positions
       relative to the edge segment.  Also, if IGRP is less than or equal to zero, the group identifier for each
       edge  segment  is  written on the segment itself.  These identifiers are intentionally written using very
       small characters; the idea is that you can look at the whole plot to get some idea  of  possible  problem
       regions;  when  such  a  region is found, you can enlarge it, using the "zoom" capability of "idt", for a
       closer look; at that point, the area identifiers become readable.

       If ARDBPA is used for a complicated area map, the amount of output can be very large.

EXAMPLES

       Use the ncargex command to see the following relevant examples: arex01, cardb2.

ACCESS

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

SEE ALSO

       Online:  areas,  areas_params,  ardrln,  aredam,  argeti, argetr, argtai, arinam, armvam, arpram, arscam,
       arseti, arsetr, ncarg_cbind

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               April 1995                                     ARDBPA(3NCARG)