FunctionHistogram or Distribution function along columns
Syntax C/C++#include <MFstd.h>
void MF_Cols_distribution( uiMatrix MAbund, fVector Limits, ui nbins, fMatrix MA, ui ht, ui len, int mode );
C++ VecObj#include <OptiVec.h>
void matrix<ui>::Cols_distribution( const vector<T>& Limits, const matrix<T>& MA, int mode=0 );
Pascal/Delphiuses MFstd;
procedure MF_Cols_distribution( MAbund:uiMatrix; Limits:fVector; nbins:UIntSize; MA:fMatrix; ht, len:UIntSize; mode:Integer );
CUDA function C/C++#include <cudaMFstd.h>
int cudaMF_Cols_distribution( uiMatrix d_MAbund, fVector d_Limits, ui nbins, fMatrix d_MA, ui ht, ui len, int mode );
void MFcu_Cols_distribution( uiMatrix h_MAbund, fVector h_Limits, ui nbins, fMatrix h_MA, ui ht, ui len, int mode );
CUDA function Pascal/Delphiuses MFstd;
function cudaMF_Cols_distribution( d_MAbund:uiMatrix; d_Limits:fVector; nbins:UIntSize; d_MA:fMatrix; ht, len:UIntSize; mode:Integer ): IntBool;
procedure MFcu_Cols_distribution( h_MAbund:uiMatrix; h_Limits:fVector; nbins:UIntSize; h_MA:fMatrix; ht, len:UIntSize; mode:Integer );
DescriptionFor each column of MA, this function counts the number of elements falling into each of the intervals defined by Limits. The abundances thus determined are stored in the corresponding columns of MAbund.
nbins is the number of elements of Limits, i.e. the number of intervals. The size of MAbund is nbins*len.

Limits must be in ascending order. The spacing between the elements of Limits need not necessarily be constant.

The parameter mode specifies how to interpret the values given in Limits.
mode > 0: Limits contains the upper limits of the intervals
mode < 0: Limits contains the lower limits of the intervals
mode = 0: Limits contains the mid-points of the intervals. An element of MA belongs to the Limits value closest to it. In case of exactly equal distances, the interval with the lower index is chosen.
The interval defined by Limits0 extends down to -HUGE_VAL, the interval defined by Limitsnbins-1 reaches up to +HUGE_VAL.

In contrast to VF_distribution, elements outside the intervals are not taken into account; their number is not returned.

This function may be used for batch processing of several vectors of equal size. To this end, the vectors have to be copied into the columns of a matrix.

At present, these functions are available only in the 64-bit libraries.

Error handlingnone
Return valuenone
See alsoVF_distribution   MF_Rows_distribution

MatrixLib Table of Contents  OptiVec home