bins.optimize: Algorithms minimizing the binning error function 'bins.merr'.
In collectivemedia/binr: Cut Numeric Values Into Evenly Distributed Groups

Description Usage Arguments Value See Also

bins.move - Compute the best move of a value from one bin to its neighbor

bins.split - Split a bin into two bins optimally.

bins.merge - Merges the two bins yielding the largest gain in error reduction.

bins.move.iter - Apply bins.move until there's no change. Can only reduce the error.

bins.split.iter Iterate to repeatedly apply bins.split.

bins.merge.iter Iterate to repeatedly apply bins.merge.

bins.move(xval, xtbl, binlo, binhi, binct, target.bins, verbose = F)

bins.split(xval, xtbl, binlo, binhi, binct, target.bins, force = F,
  verbose = F)

bins.merge(xval, xtbl, binlo, binhi, binct, target.bins, force = F,
  verbose = F)

bins.move.iter(lst, target.bins, verbose = F)

bins.split.iter(lst, target.bins, exact.groups = F, verbose = F)

bins.merge.iter(lst, target.bins, exact.groups = F, verbose = F)

`xval`	Sorted unique values of the data set x. This should be the numeric version of `names(xtbl)`.
`xtbl`	Result of a call to `table(x)`.
`binlo`	The "low" value falling into the bin.
`binhi`	The "high" value falling into the bin.
`binct`	The number of points falling into the bin.
`target.bins`	Number of bins desired; this is also the max number of bins.
`force`	When `TRUE`, splits or merges bins regardless of whether the best gain is positive.
`verbose`	When `TRUE`, prints resulting `binct`.
`lst`	List containing `xval, xtbl, binlo, binhi, binct`.
`exact.groups`	If `FALSE`, run until either the target.bins is reached or there's no more splits or merges that reduce the error. Otherwise (`TRUE`), run until the target.bins is reached, even if that increases the error.

A list containing the following items (not all of them may be present):

binlo - The "low" value falling into the bin.
binhi - The "high" value falling into the bin.
binct - The number of points falling into the bin.
xtbl - The result of a call to table(x).
xval - The sorted unique values of the data points x. Essentially, a numeric version of names(xtbl).
changed - Flag indicating whether the bins have been modified by the function.
err - Mean square root error between the resulting counts and ideal bins.
imax - For the move, merge and split operations, the index of the bin with the maximum gain.
iside - For the move operation, the side of the move: 0 = left, 1 = right.
gain - Error gain obtained as the result of the function call.