File: axis.html

package info (click to toggle)
ploticus 2.0.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,696 kB
  • ctags: 2,035
  • sloc: ansic: 40,100; perl: 456; sh: 186; makefile: 129
file content (724 lines) | stat: -rw-r--r-- 19,720 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/01/02 08:56:47. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: proc axis (xaxis or yaxis)</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>proc axis (xaxis or yaxis)</h2></td>
  <td align=right>
  <small>
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>

<title>Manual page for proc_axis_(xaxis_or_yaxis)(PL)</title>
</head>
<body>

<center><img src="../gallery/sa0.gif"></center>

<h2>DESCRIPTION</h2>
<p>
<b>proc xaxis </b> generates an X axis.<tt> </tt>
<br>
<b>proc yaxis </b> generates a Y axis.<tt> </tt>
<p>
Both procs use the same attributes and operate in the same way.<tt> </tt>
<p>
A typical axis is a line with some number of regularly placed
marks called <b>tics</b>, each of which has a label called a <b>stub</b>
The axis also usually has a descriptive text <b>label</b> nearby.<tt> </tt>
<p>
Often axis attributes are specified within <b>proc areadef</b>
using <tt>xaxis.</tt> or <tt>yaxis.</tt> prefixes on the attribute names.  
This is usually more convenient, and allows the entire areadef with
axes specifications to be cloned for multiple plots on a page.<tt> </tt>
However, you might want to use separate <b>axis</b> procs, for example, if
multiple axes per plot are needed, 

<h2>FEATURES</h2>
<b>proc xaxis/yaxis</b> allows tics and stubs to be spaced
incrementally or at irregular points.  
A number of automatic stub formats are provided for dates, times, etc.<tt> </tt>
Axes may be placed anywhere, and grid lines or blocks may optionally be rendered.<tt> </tt>

<h2>EXAMPLES</h2>
See the Gallery Scaling and Axes examples
<a href="../gallery/gall.sa.html"><img src="../gallery/btn/here.gif"></a>

<h2>PREREQUISITES</h2>
A plotting area must be defined using <b>proc areadef</b>.<tt> </tt>
If stubs are to be taken from data fields, data must have already
been accessed or defined using <b>proc getdata</b>.<tt> </tt>

<h2>MODES</h2>
Stubs may be automatically generated (incremental), 
specified within the script,
or taken from plot data fields, an external file, or defined categories.<tt> </tt>
Self-locating stubs (stubs that contain an embedded location) may be used.<tt> </tt>

<h2>VARIABLES THAT ARE SET</h2>
XINC or YINC will be set to hold the axis increment value.<tt> </tt>


<h2>MANDATORY ATTRIBUTES</h2>
None.  Default behavior is automatic incremental stubs 
and small outward tics at every unit.<tt> </tt>


<h2>ATTRIBUTES</h2>
<p>
<b>label</b> 
<a href="attributetypes.html#text">
<i> text </i>
</a>
<dl>
<dt><dd><p>
A text label that will be rendered near the axis, used to describe
what is being plotted.  
<br>
Example: <tt>label: Yearly Income</tt>

</dl>
<p>
<b>tics</b>  <tt>yes</tt> | <tt>none</tt> | 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
If anything other than <tt>none</tt> is specified, tics will be rendered.<tt> </tt>
A linedetails specification may be given to control the color, etc. of tic marks.<tt> </tt>
Tics will be placed whereever a stub is placed.<tt> </tt>
Incremental tics may be rendered without stubs by setting <tt>stubs: none</tt>;
they can be controlled using <tt>ticincrement</tt>.<tt> </tt>
<br>
Example: <tt>tics: yes</tt>

</dl>
<p>
The <b>stubs</b> attribute controls the contents of 
the stubs.  There are several mode variants described below:

<p>
<b>stubs  incremental [</b><i>h</i>] [<i>units</i>]
<dl>
<dt><dd><p>
Generate incremental stubs for numeric or date or time data.<tt> </tt>
A stub will be generated and placed at every <i>h</i> units.<tt> </tt>
<i>h</i> and <i>units</i> may both be omitted for numeric data in which case a reasonable
default increment will be used (an <i>h</i> value of 0 has the same effect).<tt> </tt>
<br>
Example: <tt>stubs: incremental 10</tt>  ..would place stubs at
every 10 units.<tt> </tt>
<br>
<i>units</i> allows flexibility with stub increments.<tt> </tt>
The following table illustrates some possibilities:
<a name=stubunits></a>
<pre>
scaletype  h units          result
---------  -------------    ------------
linear     1 1000           one stub every 1000, 
				stubs expressed in # of thousands
