1PLAXES(3plplot)                   PLplot API                   PLAXES(3plplot)
2
3
4

NAME

6       plaxes - Draw a box with axes, etc. with arbitrary origin
7

SYNOPSIS

9       plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick, nysub)
10

DESCRIPTION

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
22       Redacted form: General: plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick,
23       nysub)
24
25
26       This function is not used in any examples.
27

ARGUMENTS

29       x0 (PLFLT(3plplot), input)
30              World X coordinate of origin.
31
32       y0 (PLFLT(3plplot), input)
33              World Y coordinate of origin.
34
35       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
45              interval.   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
56              major ticks, only valid if t is also specified.  t: Draws  major
57              ticks.   u:  Exactly  like  "b" except don't draw edge line.  w:
58              Exactly like "c" except don't draw edge line.  x:  Exactly  like
59              "t"  (including  the side effect of the numerical labels for the
60              major ticks) except exclude drawing the  major  and  minor  tick
61              marks.
62
63
64       xtick (PLFLT(3plplot), input)
65              World  coordinate interval between major ticks on the x axis. If
66              it is set to zero, PLplot  automatically  generates  a  suitable
67              tick interval.
68
69       nxsub (PLINT(3plplot), input)
70              Number  of  subintervals  between  major  x axis ticks for minor
71              ticks.  If it is set to zero, PLplot automatically  generates  a
72              suitable minor tick interval.
73
74       yopt (PLCHAR_VECTOR(3plplot), input)
75              An  ascii  character  string  specifying options for the y axis.
76              The string can include any combination of  the  letters  defined
77              above  for  xopt,  and in addition may contain: v: Write numeric
78              labels for the y axis parallel to the base of the graph,  rather
79              than parallel to the axis.
80
81
82       ytick (PLFLT(3plplot), input)
83              World  coordinate interval between major ticks on the y axis. If
84              it is set to zero, PLplot  automatically  generates  a  suitable
85              tick interval.
86
87       nysub (PLINT(3plplot), input)
88              Number  of  subintervals  between  major  y axis ticks for minor
89              ticks.  If it is set to zero, PLplot automatically  generates  a
90              suitable minor tick interval.
91
92

AUTHORS

94       Many  developers  (who  are  credited at http://plplot.org/credits.php)
95       have contributed to PLplot over its long history.
96

SEE ALSO

98       PLplot documentation at http://plplot.org/documentation.php.
99
100
101
102                                September, 2020                PLAXES(3plplot)
Impressum