1ARDBPA(3NCARG)                   NCAR GRAPHICS                  ARDBPA(3NCARG)
2
3
4

NAME

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

SYNOPSIS

12       CALL ARDBPA (MAP,IGRP,LABEL)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       void c_ardbpa (int *map, int igrp, char *label)
18

DESCRIPTION

20       MAP         (an input/output array of type INTEGER) - An array
21                   containing an area map that has at least been initialized
22                   by a call to ARINAM and to which edges will probably have
23                   been added by calls to AREDAM.
24
25                   Note: As part of initializing the area map, ARINAM stores
26                   the dimension of MAP in MAP(1); therefore, the dimension
27                   does not have to be given as an argument in calls to
28                   ARDBPA.)
29
30       IGRP        (an input expression of type INTEGER) - The group
31                   identifier of the group that you want to examine.  If IGRP
32                   is less than or equal to zero, edges from all groups will
33                   be shown.
34
35       LABEL       (an input constant or variable of type CHARACTER) - The
36                   label you want put on the plot.
37

C-BINDING DESCRIPTION

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

USAGE

43       When ARDBPA is called, it draws the requested picture and then calls
44       FRAME to advance to a new frame.
45
46       By default, each edge segment in the plot appears in one of four
47       different colors, depending on whether the area identifiers to the left
48       and right are less than or equal to zero or greater than zero, as
49       follows:
50
51
52       Color     Left area identifier      Right area identifier
53       -----     --------------------      ---------------------
54
55       Magenta   Less than or equal to 0   Less than or equal to 0
56       Yellow    Less than or equal to 0   Greater than 0
57       Cyan      Greater than 0            Less than or equal to 0
58       White     Greater than 0            Greater than 0
59
60       In some cases you may notice gray lines in your plot. This means that
61       the same edge occurs in more than one group. In all but one of those
62       groups, Areas negates the group identifier for the edge in the area
63       map. This allows Areas to include the edge when it is looking at a
64       particular group (as in ARPRAM), but omit it when it is looking at the
65       union of all the groups (as in ARSCAM).
66
67       Color indices DC+1 through DC+5 are used for the required colors.  The
68       default value of DC is 100, so, by default, ARDBPA redefines color
69       indices 101 through 105.  If this would result in colors that you have
70       defined being redefined, you should change the value of DC to something
71       else.
72
73       Nominally, each edge segment is shown with an arrowhead, indicating the
74       order in which the points defining the edge segment occur in the area
75       map and therefore which side of the edge segment is to the left and
76       which side is to the right.  In regions where putting an arrowhead on
77       each edge segment would result in too much clutter, some of them may be
78       omitted.
79
80       The left and right area identifiers for each edge segment are written
81       in the appropriate positions relative to the edge segment.  Also, if
82       IGRP is less than or equal to zero, the group identifier for each edge
83       segment is written on the segment itself.  These identifiers are
84       intentionally written using very small characters; the idea is that you
85       can look at the whole plot to get some idea of possible problem
86       regions; when such a region is found, you can enlarge it, using the
87       "zoom" capability of "idt", for a closer look; at that point, the area
88       identifiers become readable.
89
90       If ARDBPA is used for a complicated area map, the amount of output can
91       be very large.
92

EXAMPLES

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

ACCESS

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

SEE ALSO

102       Online: areas, areas_params, ardrln, aredam, argeti, argetr, argtai,
103       arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind
104
105       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
106
108       Copyright (C) 1987-2009
109       University Corporation for Atmospheric Research
110       The use of this Software is governed by a License Agreement.
111
112
113
114UNIX                              April 1995                    ARDBPA(3NCARG)
Impressum