From 295f7b327d680bd578dd1a792f5049ec0edf39bc Mon Sep 17 00:00:00 2001 From: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com> Date: Sun, 29 Sep 2024 07:28:42 +0000 Subject: [PATCH] Update artifacts --- blas/base/saxpy-wasm/binary.js.html | 187 ++++++ blas/base/saxpy-wasm/coverage.ndjson | 1 + blas/base/saxpy-wasm/index.html | 176 ++++++ blas/base/saxpy-wasm/index.js.html | 421 ++++++++++++++ blas/base/saxpy-wasm/main.js.html | 271 +++++++++ blas/base/saxpy-wasm/module.js.html | 823 +++++++++++++++++++++++++++ blas/base/saxpy-wasm/routine.js.html | 646 +++++++++++++++++++++ 7 files changed, 2525 insertions(+) create mode 100644 blas/base/saxpy-wasm/binary.js.html create mode 100644 blas/base/saxpy-wasm/coverage.ndjson create mode 100644 blas/base/saxpy-wasm/index.html create mode 100644 blas/base/saxpy-wasm/index.js.html create mode 100644 blas/base/saxpy-wasm/main.js.html create mode 100644 blas/base/saxpy-wasm/module.js.html create mode 100644 blas/base/saxpy-wasm/routine.js.html diff --git a/blas/base/saxpy-wasm/binary.js.html b/blas/base/saxpy-wasm/binary.js.html new file mode 100644 index 000000000..4265c66c6 --- /dev/null +++ b/blas/base/saxpy-wasm/binary.js.html @@ -0,0 +1,187 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib/binary.js + + + + + + + + + +
+
+

All files / blas/base/saxpy-wasm/lib binary.js

+
+ +
+ 100% + Statements + 34/34 +
+ + +
+ 100% + Branches + 1/1 +
+ + +
+ 100% + Functions + 0/0 +
+ + +
+ 100% + Lines + 34/34 +
+ + +
+

+ 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 +357x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x + 
/**
+* @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.
+*/
+ 
+'use strict';
+ 
+// MODULES //
+ 
+var resolve = require( 'path' ).resolve;
+var readWASM = require( '@stdlib/fs/read-wasm' ).sync;
+ 
+ 
+// MAIN //
+ 
+var wasm = readWASM( resolve( __dirname, '..', 'src', 'main.wasm' ) );
+ 
+ 
+// EXPORTS //
+ 
+module.exports = wasm;
+ 
+ +
+
+ + + + + + + + \ No newline at end of file diff --git a/blas/base/saxpy-wasm/coverage.ndjson b/blas/base/saxpy-wasm/coverage.ndjson new file mode 100644 index 000000000..205298b6c --- /dev/null +++ b/blas/base/saxpy-wasm/coverage.ndjson @@ -0,0 +1 @@ +[641,641,100,17,17,100,6,6,100,641,641,100,"929a2241acc3b3714fb01fcb4a9e295810df5bf5","2024-09-29 00:26:37 -0700"] diff --git a/blas/base/saxpy-wasm/index.html b/blas/base/saxpy-wasm/index.html new file mode 100644 index 000000000..06b4f5256 --- /dev/null +++ b/blas/base/saxpy-wasm/index.html @@ -0,0 +1,176 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib + + + + + + + + + +
+
+

All files blas/base/saxpy-wasm/lib

+
+ +
+ 100% + Statements + 641/641 +
+ + +
+ 100% + Branches + 17/17 +
+ + +
+ 100% + Functions + 6/6 +
+ + +
+ 100% + Lines + 641/641 +
+ + +
+

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

+ +
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FileStatementsBranchesFunctionsLines
binary.js +
+
100%34/34100%1/1100%0/0100%34/34
index.js +
+
100%112/112100%1/1100%0/0100%112/112
main.js +
+
100%62/62100%1/1100%0/0100%62/62
module.js +
+
100%246/246100%8/8100%3/3100%246/246
routine.js +
+
100%187/187100%6/6100%3/3100%187/187
+
+
+
+ + + + + + + + \ No newline at end of file diff --git a/blas/base/saxpy-wasm/index.js.html b/blas/base/saxpy-wasm/index.js.html new file mode 100644 index 000000000..afa4cf1ba --- /dev/null +++ b/blas/base/saxpy-wasm/index.js.html @@ -0,0 +1,421 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib/index.js + + + + + + + + + +
+
+

