1ARDBPA(3NCARG) NCAR GRAPHICS ARDBPA(3NCARG)
2
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
12 CALL ARDBPA (MAP,IGRP,LABEL)
13
15 #include <ncarg/ncargC.h>
16 void c_ardbpa (int *map, int igrp, char *label)
18
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 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 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 LABEL (an input constant or variable of type CHARACTER) - The
36 label you want put on the plot.
37
39 The C-binding argument descriptions are the same as the FORTRAN
40 argument descriptions.
41
43 When ARDBPA is called, it draws the requested picture and then calls
44 FRAME to advance to a new frame.
45 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 Color Left area identifier Right area identifier
53 ----- -------------------- ---------------------
54 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 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 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 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 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 If ARDBPA is used for a complicated area map, the amount of output can
91 be very large.
92
94 Use the ncargex command to see the following relevant examples: arex01,
95 cardb2.
96
98 To use ARDBPA or c_ardbpa, load the NCAR Graphics libraries ncarg,
99 ncarg_gks, and ncarg_c, preferably in that order.
100
102 Online: areas, areas_params, ardrln, aredam, argeti, argetr, argtai,
103 arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind
104 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
106
108 Copyright (C) 1987-2007
109 University Corporation for Atmospheric Research
110 This documentation is free software; you can redistribute it and/or
112 modify it under the terms of the GNU General Public License as
113 published by the Free Software Foundation; either version 2 of the
114 License, or (at your option) any later version.
115 This software is distributed in the hope that it will be useful, but
117 WITHOUT ANY WARRANTY; without even the implied warranty of
118 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
119 General Public License for more details.
120 You should have received a copy of the GNU General Public License along
122 with this software; if not, write to the Free Software Foundation,
123 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
124UNIX April 1995 ARDBPA(3NCARG)