oracular (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 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.

                                                  August, 2024                                   PLHIST(3plplot)