
plhist: Plot a histogram from unbinned data 

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 to draw the resulting histogram.  Parameter
    opt allows, among other things, the histogram either to be plotted in
    an existing window or causes plhist to call plenv with suitable limits
    before plotting the histogram. 

SYNOPSIS:

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

ARGUMENTS:

    n (PLINT, input) :      Number of data points. 

    data (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 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). 
