plhist(3plplot)

plhist3plplot

Plot a histogram from unbinned data

Usage

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

Overview

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

Releases

11 releases since Debian 3.1 (Sarge); the text changed 10 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11
  10. 12
  11. 13

Authors

Many developers (who are credited at http://plplot.org/credits.php) have contributed to PLplot over its long history.

From plplot-doc 5.15.0+dfsg2-15 in Debian 13 (Trixie). Parsed by carta from the page's man source.