1PLAXES(3plplot) PLplot API PLAXES(3plplot)
2
3
4
6 plaxes - Draw a box with axes, etc. with arbitrary origin
7
9 plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick, nysub)
10
12 Draws a box around the currently defined viewport with arbitrary world-
13 coordinate origin specified by x0 and y0 and labels it with world coor‐
14 dinate values appropriate to the window. Thus plaxes(3plplot) should
15 only be called after defining both viewport and window. The character
16 strings xopt and yopt specify how the box should be drawn as described
17 below. If ticks and/or subticks are to be drawn for a particular axis,
18 the tick intervals and number of subintervals may be specified explic‐
19 itly, or they may be defaulted by setting the appropriate arguments to
20 zero.
21
22 Redacted form: General: plaxes(x0, y0, xopt, xtick, nxsub, yopt,
23 ytick, nysub) Perl/PDL: plaxes(x0, y0, xtick, nxsub, ytick, nysub,
24 xopt, yopt)
25
26
27 This function is not used in any examples.
28
30 x0 (PLFLT, input)
31 World X coordinate of origin.
32
33 y0 (PLFLT, input)
34 World Y coordinate of origin.
35
36 xopt (const char *, input)
37 Pointer to character string specifying options for horizontal
38 axis. The string can include any combination of the following
39 letters (upper or lower case) in any order: a: Draws axis, X-
40 axis is horizontal line (y=0), and Y-axis is vertical line
41 (x=0). b: Draws bottom (X) or left (Y) edge of frame. c: Draws
42 top (X) or right (Y) edge of frame. d: Plot labels as date /
43 time. Values are assumed to be seconds since the epoch (as
44 used by gmtime). f: Always use fixed point numeric labels. g:
45 Draws a grid at the major tick interval. h: Draws a grid at the
46 minor tick interval. i: Inverts tick marks, so they are drawn
47 outwards, rather than inwards. l: Labels axis logarithmically.
48 This only affects the labels, not the data, and so it is neces‐
49 sary to compute the logarithms of data points before passing
50 them to any of the drawing routines. m: Writes numeric labels
51 at major tick intervals in the unconventional location (above
52 box for X, right of box for Y). n: Writes numeric labels at
53 major tick intervals in the conventional location (below box for
54 X, left of box for Y). o: Use custom labeling function to gen‐
55 erate axis label text. The custom labeling function can be
56 defined with the plslabelfuncplslabelfunc; command. s: Enables
57 subticks between major ticks, only valid if t is also specified.
58 t: Draws major ticks.
59
60
61 xtick (PLFLT, input)
62 World coordinate interval between major ticks on the x axis. If
63 it is set to zero, PLplot automatically generates a suitable
64 tick interval.
65
66 nxsub (PLINT, input)
67 Number of subintervals between major x axis ticks for minor
68 ticks. If it is set to zero, PLplot automatically generates a
69 suitable minor tick interval.
70
71 yopt (const char *, input)
72 Pointer to character string specifying options for vertical
73 axis. The string can include any combination of the letters
74 defined above for xopt, and in addition may contain: v: Write
75 numeric labels for vertical axis parallel to the base of the
76 graph, rather than parallel to the axis.
77
78
79 ytick (PLFLT, input)
80 World coordinate interval between major ticks on the y axis. If
81 it is set to zero, PLplot automatically generates a suitable
82 tick interval.
83
84 nysub (PLINT, input)
85 Number of subintervals between major y axis ticks for minor
86 ticks. If it is set to zero, PLplot automatically generates a
87 suitable minor tick interval.
88
89
91 Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This
92 man page was automatically generated from the DocBook source of the
93 PLplot documentation, maintained by Alan W. Irwin and Rafael
94 Laboissiere.
95
97 PLplot documentation at http://plplot.sourceforge.net/resources.
98
99
100
101 July, 2010 PLAXES(3plplot)