magic.binning: Multivariate histogram

multi_binningR Documentation

Multivariate histogram


Constructs a multivariate histogram of the points. Optionally, first tests whether a given value is within the convex hull of input points and constructs the histogram only if this test is TRUE. This function is available for development purposes but is not required otherwise . It is sparsely documented and subject to changes without notice.


multi_binning(m, subsize=trunc(nrow(m)^(Infusion.getOption("binningExponent"))),
              expand=5/100, focal=NULL)



A matrix representing points in d-dimensional space, where d is the number of columns


A control parameter for an undocumented algorithm


A control parameter for an undocumented algorithm


Value to be tested for inclusion within the convex hull. Its elements must have names.


The algorithm may be detailed later.


Either NULL (if the optional test returned FALSE), or an histogram represented as a data frame each row of which represents an histogram cell by its barycenter (a point in d-dimensional space), its “binFactor” (the volume of the cell times the total number of observations) and its “count” (the number of observations within the cell). The returned data frame has the following attributes: attr(.,"stats") are the column names of the d-dimensional points; attr(.,"count") is the column name of the count, and attr(.,"binFactor") is the column name of the binFactor.

Infusion documentation built on Sept. 29, 2022, 1:05 a.m.