NAME

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

SYNOPSIS

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

DESCRIPTION

       Draws  a  box around the currently defined viewport with arbitrary world-coordinate origin
       specified by x0 and y0 and labels it with  world  coordinate  values  appropriate  to  the
       window.   Thus  plaxes(3plplot)  should  only  be  called after defining both viewport and
       window.  The ascii character strings xopt and yopt specify how the box should be drawn  as
       described below.  If ticks and/or subticks are to be drawn for a particular axis, the tick
       intervals and number of subintervals may be specified explicitly, or they may be defaulted
       by setting the appropriate arguments to zero.

       Redacted form: General: plaxes(x0, y0, xopt, xtick, nxsub, yopt, ytick, nysub)

       This function is not used in any examples.

ARGUMENTS

       x0 (PLFLT(3plplot), input)
              World X coordinate of origin.

       y0 (PLFLT(3plplot), input)
              World Y coordinate of origin.

       xopt (PLCHAR_VECTOR(3plplot), input)
              An  ascii  character  string  specifying  options  for  the x axis.  The string can
              include any combination of the following letters  (upper  or  lower  case)  in  any
              order:  a: Draws axis, X-axis is horizontal line (y=0), and Y-axis is vertical line
              (x=0).  b: Draws bottom (X) or left (Y) edge of frame.  c: Draws top (X)  or  right
              (Y) edge of frame.  d: Plot labels as date / time. Values are assumed to be seconds
              since the epoch (as used by gmtime).  f:  Always use fixed  point  numeric  labels.
              g:  Draws  a  grid  at  the major tick interval.  h: Draws a grid at the minor tick
              interval.  i: Inverts tick marks, so they are drawn outwards, rather than  inwards.
              l: Labels axis logarithmically.  This only affects the labels, not the data, and so
              it is necessary to compute the logarithms of data points before passing them to any
              of  the  drawing routines.  m: Writes numeric labels at major tick intervals in the
              unconventional location (above box for X, right of box for Y).  n:  Writes  numeric
              labels  at major tick intervals in the conventional location (below box for X, left
              of box for Y).  o: Use custom labelling function to generate axis label text.   The
              custom  labelling  function  can be defined with the plslabelfunc(3plplot) command.
              s: Enables subticks between major ticks, only valid if t  is  also  specified.   t:
              Draws  major  ticks.   u: Exactly like "b" except don't draw edge line.  w: Exactly
              like "c" except don't draw edge line.  x: Exactly  like  "t"  (including  the  side
              effect  of  the  numerical  labels  for the major ticks) except exclude drawing the
              major and minor tick marks.

       xtick (PLFLT(3plplot), input)
              World coordinate interval between major ticks on the x axis. If it is set to  zero,
              PLplot automatically generates a suitable tick interval.

       nxsub (PLINT(3plplot), input)
              Number of subintervals between major x axis ticks for minor ticks.  If it is set to
              zero, PLplot automatically generates a suitable minor tick interval.

       yopt (PLCHAR_VECTOR(3plplot), input)
              An ascii character string specifying options  for  the  y  axis.   The  string  can
              include  any combination of the letters defined above for xopt, and in addition may
              contain: v: Write numeric labels for the y axis parallel to the base of the  graph,
              rather than parallel to the axis.

       ytick (PLFLT(3plplot), input)
              World  coordinate interval between major ticks on the y axis. If it is set to zero,
              PLplot automatically generates a suitable tick interval.

       nysub (PLINT(3plplot), input)
              Number of subintervals between major y axis ticks for minor ticks.  If it is set to
              zero, PLplot automatically generates a suitable minor tick interval.

AUTHORS

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

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                          February, 2023                          PLAXES(3plplot)