NAME

       plhist - Plot a histogram from unbinned data

SYNOPSIS

       plhist(n, data, datmin, datmax, nbin, opt)

DESCRIPTION

       Plots  a  histogram  from  n data points stored in the data vector.  This routine bins the data into nbin
       bins equally spaced between datmin and datmax, and calls plbin(3plplot) to draw the resulting  histogram.
       Parameter  opt  allows,  among  other things, the histogram either to be plotted in an existing window or
       causes plhist(3plplot) to call plenv(3plplot) with suitable limits before plotting the histogram.

       Redacted form: plhist(data, datmin, datmax, nbin, opt)

       This function is used in example 5.

ARGUMENTS

       n (PLINT(3plplot), input)
              Number of data points.

       data (PLFLT_VECTOR(3plplot), input)
              A vector containing the values of the n data points.

       datmin (PLFLT(3plplot), input)
              Left-hand edge of lowest-valued bin.

       datmax (PLFLT(3plplot), input)
              Right-hand edge of highest-valued bin.

       nbin (PLINT(3plplot), input)
              Number of (equal-sized) bins into which to divide the interval xmin to xmax.

       opt (PLINT(3plplot), input)
              Is a combination of several flags: opt=PL_HIST_DEFAULT: The axes are automatically rescaled to fit
              the histogram data, the outer bins are expanded to fill up the entire  x-axis,  data  outside  the
              given  extremes  are  assigned  to  the  outer  bins  and  bins  of  zero height are simply drawn.
              opt=PL_HIST_NOSCALING|...: The existing axes are not rescaled to fit the histogram  data,  without
              this     flag,     plenv(3plplot)     is     called     to     set    the    world    coordinates.
              opt=PL_HIST_IGNORE_OUTLIERS|...: Data outside the given extremes are not taken into account.  This
              option  should  probably  be combined with opt=PL_HIST_NOEXPAND|..., so as to properly present the
              data.  opt=PL_HIST_NOEXPAND|...: The outer bins are drawn with equal  size  as  the  ones  inside.
              opt=PL_HIST_NOEMPTY|...: Bins with zero height are not drawn (there is a gap for such bins).

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.

                                                  October, 2024                                  PLHIST(3plplot)