linear     1 0.01           one stub every 0.01, 
				stubs expressed in # of hundredths
date       1 		    one stub per day
datetime   1 		    one stub per day
date       1 month	    one stub per month
date       3 months	    one stub every three months
date	   1 year           one stub every year
time       20 minutes       one stub every 20 minutes
time       1 hour           one stub every hour
</pre>
See
<a href="scaleunits.html">
 scaleunits 
</a>
for more info on <i>units</i>.<tt> </tt>

</dl>
<p>
<b>stubs  text</b>  
<a href="attributetypes.html#text">
<i> multi-line text </i>
</a>
<dl>
<dt><dd><p>
Indicates that the following lines of the script contain 
literal stub text, with one line per stub, and 
terminating with a blank line.<tt> </tt>
<br>
Example:
<pre>
stubs:  text
	New York
	Atlanta
	Detroit
	Baltimore
	
</pre>
<tt></tt>
</dl>
<p>
<b>stubs  list </b>
<a href="attributetypes.html#text">
<i> text  </i>
</a>
<dl>
<dt><dd><p>
Same as <tt>stubs  text</tt> except that all stubs are given on one
line, with individual stubs separated by <tt>\n</tt>.<tt> </tt>
<br>
Example: <tt>stubs: list New York\nDetroit\nBaltimore</tt>

</dl>
<p>
<b>stubs  file  </b><i>filename</i> 
<dl>
<dt><dd><p>
Same as <tt>text</tt> except that content is to be 
taken from <i>filename</i>.<tt> </tt>
<br>
Example: <tt>stubs: /home/myplots/stubs2</tt>

</dl>
<p>
<b>stubs  datafields=</b>
<a href="attributetypes.html#dfield">
<i>dfield1</i>
</a>
<a href="attributetypes.html#dfield">
,[<i>dfield2</i>] 
</a>
<dl>
<dt><dd><p>
Stub content is to be taken from one or two data fields.<tt> </tt>
<br>
Example: <tt>stubs: datafields=1,2</tt>  .. would use
the first and second data field for stubs.<tt> </tt>


</dl>
<p>
<b>stubs  usecategories</b> 
<dl>
<dt><dd><p>
If the scaletype for this axis is <tt>categories</tt>, this
indicates that the defined category names should be
used as the stubs.  Implies self-locating.<tt> </tt>

</dl>
<p>
<b>stubs  none</b>
<dl>
<dt><dd><p>
Don't display any stubs.<tt> </tt>
Example: <tt>stubs: none</tt>


</dl>
<p>
<b>selflocatingstubs</b>  (see <tt>stubs</tt>, above)
<dl>
<dt><dd><p>
Same as <tt>stubs</tt> except that stubs are self-locating.  Each self-locating
stub contains a plottable value that determines where it will be placed.<tt> </tt>
<br>
For the <tt>text</tt>, <tt>list</tt> and <tt>file</tt> modes, the first token 
(white-space delimited) in each stub is taken to be a plottable value.  
The remainder of the stub is displayed.<tt> </tt>
To display the placement value specify the value twice.<tt> </tt>
<br>
For the <tt>datafields</tt> mode, the first field <i>a</i> is used for placement
and the second field <i>b</i> is used for content.  To display the placement 
value, specify the same field# twice.<tt> </tt>
<br>
Examples of selflocating stubs:
<br>
stubs from datafields: 
<a href="../gallery/lineplot3.htm">
 lineplot3 
</a>

