MatrixInt.BlockInit Method

Overload List

#SignatureDescription
1void BlockInitInitializes block processing.
2void BlockInit(TMtxVecInt Src)Initializes block processing.
3void BlockInit(TMtxVecInt Src, Int32 ABlockSize)Initializes block processing.
4void BlockInit(Int32 ABlockSize)Initializes block processing with specified ABLockSize.

Overload 1: void BlockInit

Initializes block processing.

Result: stored in self (calling object)

Remarks:

Initializes block processing. Because the size of the CPU cache is limited, significant performance gains can be obtained by splitting long vectors in to a series of short ones, which can all fit in the CPU cache entirely. The BlockInit method is to be used together with Dew.Math.MatrixInt.BlockNext and methods to initialize a block processing while loop. BlockInit will call to obtain subrange of the data in TMtxInt. The Dew.Math.MatrixInt.Length of the subranged vector is determined by the global Dew.Math.Units.Math387.MtxVecBlockSize variable declared in unit. Default value of MtxVecBlockSize is preset to 800 vector elements for double precision and 1600 elements for single precision. BlockInit supports nested calls and from witihin a blocked while loop you can call procedures and functions which are also blocked. If you use block processing, typical performance gains will range from 2 to a maximum of 6. Block processing can not be used, or it is difficult to apply, in cases where vector elements are not independent of each other. The block processing while loop must be written like this:

Examples
a.BlockInit;
while !A.BlockEnd do
// .... user defined function
a.BlockNext;
See Also: MatrixInt.BlockNext, MatrixInt.BlockEnd

Overload 2: void BlockInit(TMtxVecInt Src)

Initializes block processing.

#NameTypeDescription
1SrcTMtxVecIntsource TVecInt or TMtxInt

Result: stored in self (calling object)

Overload 3: void BlockInit(TMtxVecInt Src, Int32 ABlockSize)

Initializes block processing.

#NameTypeDescription
1SrcTMtxVecIntsource TVecInt or TMtxInt
2ABlockSizeInt32

Result: stored in self (calling object)

Remarks:

Block processing can be applied on possibly already subranged Src object. Src may not be freed or go out of scope until block processing loop has finished. There would be no error raised other than AV.

Overload 4: void BlockInit(Int32 ABlockSize)

Initializes block processing with specified ABLockSize.

#NameTypeDescription
1ABlockSizeInt32

Result: stored in self (calling object)