All files / base/gtriu2tril/lib accessors.js

62.03% Statements 67/108
100% Branches 1/1
0% Functions 0/1
62.03% Lines 67/108

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 1091x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x                                                                                   1x 1x 1x 1x 1x  
/**
* @license Apache-2.0
*
* Copyright (c) 2026 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*    http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
 
/* eslint-disable max-len, max-params */
 
'use strict';
 
// MODULES //
 
var isRowMajor = require( '@stdlib/ndarray/base/assert/is-row-major' );
var max = require( '@stdlib/math/base/special/fast/max' );
var min = require( '@stdlib/math/base/special/fast/min' );
 
 
// MAIN //
 
/**
* Reflects the upper triangular part of a matrix `A` into the lower triangular part of another matrix `B`.
*
* @private
* @param {NonNegativeInteger} M - number of rows in matrix `A`
* @param {NonNegativeInteger} N - number of columns in matrix `A`
* @param {integer} k - diagonal below which to ignore
* @param {Object} A - input matrix object
* @param {Collection} A.data - input matrix data
* @param {Array<Function>} A.accessors - matrix element accessors
* @param {integer} strideA1 - stride of the first dimension of `A`
* @param {integer} strideA2 - stride of the second dimension of `A`
* @param {NonNegativeInteger} offsetA - starting index for `A`
* @param {Object} B - output matrix object
* @param {Collection} B.data - output matrix data
* @param {Array<Function>} B.accessors - matrix element accessors
* @param {integer} strideB1 - stride of the first dimension of `B`
* @param {integer} strideB2 - stride of the second dimension of `B`
* @param {NonNegativeInteger} offsetB - starting index for `B`
* @returns {Object} `B`
*
* @example
* var toAccessorArray = require( '@stdlib/array/base/to-accessor-array' );
* var arraylike2object = require( '@stdlib/array/base/arraylike2object' );
*
* var A = arraylike2object( toAccessorArray( [ 1.0, 2.0, 3.0, 4.0 ] ) );
* var B = arraylike2object( toAccessorArray( [ 0.0, 0.0, 0.0, 0.0 ] ) );
*
* gtriu2tril( 2, 2, 0, A, 2, 1, 0, B, 2, 1, 0 );
* // B.data => [ 1.0, 0.0, 2.0, 4.0 ]
*/
function gtriu2tril( M, N, k, A, strideA1, strideA2, offsetA, B, strideB1, strideB2, offsetB ) {
	var abuf;
	var bbuf;
	var aget;
	var bset;
	var ia;
	var ib;
	var i0;
	var i1;

	// Cache references to array data:
	abuf = A.data;
	bbuf = B.data;

	// Cache references to the element accessors:
	aget = A.accessors[ 0 ];
	bset = B.accessors[ 1 ];

	ia = offsetA;
	ib = offsetB;
	if ( isRowMajor( [ strideA1, strideA2 ] ) ) {
		// Reflect row-by-row in order to ensure cache-optimal traversal...
		for ( i1 = 0; i1 < M; i1++ ) {
			for ( i0 = max( 0, i1+k ); i0 < N; i0++ ) {
				bset( bbuf, ib+(i0*strideB1), aget( abuf, ia+(i0*strideA2) ) );
			}
			ia += strideA1;
			ib += strideB2;
		}
		return B;
	}
	// Reflect column-by-column in order to ensure cache-optimal traversal...
	for ( i1 = 0; i1 < N; i1++ ) {
		for ( i0 = 0; i0 <= min( i1-k, M-1 ); i0++ ) {
			bset( bbuf, ib+(i0*strideB2), aget( abuf, ia+(i0*strideA1) ) );
		}
		ia += strideA2;
		ib += strideB1;
	}
	return B;
}
 
 
// EXPORTS //
 
module.exports = gtriu2tril;