All files / blas/base/saxpy-wasm/lib index.js

+
+ +
+ 100% + Statements + 112/112 +
+ + +
+ 100% + Branches + 1/1 +
+ + +
+ 100% + Functions + 0/0 +
+ + +
+ 100% + Lines + 112/112 +
+ + +
+

+ 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 +109 +110 +111 +112 +1136x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x + 
/**
+* @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.
+*/
+ 
+'use strict';
+ 
+/**
+* WebAssembly routine to multiply a vector `x` by a constant `alpha` and add the result to `y`.
+*
+* @module @stdlib/blas/base/saxpy-wasm
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+* var saxpy = require( '@stdlib/blas/base/saxpy-wasm' );
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.main( x.length, 5.0, x, 1, y, 1 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+* var saxpy = require( '@stdlib/blas/base/saxpy-wasm' );
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.ndarray( x.length, 5.0, x, 1, 0, y, 1, 0 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*
+* @example
+* var Memory = require( '@stdlib/wasm/memory' );
+* var oneTo = require( '@stdlib/array/one-to' );
+* var ones = require( '@stdlib/array/ones' );
+* var zeros = require( '@stdlib/array/zeros' );
+* var bytesPerElement = require( '@stdlib/ndarray/base/bytes-per-element' );
+* var saxpy = require( '@stdlib/blas/base/saxpy-wasm' );
+*
+* // Create a new memory instance with an initial size of 10 pages (640KiB) and a maximum size of 100 pages (6.4MiB):
+* var mem = new Memory({
+*     'initial': 10,
+*     'maximum': 100
+* });
+*
+* // Create a BLAS routine:
+* var mod = new saxpy.Module( mem );
+* // returns <Module>
+*
+* // Initialize the routine:
+* mod.initializeSync();
+*
+* // Define a vector data type:
+* var dtype = 'float32';
+*
+* // Specify a vector length:
+* var N = 5;
+*
+* // Define pointers (i.e., byte offsets) for storing two vectors:
+* var xptr = 0;
+* var yptr = N * bytesPerElement( dtype );
+*
+* // Write vector values to module memory:
+* mod.write( xptr, oneTo( N, dtype ) );
+* mod.write( yptr, ones( N, dtype ) );
+*
+* // Perform computation:
+* mod.main( N, 5.0, xptr, 1, yptr, 1 );
+*
+* // Read out the results:
+* var view = zeros( N, dtype );
+* mod.read( yptr, view );
+*
+* console.log( view );
+* // => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+ 
+// MODULES //
+ 
+var setReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' );
+var main = require( './main.js' );
+var Module = require( './module.js' );
+ 
+ 
+// MAIN //
+ 
+setReadOnly( main, 'Module', Module );
+ 
+ 
+// EXPORTS //
+ 
+module.exports = main;
+ 
+// exports: { "Module": "main.Module" }
+ 
+ +
+
+ + + + + + + + \ No newline at end of file diff --git a/blas/base/saxpy-wasm/main.js.html b/blas/base/saxpy-wasm/main.js.html new file mode 100644 index 000000000..c65b2a885 --- /dev/null +++ b/blas/base/saxpy-wasm/main.js.html @@ -0,0 +1,271 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib/main.js + + + + + + + + + +
+
+

All files / blas/base/saxpy-wasm/lib main.js

+
+ +
+ 100% + Statements + 62/62 +
+ + +
+ 100% + Branches + 1/1 +
+ + +
+ 100% + Functions + 0/0 +
+ + +
+ 100% + Lines + 62/62 +
+ + +
+

+ 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 +636x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x +6x + 
/**
+* @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.
+*/
+ 
+'use strict';
+ 
+// MODULES //
+ 
+var Routine = require( './routine.js' );
+ 
+ 
+// MAIN //
+ 
+/**
+* WebAssembly module to multiply a vector `x` by a constant and add the result to `y`.
+*
+* @name saxpy
+* @type {Routine}
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.main( x.length, 5.0, x, 1, y, 1 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.ndarray( x.length, 5.0, x, 1, 0, y, 1, 0 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+var saxpy = new Routine();
+saxpy.initializeSync(); // eslint-disable-line node/no-sync
+ 
+ 
+// EXPORTS //
+ 
+module.exports = saxpy;
+ 
+ +
+
+ + + + + + + + \ No newline at end of file diff --git a/blas/base/saxpy-wasm/module.js.html b/blas/base/saxpy-wasm/module.js.html new file mode 100644 index 000000000..ad5b1e36d --- /dev/null +++ b/blas/base/saxpy-wasm/module.js.html @@ -0,0 +1,823 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib/module.js + + + + + + + + + +
+
+

All files / blas/base/saxpy-wasm/lib module.js

+
+ +
+ 100% + Statements + 246/246 +
+ + +
+ 100% + Branches + 8/8 +
+ + +
+ 100% + Functions + 3/3 +
+ + +
+ 100% + Lines + 246/246 +
+ + +
+

+ 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 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 +188 +189 +190 +191 +192 +193 +194 +195 +196 +197 +198 +199 +200 +201 +202 +203 +204 +205 +206 +207 +208 +209 +210 +211 +212 +213 +214 +215 +216 +217 +218 +219 +220 +221 +222 +223 +224 +225 +226 +227 +228 +229 +230 +231 +232 +233 +234 +235 +236 +237 +238 +239 +240 +241 +242 +243 +244 +245 +246 +2477x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +68x +68x +11x +11x +68x +20x +20x +37x +37x +37x +37x +37x +37x +37x +37x +68x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +10x +10x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +35x +35x +7x +7x +7x +7x +7x +7x + 
/**
+* @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.
+*/
+ 
+/* eslint-disable no-restricted-syntax, no-invalid-this */
+ 
+'use strict';
+ 
+// MODULES //
+ 
+var isWebAssemblyMemory = require( '@stdlib/assert/is-wasm-memory' );
+var setReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' );
+var inherits = require( '@stdlib/utils/inherit' );
+var WasmModule = require( '@stdlib/wasm/module-wrapper' );
+var format = require( '@stdlib/string/format' );
+var wasmBinary = require( './binary.js' );
+ 
+ 
+// MAIN //
+ 
+/**
+* BLAS routine WebAssembly module wrapper constructor.
+*
+* @constructor
+* @param {Object} memory - WebAssembly memory instance
+* @throws {TypeError} must provide a WebAssembly memory instance
+* @returns {Module} module instance
+*
+* @example
+* var Memory = require( '@stdlib/wasm/memory' );
+* var oneTo = require( '@stdlib/array/one-to' );
+* var ones = require( '@stdlib/array/ones' );
+* var zeros = require( '@stdlib/array/zeros' );
+* var bytesPerElement = require( '@stdlib/ndarray/base/bytes-per-element' );
+*
+* // Create a new memory instance with an initial size of 10 pages (640KiB) and a maximum size of 100 pages (6.4MiB):
+* var mem = new Memory({
+*     'initial': 10,
+*     'maximum': 100
+* });
+*
+* // Create a BLAS routine:
+* var saxpy = new Module( mem );
+* // returns <Module>
+*
+* // Initialize the routine:
+* saxpy.initializeSync();
+*
+* // Define a vector data type:
+* var dtype = 'float32';
+*
+* // Specify a vector length:
+* var N = 5;
+*
+* // Define pointers (i.e., byte offsets) for storing two vectors:
+* var xptr = 0;
+* var yptr = N * bytesPerElement( dtype );
+*
+* // Write vector values to module memory:
+* saxpy.write( xptr, oneTo( N, dtype ) );
+* saxpy.write( yptr, ones( N, dtype ) );
+*
+* // Perform computation:
+* var ptr = saxpy.main( N, 5.0, xptr, 1, yptr, 1 );
+* // returns <number>
+*
+* var bool = ( ptr === yptr );
+* // returns true
+*
+* // Read out the results:
+* var view = zeros( N, dtype );
+* saxpy.read( yptr, view );
+* // view => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+function Module( memory ) {
+	if ( !( this instanceof Module ) ) {
+		return new Module( memory );
+	}
+	if ( !isWebAssemblyMemory( memory ) ) {
+		throw new TypeError( format( 'invalid argument. Must provide a WebAssembly memory instance. Value: `%s`.', memory ) );
+	}
+	// Call the parent constructor:
+	WasmModule.call( this, wasmBinary, memory, {
+		'env': {
+			'memory': memory
+		}
+	});
+ 
+	return this;
+}
+ 
+// Inherit from the parent constructor:
+inherits( Module, WasmModule );
+ 
+/**
+* Multiplies a vector `x` by a constant and adds the result to `y`.
+*
+* @name main
+* @memberof Module.prototype
+* @readonly
+* @type {Function}
+* @param {PositiveInteger} N - number of indexed elements
+* @param {number} alpha - scalar
+* @param {NonNegativeInteger} xptr - input array pointer (i.e., byte offset)
+* @param {integer} strideX - `x` stride length
+* @param {NonNegativeInteger} yptr - output array pointer (i.e., byte offset)
+* @param {integer} strideY - `y` stride length
+* @returns {NonNegativeInteger} output array pointer (i.e., byte offset)
+*
+* @example
+* var Memory = require( '@stdlib/wasm/memory' );
+* var oneTo = require( '@stdlib/array/one-to' );
+* var ones = require( '@stdlib/array/ones' );
+* var zeros = require( '@stdlib/array/zeros' );
+* var bytesPerElement = require( '@stdlib/ndarray/base/bytes-per-element' );
+*
+* // Create a new memory instance with an initial size of 10 pages (640KiB) and a maximum size of 100 pages (6.4MiB):
+* var mem = new Memory({
+*     'initial': 10,
+*     'maximum': 100
+* });
+*
+* // Create a BLAS routine:
+* var saxpy = new Module( mem );
+* // returns <Module>
+*
+* // Initialize the routine:
+* saxpy.initializeSync();
+*
+* // Define a vector data type:
+* var dtype = 'float32';
+*
+* // Specify a vector length:
+* var N = 5;
+*
+* // Define pointers (i.e., byte offsets) for storing two vectors:
+* var xptr = 0;
+* var yptr = N * bytesPerElement( dtype );
+*
+* // Write vector values to module memory:
+* saxpy.write( xptr, oneTo( N, dtype ) );
+* saxpy.write( yptr, ones( N, dtype ) );
+*
+* // Perform computation:
+* var ptr = saxpy.main( N, 5.0, xptr, 1, yptr, 1 );
+* // returns <number>
+*
+* var bool = ( ptr === yptr );
+* // returns true
+*
+* // Read out the results:
+* var view = zeros( N, dtype );
+* saxpy.read( yptr, view );
+* // view => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+setReadOnly( Module.prototype, 'main', function saxpy( N, alpha, xptr, strideX, yptr, strideY ) { // eslint-disable-line stdlib/jsdoc-doctest-decimal-point
+	this._instance.exports.c_saxpy( N, alpha, xptr, strideX, yptr, strideY );
+	return yptr;
+});
+ 
+/**
+* Multiplies a vector `x` by a constant and adds the result to `y` using alternative indexing semantics.
+*
+* @name ndarray
+* @memberof Module.prototype
+* @readonly
+* @type {Function}
+* @param {PositiveInteger} N - number of indexed elements
+* @param {number} alpha - scalar
+* @param {NonNegativeInteger} xptr - input array pointer (i.e., byte offset)
+* @param {integer} strideX - `x` stride length
+* @param {NonNegativeInteger} offsetX - starting `x` index
+* @param {NonNegativeInteger} yptr - output array pointer (i.e., byte offset)
+* @param {integer} strideY - `y` stride length
+* @param {NonNegativeInteger} offsetY - starting `y` index
+* @returns {NonNegativeInteger} output array pointer (i.e., byte offset)
+*
+* @example
+* var Memory = require( '@stdlib/wasm/memory' );
+* var oneTo = require( '@stdlib/array/one-to' );
+* var ones = require( '@stdlib/array/ones' );
+* var zeros = require( '@stdlib/array/zeros' );
+* var bytesPerElement = require( '@stdlib/ndarray/base/bytes-per-element' );
+*
+* // Create a new memory instance with an initial size of 10 pages (640KiB) and a maximum size of 100 pages (6.4MiB):
+* var mem = new Memory({
+*     'initial': 10,
+*     'maximum': 100
+* });
+*
+* // Create a BLAS routine:
+* var saxpy = new Module( mem );
+* // returns <Module>
+*
+* // Initialize the routine:
+* saxpy.initializeSync();
+*
+* // Define a vector data type:
+* var dtype = 'float32';
+*
+* // Specify a vector length:
+* var N = 5;
+*
+* // Define pointers (i.e., byte offsets) for storing two vectors:
+* var xptr = 0;
+* var yptr = N * bytesPerElement( dtype );
+*
+* // Write vector values to module memory:
+* saxpy.write( xptr, oneTo( N, dtype ) );
+* saxpy.write( yptr, ones( N, dtype ) );
+*
+* // Perform computation:
+* var ptr = saxpy.ndarray( N, 5.0, xptr, 1, 0, yptr, 1, 0 );
+* // returns <number>
+*
+* var bool = ( ptr === yptr );
+* // returns true
+*
+* // Read out the results:
+* var view = zeros( N, dtype );
+* saxpy.read( yptr, view );
+* // view => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+setReadOnly( Module.prototype, 'ndarray', function saxpy( N, alpha, xptr, strideX, offsetX, yptr, strideY, offsetY ) { // eslint-disable-line stdlib/jsdoc-doctest-decimal-point
+	this._instance.exports.c_saxpy_ndarray( N, alpha, xptr, strideX, offsetX, yptr, strideY, offsetY ); // eslint-disable-line max-len
+	return yptr;
+});
+ 
+ 
+// EXPORTS //
+ 
+module.exports = Module;
+ 
+ +
+
+ + + + + + + + \ No newline at end of file diff --git a/blas/base/saxpy-wasm/routine.js.html b/blas/base/saxpy-wasm/routine.js.html new file mode 100644 index 000000000..3c907f0d2 --- /dev/null +++ b/blas/base/saxpy-wasm/routine.js.html @@ -0,0 +1,646 @@ + + + + + + Code coverage report for blas/base/saxpy-wasm/lib/routine.js + + + + + + + + + +
+
+

All files / blas/base/saxpy-wasm/lib routine.js

+
+ +
+ 100% + Statements + 187/187 +
+ + +
+ 100% + Branches + 6/6 +
+ + +
+ 100% + Functions + 3/3 +
+ + +
+ 100% + Lines + 187/187 +
+ + +
+

+ 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 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 +1887x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +13x +13x +1x +1x +12x +12x +12x +12x +13x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +11x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +7x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +23x +7x +7x +7x +7x +7x +7x + 
/**
+* @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.
+*/
+ 
+/* eslint-disable no-restricted-syntax, no-invalid-this */
+ 
+'use strict';
+ 
+// MODULES //
+ 
+var setReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' );
+var inherits = require( '@stdlib/utils/inherit' );
+var stride2offset = require( '@stdlib/strided/base/stride2offset' );
+var readDataView = require( '@stdlib/strided/base/read-dataview' ).ndarray;
+var Memory = require( '@stdlib/wasm/memory' );
+var arrays2ptrs = require( '@stdlib/wasm/base/arrays2ptrs' );
+var strided2object = require( '@stdlib/wasm/base/strided2object' );
+var Module = require( './module.js' );
+ 
+ 
+// MAIN //
+ 
+/**
+* Routine constructor.
+*
+* @private
+* @constructor
+* @returns {Routine} routine instance
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Create a new routine:
+* var saxpy = new Routine();
+*
+* // Initialize the module:
+* saxpy.initializeSync();
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.main( x.length, 5.0, x, 1, y, 1 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Create a new routine:
+* var saxpy = new Routine();
+*
+* // Initialize the module:
+* saxpy.initializeSync();
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.ndarray( x.length, 5.0, x, 1, 0, y, 1, 0 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+function Routine() {
+	if ( !( this instanceof Routine ) ) {
+		return new Routine();
+	}
+	Module.call( this, new Memory({
+		'initial': 0
+	}));
+	return this;
+}
+ 
+// Inherit from the parent constructor:
+inherits( Routine, Module );
+ 
+/**
+* Multiplies a vector `x` by a constant and adds the result to `y`.
+*
+* @name main
+* @memberof Routine.prototype
+* @readonly
+* @type {Function}
+* @param {PositiveInteger} N - number of indexed elements
+* @param {number} alpha - scalar
+* @param {Float32Array} x - input array
+* @param {integer} strideX - `x` stride length
+* @param {Float32Array} y - output array
+* @param {integer} strideY - `y` stride length
+* @returns {Float32Array} output array
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Create a new routine:
+* var saxpy = new Routine();
+*
+* // Initialize the module:
+* saxpy.initializeSync();
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.main( x.length, 5.0, x, 1, y, 1 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+setReadOnly( Routine.prototype, 'main', function saxpy( N, alpha, x, strideX, y, strideY ) {
+	return this.ndarray( N, alpha, x, strideX, stride2offset( N, strideX ), y, strideY, stride2offset( N, strideY ) ); // eslint-disable-line max-len
+});
+ 
+/**
+* Multiplies a vector `x` by a constant and adds the result to `y` using alternative indexing semantics.
+*
+* @name ndarray
+* @memberof Routine.prototype
+* @readonly
+* @type {Function}
+* @param {PositiveInteger} N - number of indexed elements
+* @param {number} alpha - scalar
+* @param {Float32Array} x - input array
+* @param {integer} strideX - `x` stride length
+* @param {NonNegativeInteger} offsetX - starting `x` index
+* @param {Float32Array} y - output array
+* @param {integer} strideY - `y` stride length
+* @param {NonNegativeInteger} offsetY - starting `y` index
+* @returns {Float32Array} output array
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* // Create a new routine:
+* var saxpy = new Routine();
+*
+* // Initialize the module:
+* saxpy.initializeSync();
+*
+* // Define strided arrays:
+* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* var y = new Float32Array( [ 1.0, 1.0, 1.0, 1.0, 1.0 ] );
+*
+* // Perform operation:
+* saxpy.ndarray( x.length, 5.0, x, 1, 0, y, 1, 0 );
+* // y => <Float32Array>[ 6.0, 11.0, 16.0, 21.0, 26.0 ]
+*/
+setReadOnly( Routine.prototype, 'ndarray', function saxpy( N, alpha, x, strideX, offsetX, y, strideY, offsetY ) {
+	var ptrs;
+	var p0;
+	var p1;
+ 
+	// Convert the input arrays to "pointers" in the module's memory:
+	ptrs = arrays2ptrs( this, [
+		strided2object( N, x, strideX, offsetX ),
+		strided2object( N, y, strideY, offsetY )
+	]);
+	p0 = ptrs[ 0 ];
+	p1 = ptrs[ 1 ];
+ 
+	// Perform computation by calling the corresponding parent method:
+	Module.prototype.ndarray.call( this, N, alpha, p0.ptr, p0.stride, p0.offset, p1.ptr, p1.stride, p1.offset ); // eslint-disable-line max-len
+ 
+	// If the output array data had to be copied to module memory, copy the results to the provided output array...
+	if ( p1.copy ) {
+		readDataView( N, this.view, p1.stride*p1.BYTES_PER_ELEMENT, p1.ptr, y, strideY, offsetY, true ); // eslint-disable-line max-len
+	}
+	return y;
+});
+ 
+ 
+// EXPORTS //
+ 
+module.exports = Routine;
+ 
+ +
+
+ + + + + + + + \ No newline at end of file