From b7e12f720df84574371fff43722d15e5ca04361c Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 16:09:37 +0000 Subject: [PATCH 01/11] refactor blas/ext/base/dsumkbn2 --- .../@stdlib/blas/ext/base/dsumkbn2/README.md | 29 +++++-------------- .../ext/base/dsumkbn2/benchmark/benchmark.js | 19 ++++++------ .../dsumkbn2/benchmark/benchmark.native.js | 15 ++++------ .../dsumkbn2/benchmark/benchmark.ndarray.js | 19 ++++++------ .../benchmark/benchmark.ndarray.native.js | 15 ++++------ .../blas/ext/base/dsumkbn2/docs/repl.txt | 18 +++++------- .../blas/ext/base/dsumkbn2/examples/index.js | 15 +++------- .../blas/ext/base/dsumkbn2/include.gypi | 4 +-- .../blas/ext/base/dsumkbn2/lib/index.js | 6 ++-- .../blas/ext/base/dsumkbn2/lib/ndarray.js | 6 ++-- .../ext/base/dsumkbn2/lib/ndarray.native.js | 16 ++++------ .../blas/ext/base/dsumkbn2/manifest.json | 7 ++++- .../base/dsumkbn2/src/{addon.cpp => addon.c} | 0 .../ext/base/dsumkbn2/test/test.dsumkbn2.js | 16 +++++----- .../dsumkbn2/test/test.dsumkbn2.native.js | 11 ++++--- .../ext/base/dsumkbn2/test/test.ndarray.js | 11 ++++--- .../base/dsumkbn2/test/test.ndarray.native.js | 11 ++++--- 17 files changed, 87 insertions(+), 131 deletions(-) rename lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/{addon.cpp => addon.c} (100%) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md index 245aa6c28fd5..304da1f7cc86 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md @@ -2,7 +2,7 @@ @license Apache-2.0 -Copyright (c) 2020 The Stdlib Authors. +Copyright (c) 2024 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. @@ -56,16 +56,14 @@ The function has the following parameters: - **x**: input [`Float64Array`][@stdlib/array/float64]. - **stride**: index increment for `x`. -The `N` and `stride` parameters determine which elements in `x` are accessed at runtime. For example, to compute the sum of every other element in `x`, +The `N` and stride parameters determine which elements in the strided array are accessed at runtime. For example, to compute the sum of every other element in `x`, ```javascript var Float64Array = require( '@stdlib/array/float64' ); -var floor = require( '@stdlib/math/base/special/floor' ); var x = new Float64Array( [ 1.0, 2.0, 2.0, -7.0, -2.0, 3.0, 4.0, 2.0 ] ); -var N = floor( x.length / 2 ); -var v = dsumkbn2( N, x, 2 ); +var v = dsumkbn2( 4, x, 2 ); // returns 5.0 ``` @@ -75,14 +73,11 @@ Note that indexing is relative to the first index. To introduce an offset, use [ ```javascript var Float64Array = require( '@stdlib/array/float64' ); -var floor = require( '@stdlib/math/base/special/floor' ); var x0 = new Float64Array( [ 2.0, 1.0, 2.0, -2.0, -2.0, 2.0, 3.0, 4.0 ] ); var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element -var N = floor( x0.length / 2 ); - -var v = dsumkbn2( N, x1, 2 ); +var v = dsumkbn2( 4, x1, 2 ); // returns 5.0 ``` @@ -111,9 +106,8 @@ var Float64Array = require( '@stdlib/array/float64' ); var floor = require( '@stdlib/math/base/special/floor' ); var x = new Float64Array( [ 2.0, 1.0, 2.0, -2.0, -2.0, 2.0, 3.0, 4.0 ] ); -var N = floor( x.length / 2 ); -var v = dsumkbn2.ndarray( N, x, 2, 1 ); +var v = dsumkbn2.ndarray( 4, x, 2, 1 ); // returns 5.0 ``` @@ -138,18 +132,11 @@ var v = dsumkbn2.ndarray( N, x, 2, 1 ); ```javascript -var randu = require( '@stdlib/random/base/randu' ); -var round = require( '@stdlib/math/base/special/round' ); -var Float64Array = require( '@stdlib/array/float64' ); +var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var dsumkbn2 = require( '@stdlib/blas/ext/base/dsumkbn2' ); -var x; -var i; - -x = new Float64Array( 10 ); -for ( i = 0; i < x.length; i++ ) { - x[ i ] = round( randu()*100.0 ); -} +var x = filledarrayBy(10, 'float64', discreteUniform(0, 100)); console.log( x ); var v = dsumkbn2( x.length, x, 1 ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.js index afec7cc9c189..733f7a5b9700 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2020 The Stdlib Authors. +* Copyright (c) 2024 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. @@ -21,14 +21,19 @@ // MODULES // var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); -var Float64Array = require( '@stdlib/array/float64' ); var pkg = require( './../package.json' ).name; var dsumkbn2 = require( './../lib/dsumkbn2.js' ); +// VARIABLES // + +var rand = uniform( -100.0, 100.0 ); + + // FUNCTIONS // /** @@ -39,13 +44,7 @@ var dsumkbn2 = require( './../lib/dsumkbn2.js' ); * @returns {Function} benchmark function */ function createBenchmark( len ) { - var x; - var i; - - x = new Float64Array( len ); - for ( i = 0; i < x.length; i++ ) { - x[ i ] = ( randu()*10.0 ) - 20.0; - } + var x = filledarrayBy( len, 'float64', rand ); return benchmark; function benchmark( b ) { diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.native.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.native.js index 493ad09a311e..ba168cb0f3e0 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.native.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.native.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2020 The Stdlib Authors. +* Copyright (c) 2024 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. @@ -22,10 +22,10 @@ var resolve = require( 'path' ).resolve; var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); -var Float64Array = require( '@stdlib/array/float64' ); var tryRequire = require( '@stdlib/utils/try-require' ); var pkg = require( './../package.json' ).name; @@ -36,6 +36,7 @@ var dsumkbn2 = tryRequire( resolve( __dirname, './../lib/dsumkbn2.native.js' ) ) var opts = { 'skip': ( dsumkbn2 instanceof Error ) }; +var rand = uniform( -100.0, 100.0 ); // FUNCTIONS // @@ -48,13 +49,7 @@ var opts = { * @returns {Function} benchmark function */ function createBenchmark( len ) { - var x; - var i; - - x = new Float64Array( len ); - for ( i = 0; i < x.length; i++ ) { - x[ i ] = ( randu()*10.0 ) - 20.0; - } + var x = filledarrayBy( len, 'float64', rand ); return benchmark; function benchmark( b ) { diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.js index 98158b67b5ef..98229b58fb44 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2020 The Stdlib Authors. +* Copyright (c) 2024 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. @@ -21,14 +21,19 @@ // MODULES // var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); -var Float64Array = require( '@stdlib/array/float64' ); var pkg = require( './../package.json' ).name; var dsumkbn2 = require( './../lib/ndarray.js' ); +// VARIABLES // + +var rand = uniform( -100.0, 100.0 ); + + // FUNCTIONS // /** @@ -39,13 +44,7 @@ var dsumkbn2 = require( './../lib/ndarray.js' ); * @returns {Function} benchmark function */ function createBenchmark( len ) { - var x; - var i; - - x = new Float64Array( len ); - for ( i = 0; i < x.length; i++ ) { - x[ i ] = ( randu()*10.0 ) - 20.0; - } + var x = filledarrayBy( len, 'float64', rand ); return benchmark; function benchmark( b ) { diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.native.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.native.js index 7d229a4c8bbc..e9714ba95fa5 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.native.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/benchmark/benchmark.ndarray.native.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2020 The Stdlib Authors. +* Copyright (c) 2024 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. @@ -22,10 +22,10 @@ var resolve = require( 'path' ).resolve; var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); -var Float64Array = require( '@stdlib/array/float64' ); var tryRequire = require( '@stdlib/utils/try-require' ); var pkg = require( './../package.json' ).name; @@ -36,6 +36,7 @@ var dsumkbn2 = tryRequire( resolve( __dirname, './../lib/ndarray.native.js' ) ); var opts = { 'skip': ( dsumkbn2 instanceof Error ) }; +var rand = uniform( -100.0, 100.0 ); // FUNCTIONS // @@ -48,13 +49,7 @@ var opts = { * @returns {Function} benchmark function */ function createBenchmark( len ) { - var x; - var i; - - x = new Float64Array( len ); - for ( i = 0; i < x.length; i++ ) { - x[ i ] = ( randu()*10.0 ) - 20.0; - } + var x = filledarrayBy( len, 'float64', rand ); return benchmark; function benchmark( b ) { diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt index 9f7b1409d597..1cf068f99f58 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt @@ -3,8 +3,8 @@ Computes the sum of double-precision floating-point strided array elements using a second-order iterative Kahan–Babuška algorithm. - The `N` and `stride` parameters determine which elements in `x` are accessed - at runtime. + The `N` and `stride` parameters determine which elements in the strided + array are accessed at runtime. Indexing is relative to the first index. To introduce an offset, use a typed array view. @@ -36,19 +36,16 @@ // Using `N` and `stride` parameters: > x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 1.0, -5.0, 2.0, -1.0 ] ); - > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); - > var stride = 2; - > {{alias}}( N, x, stride ) + > {{alias}}( 3, x, stride ) 1.0 // Using view offsets: > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); > var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); - > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 ); - > stride = 2; - > {{alias}}( N, x1, stride ) + > {{alias}}( 3, x1, stride ) -1.0 + {{alias}}.ndarray( N, x, stride, offset ) Computes the sum of double-precision floating-point strided array elements using a second-order iterative Kahan–Babuška algorithm and alternative @@ -85,9 +82,8 @@ 1.0 // Using offset parameter: - > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); - > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); - > {{alias}}.ndarray( N, x, 2, 1 ) + > x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); + > {{alias}}.ndarray( 3, x, 2, 1 ) -1.0 See Also diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/examples/index.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/examples/index.js index f0a9b781d101..1b765624cdd0 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/examples/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/examples/index.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2020 The Stdlib Authors. +* Copyright (c) 2024 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. @@ -18,18 +18,11 @@ 'use strict'; -var randu = require( '@stdlib/random/base/randu' ); -var round = require( '@stdlib/math/base/special/round' ); -var Float64Array = require( '@stdlib/array/float64' ); +var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var dsumkbn2 = require( './../lib' ); -var x; -var i; - -x = new Float64Array( 10 ); -for ( i = 0; i < x.length; i++ ) { - x[ i ] = round( randu()*100.0 ); -} +var x = filledarrayBy( 10, 'float64', discreteUniform( -100.0, 100.0 ) ); console.log( x ); var v = dsumkbn2( x.length, x, 1 ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/include.gypi b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/include.gypi index 868c5c12e852..575cb043c0bf 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/include.gypi +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/include.gypi @@ -1,6 +1,6 @@ # @license Apache-2.0 # -# Copyright (c) 2020 The Stdlib Authors. +# Copyright (c) 2024 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. @@ -36,7 +36,7 @@ # Source files: 'src_files': [ - '<(src_dir)/addon.cpp', + '<(src_dir)/addon.c', ' Date: Fri, 22 Mar 2024 23:12:13 +0530 Subject: [PATCH 02/11] Delete lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.cpp Signed-off-by: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> --- .../blas/ext/base/dsumkbn2/src/addon.c | 117 ------------------ 1 file changed, 117 deletions(-) delete mode 100644 lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c deleted file mode 100644 index 924413149a5e..000000000000 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c +++ /dev/null @@ -1,117 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2020 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. -*/ - -#include "stdlib/blas/ext/base/dsumkbn2.h" -#include -#include -#include -#include -#include - -/** -* Add-on namespace. -*/ -namespace stdlib_blas_ext_base_dsumkbn2 { - - /** - * Computes the sum of double-precision floating-point strided array elements using a second-order iterative Kahan–Babuška algorithm. - * - * ## Notes - * - * - When called from JavaScript, the function expects three arguments: - * - * - `N`: number of indexed elements - * - `X`: input array - * - `stride`: stride length - */ - napi_value node_dsumkbn2( napi_env env, napi_callback_info info ) { - napi_status status; - - size_t argc = 3; - napi_value argv[ 3 ]; - status = napi_get_cb_info( env, info, &argc, argv, nullptr, nullptr ); - assert( status == napi_ok ); - - if ( argc < 3 ) { - napi_throw_error( env, nullptr, "invalid invocation. Must provide 3 arguments." ); - return nullptr; - } - - napi_valuetype vtype0; - status = napi_typeof( env, argv[ 0 ], &vtype0 ); - assert( status == napi_ok ); - if ( vtype0 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. First argument must be a number." ); - return nullptr; - } - - bool res; - status = napi_is_typedarray( env, argv[ 1 ], &res ); - assert( status == napi_ok ); - if ( res == false ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); - return nullptr; - } - - napi_valuetype vtype2; - status = napi_typeof( env, argv[ 2 ], &vtype2 ); - assert( status == napi_ok ); - if ( vtype2 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. Third argument must be a number." ); - return nullptr; - } - - int64_t N; - status = napi_get_value_int64( env, argv[ 0 ], &N ); - assert( status == napi_ok ); - - int64_t stride; - status = napi_get_value_int64( env, argv[ 2 ], &stride ); - assert( status == napi_ok ); - - napi_typedarray_type vtype1; - size_t xlen; - void *X; - status = napi_get_typedarray_info( env, argv[ 1 ], &vtype1, &xlen, &X, nullptr, nullptr ); - assert( status == napi_ok ); - if ( vtype1 != napi_float64_array ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); - return nullptr; - } - if ( (N-1)*llabs(stride) >= (int64_t)xlen ) { - napi_throw_range_error( env, nullptr, "invalid argument. Second argument has insufficient elements based on the associated stride and the number of indexed elements." ); - return nullptr; - } - - napi_value v; - status = napi_create_double( env, stdlib_strided_dsumkbn2( N, (double *)X, stride ), &v ); - assert( status == napi_ok ); - - return v; - } - - napi_value Init( napi_env env, napi_value exports ) { - napi_status status; - napi_value fcn; - status = napi_create_function( env, "exports", NAPI_AUTO_LENGTH, node_dsumkbn2, NULL, &fcn ); - assert( status == napi_ok ); - return fcn; - } - - NAPI_MODULE( NODE_GYP_MODULE_NAME, Init ) -} // end namespace stdlib_blas_ext_base_dsumkbn2 From 46b00c34379464913cc01039ee504e08263b16e0 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 17:43:47 +0000 Subject: [PATCH 03/11] refactoring changes --- .../blas/ext/base/dsumkbn2/manifest.json | 80 +++++++++---------- .../blas/ext/base/dsumkbn2/src/addon.c | 48 +++++++++++ 2 files changed, 88 insertions(+), 40 deletions(-) create mode 100644 lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json index 54d5e4093847..0768f5afcbd2 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json @@ -1,45 +1,45 @@ { - "options": {}, +"options": {}, "fields": [ - { - "field": "src", - "resolve": true, - "relative": true - }, - { - "field": "include", - "resolve": true, - "relative": true - }, - { - "field": "libraries", - "resolve": false, - "relative": false - }, - { - "field": "libpath", - "resolve": true, - "relative": false - } + { + "field": "src", + "resolve": true, + "relative": true + }, + { + "field": "include", + "resolve": true, + "relative": true + }, + { + "field": "libraries", + "resolve": false, + "relative": false + }, + { + "field": "libpath", + "resolve": true, + "relative": false + } ], "confs": [ - { - "src": [ - "./src/dsumkbn2.c" - ], - "include": [ - "./include" - ], - "libraries": [ - "-lm" - ], - "libpath": [], - "dependencies": [ - "stdlib/napi/export.h", - "stdlib/napi/argv.h", - "stdlib/napi/argv_int64.h", - "stdlib/napi/argv_strided_float32array.h" - ] - } + { + "src": [ + "./src/dsumkbn2.c" + ], + "include": [ + "./include" + ], + "libraries": [ + "-lm" + ], + "libpath": [], + "dependencies": [ + "@stdlib/napi/export", + "@stdlib/napi/argv", + "@stdlib/napi/argv-int64", + "@stdlib/napi/argv-strided-float64array" + ] + } ] -} + } \ No newline at end of file diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c new file mode 100644 index 000000000000..e0272f5dea06 --- /dev/null +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c @@ -0,0 +1,48 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2024 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. +*/ + +#include "stdlib/blas/ext/base/ssumpw.h" +#include "stdlib/napi/export.h" +#include "stdlib/napi/argv.h" +#include "stdlib/napi/argv_int64.h" +#include "stdlib/napi/argv_strided_float32array.h" +#include +#include + +/** +* Receives JavaScript callback invocation data. +* +* @private +* @param env environment under which the function is invoked +* @param info callback data +* @return Node-API value +*/ +static napi_value addon( napi_env env, napi_callback_info info ) { + STDLIB_NAPI_ARGV( env, info, argv, argc, 3 ); + STDLIB_NAPI_ARGV_INT64( env, N, argv, 0 ); + STDLIB_NAPI_ARGV_INT64( env, stride, argv, 2 ); + STDLIB_NAPI_ARGV_STRIDED_FLOAT32ARRAY( env, X, N, stride, argv, 1 ); + + napi_value v; + napi_status status = napi_create_double( env, (double)stdlib_strided_ssumpw( N, (float *)X, stride ), &v ); + assert( status == napi_ok ); + + return v; +} + +STDLIB_NAPI_MODULE_EXPORT_FCN( addon ) \ No newline at end of file From 97cf1c3fca731a20e686d5722b31286d266ca750 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 18:07:32 +0000 Subject: [PATCH 04/11] refactoring changes --- .../@stdlib/blas/ext/base/dsumkbn2/README.md | 6 +- .../ext/base/dsumkbn2/lib/ndarray.native.js | 1 + .../blas/ext/base/dsumkbn2/manifest.json | 88 +++++++++---------- 3 files changed, 47 insertions(+), 48 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md index 304da1f7cc86..621eeff13835 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/README.md @@ -44,9 +44,8 @@ Computes the sum of double-precision floating-point strided array elements using var Float64Array = require( '@stdlib/array/float64' ); var x = new Float64Array( [ 1.0, -2.0, 2.0 ] ); -var N = x.length; -var v = dsumkbn2( N, x, 1 ); +var v = dsumkbn2( 3, x, 1 ); // returns 1.0 ``` @@ -89,9 +88,8 @@ Computes the sum of double-precision floating-point strided array elements using var Float64Array = require( '@stdlib/array/float64' ); var x = new Float64Array( [ 1.0, -2.0, 2.0 ] ); -var N = x.length; -var v = dsumkbn2.ndarray( N, x, 1, 0 ); +var v = dsumkbn2.ndarray( 3, x, 1, 0 ); // returns 1.0 ``` diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/lib/ndarray.native.js b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/lib/ndarray.native.js index 1aa5aa273f3e..6c520136ebd3 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/lib/ndarray.native.js +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/lib/ndarray.native.js @@ -45,6 +45,7 @@ var addon = require( './dsumkbn2.native.js' ); * // returns 5.0 */ function dsumkbn2( N, x, stride, offset ) { + var view; offset = minViewBufferIndex( N, stride, offset ); view = offsetView( x, offset ); return addon( N, view, stride ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json index 0768f5afcbd2..cc56386a9d11 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/manifest.json @@ -1,45 +1,45 @@ { -"options": {}, - "fields": [ - { - "field": "src", - "resolve": true, - "relative": true - }, - { - "field": "include", - "resolve": true, - "relative": true - }, - { - "field": "libraries", - "resolve": false, - "relative": false - }, - { - "field": "libpath", - "resolve": true, - "relative": false - } - ], - "confs": [ - { - "src": [ - "./src/dsumkbn2.c" - ], - "include": [ - "./include" - ], - "libraries": [ - "-lm" - ], - "libpath": [], - "dependencies": [ - "@stdlib/napi/export", - "@stdlib/napi/argv", - "@stdlib/napi/argv-int64", - "@stdlib/napi/argv-strided-float64array" - ] - } - ] - } \ No newline at end of file + "options": {}, + "fields": [ + { + "field": "src", + "resolve": true, + "relative": true + }, + { + "field": "include", + "resolve": true, + "relative": true + }, + { + "field": "libraries", + "resolve": false, + "relative": false + }, + { + "field": "libpath", + "resolve": true, + "relative": false + } + ], + "confs": [ + { + "src": [ + "./src/dsumkbn2.c" + ], + "include": [ + "./include" + ], + "libraries": [ + "-lm" + ], + "libpath": [], + "dependencies": [ + "@stdlib/napi/export", + "@stdlib/napi/argv", + "@stdlib/napi/argv-int64", + "@stdlib/napi/argv-strided-float64array" + ] + } + ] +} From 934771f7589d39ccf3cb4678cb6f39bdd6f076ac Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 18:27:35 +0000 Subject: [PATCH 05/11] refactoring addon.c --- lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c index e0272f5dea06..2859d43d4aa9 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c @@ -16,7 +16,7 @@ * limitations under the License. */ -#include "stdlib/blas/ext/base/ssumpw.h" +#include "stdlib/blas/ext/base/dsumkbn2.h" #include "stdlib/napi/export.h" #include "stdlib/napi/argv.h" #include "stdlib/napi/argv_int64.h" From 50418bf1fd2f6656f5cde89afd39487a7964b054 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 18:31:40 +0000 Subject: [PATCH 06/11] refactor addon.c --- lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c index 2859d43d4aa9..522f78a64ac1 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c @@ -20,7 +20,7 @@ #include "stdlib/napi/export.h" #include "stdlib/napi/argv.h" #include "stdlib/napi/argv_int64.h" -#include "stdlib/napi/argv_strided_float32array.h" +#include "stdlib/napi/argv_strided_float64array.h" #include #include From a1f96b44a852d0c968ce649948bb322978c02ca3 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 18:35:33 +0000 Subject: [PATCH 07/11] refactor addon.c --- .../blas/ext/base/dsumkbn2/src/addon.c | 111 ++++++++++++++---- 1 file changed, 90 insertions(+), 21 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c index 522f78a64ac1..04b89e69fab0 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c @@ -17,32 +17,101 @@ */ #include "stdlib/blas/ext/base/dsumkbn2.h" -#include "stdlib/napi/export.h" -#include "stdlib/napi/argv.h" -#include "stdlib/napi/argv_int64.h" -#include "stdlib/napi/argv_strided_float64array.h" #include +#include +#include +#include #include /** -* Receives JavaScript callback invocation data. -* -* @private -* @param env environment under which the function is invoked -* @param info callback data -* @return Node-API value +* Add-on namespace. */ -static napi_value addon( napi_env env, napi_callback_info info ) { - STDLIB_NAPI_ARGV( env, info, argv, argc, 3 ); - STDLIB_NAPI_ARGV_INT64( env, N, argv, 0 ); - STDLIB_NAPI_ARGV_INT64( env, stride, argv, 2 ); - STDLIB_NAPI_ARGV_STRIDED_FLOAT32ARRAY( env, X, N, stride, argv, 1 ); +namespace stdlib_blas_ext_base_dsumkbn2 { + + /** + * Computes the sum of double-precision floating-point strided array elements using a second-order iterative Kahan–Babuška algorithm. + * + * ## Notes + * + * - When called from JavaScript, the function expects three arguments: + * + * - `N`: number of indexed elements + * - `X`: input array + * - `stride`: stride length + */ + napi_value node_dsumkbn2( napi_env env, napi_callback_info info ) { + napi_status status; + + size_t argc = 3; + napi_value argv[ 3 ]; + status = napi_get_cb_info( env, info, &argc, argv, nullptr, nullptr ); + assert( status == napi_ok ); + + if ( argc < 3 ) { + napi_throw_error( env, nullptr, "invalid invocation. Must provide 3 arguments." ); + return nullptr; + } + + napi_valuetype vtype0; + status = napi_typeof( env, argv[ 0 ], &vtype0 ); + assert( status == napi_ok ); + if ( vtype0 != napi_number ) { + napi_throw_type_error( env, nullptr, "invalid argument. First argument must be a number." ); + return nullptr; + } + + bool res; + status = napi_is_typedarray( env, argv[ 1 ], &res ); + assert( status == napi_ok ); + if ( res == false ) { + napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); + return nullptr; + } + + napi_valuetype vtype2; + status = napi_typeof( env, argv[ 2 ], &vtype2 ); + assert( status == napi_ok ); + if ( vtype2 != napi_number ) { + napi_throw_type_error( env, nullptr, "invalid argument. Third argument must be a number." ); + return nullptr; + } + + int64_t N; + status = napi_get_value_int64( env, argv[ 0 ], &N ); + assert( status == napi_ok ); + + int64_t stride; + status = napi_get_value_int64( env, argv[ 2 ], &stride ); + assert( status == napi_ok ); + + napi_typedarray_type vtype1; + size_t xlen; + void *X; + status = napi_get_typedarray_info( env, argv[ 1 ], &vtype1, &xlen, &X, nullptr, nullptr ); + assert( status == napi_ok ); + if ( vtype1 != napi_float64_array ) { + napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); + return nullptr; + } + if ( (N-1)*llabs(stride) >= (int64_t)xlen ) { + napi_throw_range_error( env, nullptr, "invalid argument. Second argument has insufficient elements based on the associated stride and the number of indexed elements." ); + return nullptr; + } + + napi_value v; + status = napi_create_double( env, stdlib_strided_dsumkbn2( N, (double *)X, stride ), &v ); + assert( status == napi_ok ); - napi_value v; - napi_status status = napi_create_double( env, (double)stdlib_strided_ssumpw( N, (float *)X, stride ), &v ); - assert( status == napi_ok ); + return v; + } - return v; -} + napi_value Init( napi_env env, napi_value exports ) { + napi_status status; + napi_value fcn; + status = napi_create_function( env, "exports", NAPI_AUTO_LENGTH, node_dsumkbn2, NULL, &fcn ); + assert( status == napi_ok ); + return fcn; + } -STDLIB_NAPI_MODULE_EXPORT_FCN( addon ) \ No newline at end of file + NAPI_MODULE( NODE_GYP_MODULE_NAME, Init ) +} // end namespace stdlib_blas_ext_base_dsumkbn2 \ No newline at end of file From 5b02260e059bb752f73403b9d675c22d33e34ed5 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Fri, 22 Mar 2024 18:40:09 +0000 Subject: [PATCH 08/11] refactor addon --- .../blas/ext/base/dsumkbn2/src/addon.c | 110 ++++-------------- 1 file changed, 20 insertions(+), 90 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c index 04b89e69fab0..ed7cff60040f 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/src/addon.c @@ -17,101 +17,31 @@ */ #include "stdlib/blas/ext/base/dsumkbn2.h" +#include "stdlib/napi/export.h" +#include "stdlib/napi/argv.h" +#include "stdlib/napi/argv_int64.h" +#include "stdlib/napi/argv_strided_float64array.h" #include -#include -#include -#include #include /** -* Add-on namespace. +* Receives JavaScript callback invocation data. +* +* @private +* @param env environment under which the function is invoked +* @param info callback data +* @return Node-API value */ -namespace stdlib_blas_ext_base_dsumkbn2 { - - /** - * Computes the sum of double-precision floating-point strided array elements using a second-order iterative Kahan–Babuška algorithm. - * - * ## Notes - * - * - When called from JavaScript, the function expects three arguments: - * - * - `N`: number of indexed elements - * - `X`: input array - * - `stride`: stride length - */ - napi_value node_dsumkbn2( napi_env env, napi_callback_info info ) { - napi_status status; - - size_t argc = 3; - napi_value argv[ 3 ]; - status = napi_get_cb_info( env, info, &argc, argv, nullptr, nullptr ); - assert( status == napi_ok ); - - if ( argc < 3 ) { - napi_throw_error( env, nullptr, "invalid invocation. Must provide 3 arguments." ); - return nullptr; - } - - napi_valuetype vtype0; - status = napi_typeof( env, argv[ 0 ], &vtype0 ); - assert( status == napi_ok ); - if ( vtype0 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. First argument must be a number." ); - return nullptr; - } - - bool res; - status = napi_is_typedarray( env, argv[ 1 ], &res ); - assert( status == napi_ok ); - if ( res == false ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); - return nullptr; - } - - napi_valuetype vtype2; - status = napi_typeof( env, argv[ 2 ], &vtype2 ); - assert( status == napi_ok ); - if ( vtype2 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. Third argument must be a number." ); - return nullptr; - } - - int64_t N; - status = napi_get_value_int64( env, argv[ 0 ], &N ); - assert( status == napi_ok ); - - int64_t stride; - status = napi_get_value_int64( env, argv[ 2 ], &stride ); - assert( status == napi_ok ); - - napi_typedarray_type vtype1; - size_t xlen; - void *X; - status = napi_get_typedarray_info( env, argv[ 1 ], &vtype1, &xlen, &X, nullptr, nullptr ); - assert( status == napi_ok ); - if ( vtype1 != napi_float64_array ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float64Array." ); - return nullptr; - } - if ( (N-1)*llabs(stride) >= (int64_t)xlen ) { - napi_throw_range_error( env, nullptr, "invalid argument. Second argument has insufficient elements based on the associated stride and the number of indexed elements." ); - return nullptr; - } - - napi_value v; - status = napi_create_double( env, stdlib_strided_dsumkbn2( N, (double *)X, stride ), &v ); - assert( status == napi_ok ); +static napi_value addon( napi_env env, napi_callback_info info ) { + STDLIB_NAPI_ARGV( env, info, argv, argc, 3 ); + STDLIB_NAPI_ARGV_INT64( env, N, argv, 0 ); + STDLIB_NAPI_ARGV_INT64( env, strideX, argv, 2 ); + STDLIB_NAPI_ARGV_STRIDED_FLOAT64ARRAY( env, X, N, strideX, argv, 1 ); - return v; - } + napi_value v; + napi_create_double( env, stdlib_strided_dsumkbn2( N, X, strideX ), &v ); - napi_value Init( napi_env env, napi_value exports ) { - napi_status status; - napi_value fcn; - status = napi_create_function( env, "exports", NAPI_AUTO_LENGTH, node_dsumkbn2, NULL, &fcn ); - assert( status == napi_ok ); - return fcn; - } + return v; +} - NAPI_MODULE( NODE_GYP_MODULE_NAME, Init ) -} // end namespace stdlib_blas_ext_base_dsumkbn2 \ No newline at end of file +STDLIB_NAPI_MODULE_EXPORT_FCN( addon ); \ No newline at end of file From f45fac6eea0ca63cb9c5a62cc74a0ba6a611a6b6 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Sat, 23 Mar 2024 01:11:31 +0530 Subject: [PATCH 09/11] Update repl.txt Signed-off-by: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> --- .../blas/ext/base/dsumkbn2/docs/repl.txt | 37 ++++++++++--------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt index 1cf068f99f58..a74de0eb18d2 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt @@ -1,10 +1,10 @@ {{alias}}( N, x, stride ) - Computes the sum of double-precision floating-point strided array elements - using a second-order iterative Kahan–Babuška algorithm. + Computes the sum of absolute values (L1 norm) of double-precision floating- + point strided array elements using pairwise summation. - The `N` and `stride` parameters determine which elements in the strided - array are accessed at runtime. + The `N` and `stride` parameters determine which elements in `x` are accessed + at runtime. Indexing is relative to the first index. To introduce an offset, use a typed array view. @@ -32,23 +32,26 @@ // Standard Usage: > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 2.0 ] ); > {{alias}}( x.length, x, 1 ) - 1.0 + 5.0 // Using `N` and `stride` parameters: > x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 1.0, -5.0, 2.0, -1.0 ] ); - > {{alias}}( 3, x, stride ) - 1.0 + > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); + > var stride = 2; + > {{alias}}( N, x, stride ) + 5.0 // Using view offsets: > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); > var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); - > {{alias}}( 3, x1, stride ) - -1.0 - + > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 ); + > stride = 2; + > {{alias}}( N, x1, stride ) + 5.0 {{alias}}.ndarray( N, x, stride, offset ) - Computes the sum of double-precision floating-point strided array elements - using a second-order iterative Kahan–Babuška algorithm and alternative + Computes the sum of absolute values (L1 norm) of double-precision floating- + point strided array elements using pairwise summation and alternative indexing semantics. While typed array views mandate a view offset based on the underlying @@ -79,13 +82,13 @@ // Standard Usage: > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 2.0 ] ); > {{alias}}.ndarray( x.length, x, 1, 0 ) - 1.0 + 5.0 // Using offset parameter: - > x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); - > {{alias}}.ndarray( 3, x, 2, 1 ) - -1.0 + > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); + > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); + > {{alias}}.ndarray( N, x, 2, 1 ) + 5.0 See Also -------- - From 8e2fecf0761dd204d38f4d62a65a4496fc1f89a9 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Sat, 23 Mar 2024 01:12:38 +0530 Subject: [PATCH 10/11] Update repl.txt Signed-off-by: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> --- .../blas/ext/base/dsumkbn2/docs/repl.txt | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt index a74de0eb18d2..3c323bf30e1b 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/dsumkbn2/docs/repl.txt @@ -1,7 +1,7 @@ {{alias}}( N, x, stride ) - Computes the sum of absolute values (L1 norm) of double-precision floating- - point strided array elements using pairwise summation. + Computes the sum of double-precision floating-point strided array elements + using a second-order iterative Kahan–Babuška algorithm. The `N` and `stride` parameters determine which elements in `x` are accessed at runtime. @@ -32,14 +32,14 @@ // Standard Usage: > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 2.0 ] ); > {{alias}}( x.length, x, 1 ) - 5.0 + 1.0 // Using `N` and `stride` parameters: > x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 1.0, -5.0, 2.0, -1.0 ] ); > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); > var stride = 2; > {{alias}}( N, x, stride ) - 5.0 + 1.0 // Using view offsets: > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); @@ -47,11 +47,11 @@ > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 ); > stride = 2; > {{alias}}( N, x1, stride ) - 5.0 + -1.0 {{alias}}.ndarray( N, x, stride, offset ) - Computes the sum of absolute values (L1 norm) of double-precision floating- - point strided array elements using pairwise summation and alternative + Computes the sum of double-precision floating-point strided array elements + using a second-order iterative Kahan–Babuška algorithm and alternative indexing semantics. While typed array views mandate a view offset based on the underlying @@ -82,13 +82,13 @@ // Standard Usage: > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 2.0 ] ); > {{alias}}.ndarray( x.length, x, 1, 0 ) - 5.0 + 1.0 // Using offset parameter: > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); > {{alias}}.ndarray( N, x, 2, 1 ) - 5.0 + -1.0 See Also -------- From d14dad240321b89728474bd9a85403fc1a1d8078 Mon Sep 17 00:00:00 2001 From: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com> Date: Sat, 23 Mar 2024 01:19:58 +0530 Subject: [PATCH 11/11] Update repl.txt Signed-off-by: utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com>