</dl>
<p>
<b>stubrange</b> <i>min</i> [<i>max</i>]
<dl>
<dt><dd><p>
Range (in 
<a href="attributetypes.html#positionunits">
 scaled units 
</a>
where tics and stubs should start
and stop along the axis.  Default range is the plot area minimus and maximus.<tt> </tt>
(If text stubs are being given, low end of range defaults to 
one unit in from the limit since this is usually what is desired 
for bar graphs, etc.)
If only one value is given it is taken to be the minimum.<tt> </tt>
Example: <tt>stubrange: 5 95</tt>


</dl>
<p>
<b>stubformat</b> 
<a href="attributetypes.html#string">
<i> string </i>
</a>
<dl>
<dt><dd><p>
Controls the format of numeric, date, or time stubs.  
<dt><dd><p>
For numeric stubs, <i>string</i> is a 
<a href="attributetypes.html#printfspec">
 printf-spec 
</a>
Default is <tt>%5.0f</tt>.<tt> </tt>
<br>
Example: <tt>stubformat: %5.3f</tt> 
<dt><dd><p>
For other scale types such as <b>date</b> or <b>time</b>,
a display format may be specified.<tt> </tt>
See 
<a href="scaleunits.html">
<i> scaleunits </i>
</a>
for supported display formats.  If <tt>stubformat</tt> is
not specified when date/time scaling is being done,
the current notation, or one similar to it, is used.<tt> </tt>

</dl>
<p>
<b>stubevery</b>  <i>n</i>
<dl>
<dt><dd><p>
When doing stubs from a data field or categories, this will
cause every <i>n</i>th stub (beginning with the first) to be displayed; the rest will not be 
displayed.  May be useful to avoid display of all categories as stubs 
and when categories represent a logical series.<tt> </tt>



</dl>
<p>
<b>location</b> 
<a href="attributetypes.html#locvalue">
<i> locvalue </i>
</a>
<dl>
<dt><dd><p>
Position of the axis line.  For an x axis this value is in 
y space; for a y axis this value is in x space.  Append <tt>(s)</tt>
to indicate scaled units.  
Tics and stubs will be placed relative to the position of the line.<tt> </tt>
This attribute is important when placing multiple axes or axes at
unusual locations.<tt> </tt>
<br>
Example: <tt>location: 105(s)</tt>


</dl>
<p>
<b>axisline</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
Details pertaining to the axis line.  
Use <tt>none</tt> to completely suppress the axis line.<tt> </tt>
<br>
Example: <tt>axisline: width=1.2 color=green</tt>

</dl>
<p>
<b>axislinerange</b> <i>min</i> [<i>max</i>]
<dl>
<dt><dd><p>
May be used to control the range of the axis line.<tt> </tt>
If only one value is given it is taken to be the minimum.<tt> </tt>
<br>
Example: <tt>axislinerange: 5 95</tt>

</dl>
<p>
<b>labeldetails</b> 
<a href="textdetails.html">
<i> textdetails </i>
</a>
<dl>
<dt><dd><p>
Details for rendering the label. Example: <tt>labeldetails: size=13 style=I</tt>

</dl>
<p>
<b>labeldistance</b> <i>n</i>
<dl>
<dt><dd><p>
Distance of the label below / left of the axis line.<tt> </tt>
<a href="attributetypes.html#positionunits">
<i> Absolute units </i>
</a>
 .  This could also be done via <tt>labeldetails: adjust=</tt>.<tt> </tt>
<br>
Example: <tt>labeldistance: 0.6</tt>


</dl>
<p>
<b>stubdetails</b> 
<a href="textdetails.html">
<i> textdetails </i>
</a>
<dl>
<dt><dd><p>
Details pertaining to stub text rendering.<tt> </tt>
<br>
Example: <tt>stubdetails: size=7</tt>

</dl>
<p>
<b>stubcull</b>  <tt>yes</tt> | <i>h</i>
<dl>
<dt><dd><p>
If specified, stubs are suppressed when too close to the adjacent stub.<tt> </tt>
This is useful with log axes to prevent "piling up" of stubs in the upper values.<tt> </tt>
If <tt>yes</tt>, a default minimum separation distance (0.1 inches) is used; you can also
specify a minimum separation distance <i>h</i> if desired.  

</dl>
<p>
<b>stubomit</b> <i>list</i>
<dl>
<dt><dd><p>
Used to supress certain indiviual stubs, or all stubs.<tt> </tt>
This may be useful when stubs are given with data and certain ones
are too close together or should be omitted for some other reason.<tt> </tt>
For a more automatic stub supression, such as for log axes, see <tt>stubcull</tt>.<tt> </tt>
<i>list</i> is a 
space-delimited list of one or more strings.  Each may include wild card
characters * and ?.  Any stubs matching any members of the list are suppressed
(however the tic is not suppressed).<tt> </tt>
To suppress all stubs use this: <tt>stubomit: *</tt>
<br>
Example: <tt>stubomit: 0.5 3.5</tt>
<br>
Another example that uses stubomit: 
<a href="../gallery/lineplot3.htm">
 lineplot3 
</a>

</dl>
<p>
<b>stubreverse</b> <i>yes|no</i>
<dl>
<dt><dd><p>
If <tt>yes</tt>, reverses the placement of stubs so that the first stub is
placed at the maxima and the last at the minima, as is often desired
when placing text stubs along the Y axis.<tt> </tt>
If <tt>no</tt>, no stub reversal is done.<tt> </tt>
Default is for reversal to be done 
If text stubs are to be placed along the Y axis then the default is <tt>yes</tt>,
otherwise the default is <tt>no</tt>.<tt> </tt>
Example: <tt>stubreverse: yes</tt>


</dl>
<p>
<b>signreverse</b> <i>yes|no</i>
<dl>
<dt><dd><p>
If <tt>yes</tt>, presents numeric stubs with sign reversed.<tt> </tt>
May be useful in creating an axis that moves from high values
to low values.  

</dl>
<p>
<b>stubvert</b> <i>yes|no</i>
<dl>
<dt><dd><p>
If <tt>yes</tt>, renders X axis stubs using vertical text.  This is useful if
X axis stubs are too long to fit horizontally.<tt> </tt>
Example: <tt>stubvert: yes</tt>


</dl>
<p>
<b>stubslide</b>  
<a href="attributetypes.html#lenvalue">
<i> lenvalue </i>
</a>
<dl>
<dt><dd><p>
If specified, axis stubs are shifted by the given amount.<tt> </tt>
For example, a positive value would shift X axis stubs to the right.<tt> </tt>
For example, a negative value would shift Y axis stubs downward.<tt> </tt>
Tics are not shifted.<tt> </tt>
<br>
Example: <tt>stubslide: 0.5</tt>
<br>
For another example see 
<a href="../gallery/axis9b.htm">
axis9b 
</a>

</dl>
<p>
<b>ticslide</b>  
<a href="attributetypes.html#lenvalue">
<i> lenvalue </i>
</a>
<dl>
<dt><dd><p>
If specified, axis tics are shifted by the given amount.<tt> </tt>
For example, a positive value would shift X axis stubs to the right.<tt> </tt>
For example, a negative value would shift Y axis stubs downward.<tt> </tt>




</dl>
<p>
<b>ticlen</b> <i>len1</i> [<i>len2</i>]
<dl>
<dt><dd><p>
Length of tics in 
<a href="attributetypes.html#positionunits">
 absolute units 
</a>
 . 
<i>len1</i> is the distance that
tics will be drawn from the axis line leftward / downward
and <i>len2</i> (optional) is the distance that
tics will be drawn from the axis line rightward / upward.<tt> </tt>
The default is for tics to be drawn a short distance leftward / downward.<tt> </tt>
Example: <tt>ticlen: 0.1 0.05</tt>
<br>
Example: <tt>ticlen: 0 0.05</tt>

</dl>
<p>
<b>ticincrement</b> <i>n</i> [<i>units</i>]
<dl>
<dt><dd><p>
When no stubs are being rendered, this attribute may be used to
control tic placement.  Tics will be placed at every <i>n</i> units.<tt> </tt>
The <i>units</i> modifier may be used when working with date or
time scaling; it may be <tt>days</tt>, <tt>hours</tt>, etc. 
(see
<a href="scaleunits.html">
scaleunits
</a>
).<tt> </tt>

</dl>
<p>
<b>minortics</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
Details pertaining to the minor tic marks.<tt> </tt>
Default is <tt>none</tt> which suppresses minor tic marks.<tt> </tt>
Use <tt>yes</tt> to activate minor tics using the default detail
specifications.<tt> </tt>

</dl>
<p>
<b>minorticinc</b> <i>n</i> [<i>units</i>]
<dl>
<dt><dd><p>
Minor tics to be drawn every <i>n</i> scaled units along the axis line.<tt> </tt>
The <i>units</i> modifier may be used when working in date or time units;
it may be <tt>days</tt>, <tt>hours</tt>, etc.<tt> </tt>
(see
<a href="scaleunits.html">
scaleunits
</a>
).<tt> </tt>

</dl>
<p>
<b>minorticlen</b> <i>len1</i> [<i>len2</i>]
<dl>
<dt><dd><p>
Length of tics in 
<a href="attributetypes.html#positionunits">
 absolute units 
</a>
 . 
<i>len1</i> is the distance that
minor tics will be drawn from the axis line leftward/downward,
and <i>len2</i> (optional) is the distance that
tics will be drawn from the axis line rightward/upward.<tt> </tt>

</dl>
<p>
<b>grid</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
| none
<dl>
<dt><dd><p>
If specified, causes background grid lines to be drawn at stub or tic locations.<tt> </tt>
If no stubs or tics are being rendered, the <tt>ticincrement</tt> attribute
may still be used to control placement of grid lines.<tt> </tt>
Extent of the lines may be controlled using <tt>gridlineextent</tt>.<tt> </tt>
Shaded blocks rather than lines may be done using <tt>gridblocks</tt>.<tt> </tt>
Default is "none".<tt> </tt>
<br>
Example: <tt>grid: color=yellow width=1</tt>

</dl>
<p>
<b>gridblocks</b>
<a href="color.html">
<i> color1  color2</i>
</a>
 | none
<dl>
<dt><dd><p>
If specified, causes a background grid made up of shaded blocks.<tt> </tt>
Blocks are shaded alternately using <i>color1</i> and <i>color2</i>.<tt> </tt>
Extent of the blocks may be controlled using <tt>gridlineextent</tt>.<tt> </tt>
<br>
Example: <tt>gridblocks:  gray(0.9) white

</tt></dl>
<p>
<b>gridlineextent</b> 
<a href="attributetypes.html#locvalue">
 minlocval  [maxlocval]
</a>
<dl>
<dt><dd><p>
Allows explicit specification of where grid lines or shaded blocks begin
and end.  
Normally grid lines or blocks are drawn from the minima to the maxima.<tt> </tt>
For example if grid lines are being rendered along with a Y axis,
this attribute may be used to control where the lines begin and end in X.<tt> </tt>
Commonly used to extend grid structure into axis stubs area as an eye guide.<tt> </tt>
<br>
Example: <tt>gridlineextent: min-1.5  max</tt>

</dl>
<p>
<b>gridskip</b>  <tt>min</tt> | <tt>max</tt> | <tt>minmax</tt>
<dl>
<dt><dd><p>
Grid lines can sometimes interfere with a perpendicular axis 
line rendered earlier.  Use this option to suppress the 
grid at the minima, maxima, or both.<tt> </tt>

</dl>
<p>
<b>autoyears</b>  <tt>yy</tt>  |  <tt>'yy</tt>  |  <tt>yyyy</tt>
<dl>
<dt><dd><p>
This attribute may be used when doing incremental stubs
by month, in order to add the year below the first month and then
every January thereafter.  It will be located just below the months.<tt> </tt>
<tt>yy</tt> gives a two-digit year such as <tt>99</tt>;
<tt>'yy</tt> gives a two-digit year such as <tt>'99</tt>;
<tt>yyyy</tt> gives a four-digit year.<tt> </tt>

</dl>
<p>
<b>clickmap</b>  <tt>grid | xygrid</tt>
<dl>
<dt><dd><p>
If a
<a href="clickmap.html">
 clickmap
</a>
is being generated, 
this attribute allows the plotting area to be mapped as a grid.<tt> </tt>
Specify <tt>grid</tt> for a 1-D grid, or <tt>xygrid</tt> for a 2-D grid.  
<a href="areadef.html">
 proc areadef
</a>
<tt>clickmapurl</tt> attribute must also be specified.<tt> </tt>
See the 
<a href="clickmap.html">
 clickmap page
</a>
for more details and examples.<tt> </tt>
<dt><dd><p>
Example: <tt>clickmap: grid</tt>

</dl>
<p>
<b>clickmapextent</b> 
<dl>
<dt><dd><p>
If a
<a href="clickmap.html">
 clickmap
</a>
is being generated, and the plotting area is being mapped as a grid,
normally the regions end at the plotting area boundary.<tt> </tt>
However, this attribute may be used to extend the region, to include
stubs, for example.<tt> </tt>
<dt><dd><p>
Example: <tt>clickmapextent: min-0.5 </tt>

</dl>
<p>
<b>clickmapvalformat</b>  <i>stubformat</i>
<dl>
<dt><dd><p>
If a
<a href="clickmap.html">
 clickmap
</a>
is being generated, and the plotting area is being mapped as a grid,
this attribute allows control over the format of the values to be sustituted
into the URL template.  Most often useful for special units such as dates.<tt> </tt>
See the 
<a href="clickmap.html">
 clickmap page
</a>
for more details and examples.<tt> </tt>
<dt><dd><p>
Example: <tt>clickmapvalformat: MMMyy</tt>


<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/Welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>March 01, 2002.
</body>
</html>