1PLAXES(3plplot) PLplot API PLAXES(3plplot)
2
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 ascii
16 character strings xopt and yopt specify how the box should be drawn as
17 described below. If ticks and/or subticks are to be drawn for a par‐
18 ticular axis, the tick intervals and number of subintervals may be
19 specified explicitly, or they may be defaulted by setting the appropri‐
20 ate arguments to zero.
21 Redacted form: General: plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick,
23 nysub)
24 This function is not used in any examples.
27
29 x0 (PLFLT(3plplot), input)
30 World X coordinate of origin.
31 y0 (PLFLT(3plplot), input)
33 World Y coordinate of origin.
34 xopt (PLCHAR_VECTOR(3plplot), input)
36 An ascii character string specifying options for the x axis.
37 The string can include any combination of the following letters
38 (upper or lower case) in any order: a: Draws axis, X-axis is
39 horizontal line (y=0), and Y-axis is vertical line (x=0). b:
40 Draws bottom (X) or left (Y) edge of frame. c: Draws top (X) or
41 right (Y) edge of frame. d: Plot labels as date / time. Values
42 are assumed to be seconds since the epoch (as used by gmtime).
43 f: Always use fixed point numeric labels. g: Draws a grid at
44 the major tick interval. h: Draws a grid at the minor tick in‐
45 terval. i: Inverts tick marks, so they are drawn outwards,
46 rather than inwards. l: Labels axis logarithmically. This only
47 affects the labels, not the data, and so it is necessary to com‐
48 pute the logarithms of data points before passing them to any of
49 the drawing routines. m: Writes numeric labels at major tick
50 intervals in the unconventional location (above box for X, right
51 of box for Y). n: Writes numeric labels at major tick intervals
52 in the conventional location (below box for X, left of box for
53 Y). o: Use custom labelling function to generate axis label
54 text. The custom labelling function can be defined with the
55 plslabelfunc(3plplot) command. s: Enables subticks between ma‐
56 jor ticks, only valid if t is also specified. t: Draws major
57 ticks. u: Exactly like "b" except don't draw edge line. w: Ex‐
58 actly like "c" except don't draw edge line. x: Exactly like "t"
59 (including the side effect of the numerical labels for the major
60 ticks) except exclude drawing the major and minor tick marks.
61 xtick (PLFLT(3plplot), input)
64 World coordinate interval between major ticks on the x axis. If
65 it is set to zero, PLplot automatically generates a suitable
66 tick interval.
67 nxsub (PLINT(3plplot), input)
69 Number of subintervals between major x axis ticks for minor
70 ticks. If it is set to zero, PLplot automatically generates a
71 suitable minor tick interval.
72 yopt (PLCHAR_VECTOR(3plplot), input)
74 An ascii character string specifying options for the y axis.
75 The string can include any combination of the letters defined
76 above for xopt, and in addition may contain: v: Write numeric
77 labels for the y axis parallel to the base of the graph, rather
78 than parallel to the axis.
79 ytick (PLFLT(3plplot), input)
82 World coordinate interval between major ticks on the y axis. If
83 it is set to zero, PLplot automatically generates a suitable
84 tick interval.
85 nysub (PLINT(3plplot), input)
87 Number of subintervals between major y axis ticks for minor
88 ticks. If it is set to zero, PLplot automatically generates a
89 suitable minor tick interval.
90
93 Many developers (who are credited at http://plplot.org/credits.php)
94 have contributed to PLplot over its long history.
95
97 PLplot documentation at http://plplot.org/documentation.php.
98 January, 2023 PLAXES(3plplot)