ndarray.native.js (2107B)
1 /** 2 * @license Apache-2.0 3 * 4 * Copyright (c) 2020 The Stdlib Authors. 5 * 6 * Licensed under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 19 'use strict'; 20 21 // MODULES // 22 23 var Float32Array = require( '@stdlib/array/float32' ); 24 var addon = require( './dsdot.native.js' ); 25 26 27 // MAIN // 28 29 /** 30 * Computes the dot product of `x` and `y` with extended accumulation and result. 31 * 32 * @param {integer} N - number of values over which to compute the dot product 33 * @param {Float32Array} x - first input array 34 * @param {integer} strideX - `x` stride length 35 * @param {NonNegativeInteger} offsetX - starting index for `x` 36 * @param {Float32Array} y - second input array 37 * @param {integer} strideY - `y` stride length 38 * @param {NonNegativeInteger} offsetY - starting index for `y` 39 * @returns {number} dot product of `x` and `y` 40 * 41 * @example 42 * var Float32Array = require( '@stdlib/array/float32' ); 43 * 44 * var x = new Float32Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ); 45 * var y = new Float32Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ); 46 * 47 * var z = dsdot( x.length, x, 1, 0, y, 1, 0 ); 48 * // returns -5.0 49 */ 50 function dsdot( N, x, strideX, offsetX, y, strideY, offsetY ) { 51 var viewX; 52 var viewY; 53 if ( strideX < 0 ) { 54 offsetX += (N-1) * strideX; 55 } 56 if ( strideY < 0 ) { 57 offsetY += (N-1) * strideY; 58 } 59 viewX = new Float32Array( x.buffer, x.byteOffset+(x.BYTES_PER_ELEMENT*offsetX), x.length-offsetX ); // eslint-disable-line max-len 60 viewY = new Float32Array( y.buffer, y.byteOffset+(y.BYTES_PER_ELEMENT*offsetY), y.length-offsetY ); // eslint-disable-line max-len 61 return addon( N, viewX, strideX, viewY, strideY ); 62 } 63 64 65 // EXPORTS // 66 67 module.exports = dsdot;