NAME

       plbox - Draw a box with axes, etc

SYNOPSIS

       plbox(xopt, xtick, nxsub, yopt, ytick, nysub)

DESCRIPTION

       Draws  a  box  around  the currently defined viewport, and labels it with world coordinate
       values appropriate to the  window.   Thus  plbox(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: plbox(xopt, xtick, nxsub, yopt, ytick, nysub)

       This function is used in examples 1, 2, 4, 6, 6-12, 14-18, 21, 23-26, and 29.

ARGUMENTS

       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.

                                           August, 2023                            PLBOX(3plplot)