FunctionHistogram or Distribution function along rows
Syntax C/C++#include <MFstd.h>
void MF_Rows_distribution( uiMatrix MAbund, fVector Limits, ui nbins, fMatrix MA, ui ht, ui len, int mode );
C++ VecObj#include <OptiVec.h>
void matrix<ui>::Rows_distribution( const vector<T>& Limits, const matrix<T>& MA, int mode=0 );
Pascal/Delphiuses MFstd;
procedure MF_Rows_distribution( MAbund:uiMatrix; Limits:fVector; nbins:UIntSize; MA:fMatrix; ht, len:UIntSize; mode:Integer );
CUDA function C/C++#include <cudaMFstd.h>
int cudaMF_Rows_distribution( uiMatrix d_MAbund, fVector d_Limits, ui nbins, fMatrix d_MA, ui ht, ui len, int mode );
void MFcu_Rows_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_Rows_distribution( d_MAbund:uiMatrix; d_Limits:fVector; nbins:UIntSize; d_MA:fMatrix; ht, len:UIntSize; mode:Integer ): IntBool;
procedure MFcu_Rows_distribution( h_MAbund:uiMatrix; h_Limits:fVector; nbins:UIntSize; h_MA:fMatrix; ht, len:UIntSize; mode:Integer );
DescriptionFor each row 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 ht*nbins.

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 rows of a matrix.

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

Error handlingnone
Return valuenone
See alsoVF_distribution   MF_Cols_distribution

MatrixLib Table of Contents  OptiVec home