HSTOPL - Turns options off and on for the Histogram utility.

       To  use HSTOPL or c_hstopl, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
       that order.

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

       #include <ncarg/ncargC.h>

       void c_hstopl (char *string)

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     HSTOPL(3NCARG)

       STRING      Character, input -- Selects an internal parameter.  The possibilities are:

                      ´HOR=ON´ or ´HOR=OFF´
                      ´PER=ON´ or ´PER=OFF´
                      ´MID=ON´ or ´MID=OFF´
                      ´SHA=ON´ or ´SHA=OFF´
                      ´DRL=ON´ or ´DRL=OFF´
                      ´MED=ON´ or ´MED=OFF´
                      ´NMV=ON´ or ´NMV=OFF´
                      ´PMV=ON´ or ´PMV=OFF´
                      ´PRM=ON´ or ´PRM=OFF´
                      ´FRA=ON´ or ´FRA=OFF´
                      ´LIS=ON´ or ´LIS=OFF´
                      ´DEF=ON´ or ´DEF=OFF´

                   The following options are defined by this subroutine:

                   HOR     The  histogram bars are drawn horizontally if ´HOR=ON´, vertically if ´HOR=OFF´.  The
                           default is ´HOR=OFF´.

                   PER     If ´PER=ON´, a labeled percent axis is drawn on the right side of the histogram  (top
                           if ´HOR=ON´.)  If ´PER=OFF´, no percent axis is drawn.  The default is ´PER=ON´.

                           This places a second axis on the opposite side of the frame from the normal frequency
                           axis.

                   MID     If  ´MID=ON´,  class  labels  are  placed  at the midpoint of each class interval. If
                           ´MID=OFF´, the class interval end points are labeled. (MID defaults to ON if IFLAG  =
                           2 or 3.)  The default is ´MID=ON´.

                   SHA     If  ´SHA=ON´,  the histogram bars are shaded.  If ´SHA=OFF´, the bars are not shaded.
                           The default is ´SHA=ON´.

                           Devices will vary as to how they interpret shading.

                   DRL     If ´DRL=ON´, lines are drawn through the histogram bars where Y-axis tick marks would
                           occur.  When comparing two datasets (IFLAG=3), lines are only drawn through the  bars
                           associated with the first dataset.  If ´DRL=OFF´, no lines are drawn.  The default is
                           ´DRL=OFF´.

                   MED     If  ´MED=ON´,  a  line is drawn through the median value of all points. If ´MED=OFF´,
                           this line is not drawn. MED does not apply when assigning Y-values to X-values; it is
                           valid only for IFLAG = 1 or 2.  The default is ´MED=OFF´.

                   NMV     If ´NMV=ON´, histogram bar percentages will be calculated with respect to the  number
                           of  input  data  values (NPTS) minus the number of detected missing values (MISS), or
                           NMVA = NPTS - MISS.  If ´NMV=OFF´, histogram bar percentages will  be  normalized  to
                           NPTS.

                   PMV     If  ´PMV=ON´,  missing  value counts will be written on the plot.  If ´NMV=OFF´, they
                           will not.

                   PRM     If ´PRM=ON´, a perimeter is drawn around the histogram.  If ´PRM=OFF´,  no  perimeter
                           is drawn.  The default is ´PRM=OFF´.

                   FRA     If  ´FRA=ON´,  the  frame is advanced automatically after the histogram is drawn.  If
                           ´FRA=OFF´, the frame is not advanced, and the user must call FRAME.  The  default  is
                           ´FRA=ON´.

                   LIS     If  ´LIS=ON´,  all  the  options  along with their values are printed on the standard
                           output. If ´LIS=OFF´, nothing is printed on the  standard  output.   The  default  is
                           ´LIS=OFF´.

                   DEF     If  ´DEF=ON´,  ALL  the  options are reset to their default values.  ´DEF=OFF´ has no
                           effect.  All parameters begin at their default values.

       Use the command "ncargex thstgr" to generate a three  frame  example  of  various  types  of  histograms.
       "ncargex thstmv" will show three examples of histograms with missing values in the input data.

       See the histogram man page for a  description  of  all  Histogram  error  messages  and/or  informational
       messages.

       HSTOPL - Turns options off and on for the Histogram utility.

       Online: histogram, histogram_params, histgr, hstopc, hstopi, hstopr, ncarg_cbind

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

       CALL HSTOPL (STRING)

       HSTOPL is called to toggle histogram options before entry HISTGR is called to generate the histogram.