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;
+ 
+ +
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ 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
+
+
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ 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" }
+ 
+ +
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ 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;
+ 
+ +
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ 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;
+ 
+ +
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ 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;
+ 
+ +
+
+
+ Code coverage generated by + istanbul + at 2024-09-29T07:28:31.931Z +
+ + + + + + + \ No newline at end of file