Next: histr, Previous: hilbert, Up: Internal Routines [Contents][Index]

`hist(`

`x` [, `l`] [, /first, /ignorelimit, /increaselimit,
/silent])

Returns the histogram (binsize 1) of

. If `x`

is not specified, then the histogram runs between values `l``!histmin`

(zero or negative) and `!histmax`

, and cannot exceed
`!maxhistsize`

bins, unless `/ignorelimit`

or
`/increaselimit`

are specified. `/ignorelimit`

causes the
limit to be ignored, so that histograms of arbitrary (possibly very
large!) size are allowed. `/increaselimit`

increases the value of
`!maxhistsize`

if necessary to accomodate the current histogram.
If `/first`

is specified and

is multidimensional,
then histograms along the first dimension are returned. By default, a
single histogram of the whole array is returned.
`x`

By default, a warning is issued if

contains negative
values (so that the first element of the histogram does not refer to
value 0 from `x`

but to the most negative value). If
`x``/silent`

is specified, then the warning is suppressed.

If

is specified, then in it a list of unique values in
`l`

is returned, in ascending order, and the return value of
the function is the corresponding frequency table. In this case, the
keywords are ignored, and there is no specific limit on the size of the
histogram. This form of the function is useful if one expects that the
histogram is large yet sparsely occupied.
`x`

See also: histr, distr, !histmin, !histmax, !maxhistsize