Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

plhist(3plplot) [debian man page]

PLHIST(3plplot) 						    PLplot API							   PLHIST(3plplot)

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

       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This man page was automatically generated from the DocBook source of the
       PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.

SEE ALSO

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

								   August, 2012 						   PLHIST(3plplot)

Check Out this Related Man Page

PLBIN(3plplot)							    PLplot API							    PLBIN(3plplot)

NAME

       plbin - Plot a histogram from binned data

SYNOPSIS

       plbin(nbin, x, y, opt)

DESCRIPTION

       Plots  a  histogram consisting of nbin bins.  The value associated with the i'th bin is placed in x[i], and the number of points in the bin
       is placed in y[i].  For proper operation, the values in x[i] must form a strictly increasing sequence.  By default, x[i] is  the  left-hand
       edge  of  the  i'th  bin.  If opt=PL_BIN_CENTRED is used, the bin boundaries are placed midway between the values in the x array.  Also see
       plhist(3plplot) for drawing histograms from unbinned data.

       Redacted form:  General: plbin(x, y, opt) Perl/PDL: plbin(nbin, x, y, opt) Python: plbin(nbin, x, y, opt)

       This function is not used in any examples.

ARGUMENTS

       nbin (PLINT, input)
	      Number of bins (i.e., number of values in x and y arrays.)

       x (PLFLT *, input)
	      Pointer to array containing values associated with bins.	These must form a strictly increasing sequence.

       y (PLFLT *, input)
	      Pointer to array containing number of points in bin.  This is a PLFLT (instead of PLINT) array so as to allow histograms	of  proba-
	      bilities, etc.

       opt (PLINT, input)
	      Is a combination of several flags: opt=PL_BIN_DEFAULT: The x represent the lower bin boundaries, the outer bins are expanded to fill
	      up the entire x-axis and bins of zero height are simply drawn.  opt=PL_BIN_CENTRED|...: The bin boundaries are to be midway  between
	      the  x  values.  If  the values in x are equally spaced, the values are the center values of the bins.  opt=PL_BIN_NOEXPAND|...: The
	      outer bins are drawn with equal size as the ones inside.	opt=PL_BIN_NOEMPTY|...: Bins with zero height are not drawn  (there  is  a
	      gap for such bins).

AUTHORS

       Geoffrey  Furnish  and  Maurice LeBrun wrote and maintain PLplot.  This man page was automatically generated from the DocBook source of the
       PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.

SEE ALSO

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

								   August, 2012 						    PLBIN(3plplot)
Man Page