trusty (3) plhist.3plplot.gz

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 array data.  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, input)
              Number of data points.

       data (const PLFLT *, input)
              Pointer to array with values of the n data points.

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

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

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

       opt (PLINT, 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.sourceforge.net/credits.php)  have  contributed  to
       PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                                 February, 2014                                  PLHIST(3plplot)