@stdlib/blas-base-wasm-dznrm2 0.1.0

package/docs/types/index.d.ts

@@ -0,0 +1,322 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+// TypeScript Version: 4.1
+
+/// <reference types="@stdlib/types"/>
+
+import { ModuleWrapper, Memory } from '@stdlib/types/wasm';
+import { Complex128Array } from '@stdlib/types/array';
+
+/**
+* Interface defining a module constructor which is both "newable" and "callable".
+*/
+interface ModuleConstructor {
+	/**
+	* Returns a new WebAssembly module wrapper instance which uses the provided WebAssembly memory instance as its underlying memory.
+	*
+	* @param mem - WebAssembly memory instance
+	* @returns module wrapper instance
+	*
+	* @example
+	* var Memory = require( '@stdlib/wasm-memory' );
+	* var oneTo = require( '@stdlib/array-one-to' );
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // 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 dznrm2.Module( mem );
+	* // returns <Module>
+	*
+	* // Initialize the routine:
+	* mod.initializeSync();
+	*
+	* // Specify a vector length:
+	* var N = 5;
+	*
+	* // Define pointer (i.e., byte offsets) for storing two vectors:
+	* var xptr = 0;
+	*
+	* // Write vector values to module memory:
+	* var xbuf = oneTo( N*2, 'float64' );
+	* var x = new Complex128Array( xbuf.buffer );
+	* mod.write( xptr, x );
+	*
+	* // Perform computation:
+	* var out = mod.main( N, xptr, 1 );
+	* // returns ~19.62
+	*/
+	new( mem: Memory ): Module; // newable
+
+	/**
+	* Returns a new WebAssembly module wrapper instance which uses the provided WebAssembly memory instance as its underlying memory.
+	*
+	* @param mem - WebAssembly memory instance
+	* @returns module wrapper instance
+	*
+	* @example
+	* var Memory = require( '@stdlib/wasm-memory' );
+	* var oneTo = require( '@stdlib/array-one-to' );
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // 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 = dznrm2.Module( mem );
+	* // returns <Module>
+	*
+	* // Initialize the routine:
+	* mod.initializeSync();
+	*
+	* // Specify a vector length:
+	* var N = 5;
+	*
+	* // Define pointer (i.e., byte offsets) for storing two vectors:
+	* var xptr = 0;
+	*
+	* // Write vector values to module memory:
+	* var xbuf = oneTo( N*2, 'float64' );
+	* var x = new Complex128Array( xbuf.buffer );
+	* mod.write( xptr, x );
+	*
+	* // Perform computation:
+	* var out = mod.main( N, xptr, 1 );
+	* // returns ~19.62
+	*/
+	( mem: Memory ): Module; // callable
+}
+
+/**
+* Interface describing a `dznrm2` WebAssembly module.
+*/
+interface Module extends ModuleWrapper {
+	/**
+	* Computes the L2-norm of a complex double-precision floating-point vector.
+	*
+	* @param N - number of indexed elements
+	* @param xptr - input array pointer (i.e., byte offset)
+	* @param strideX - `x` stride length
+	* @returns L2-norm
+	*
+	* @example
+	* var Memory = require( '@stdlib/wasm-memory' );
+	* var oneTo = require( '@stdlib/array-one-to' );
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // 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 dznrm2.Module( mem );
+	* // returns <Module>
+	*
+	* // Initialize the routine:
+	* mod.initializeSync();
+	*
+	* // Specify a vector length:
+	* var N = 5;
+	*
+	* // Define pointer (i.e., byte offsets) for storing the input vector:
+	* var xptr = 0;
+	*
+	* // Write vector values to module memory:
+	* var xbuf = oneTo( N*2, 'float64' );
+	* var x = new Complex128Array( xbuf.buffer );
+	* mod.write( xptr, x );
+	*
+	* // Perform computation:
+	* var out = mod.main( N, xptr, 1 );
+	* // returns ~19.62
+	*/
+	main( N: number, xptr: number, strideX: number ): number;
+
+	/**
+	* Computes the L2-norm of a complex double-precision floating-point vector using alternative indexing semantics.
+	*
+	* @param N - number of indexed elements
+	* @param xptr - input array pointer (i.e., byte offset)
+	* @param strideX - `x` stride length
+	* @param offsetX - starting index for `x`
+	* @returns L2-norm
+	*
+	* @example
+	* var Memory = require( '@stdlib/wasm-memory' );
+	* var oneTo = require( '@stdlib/array-one-to' );
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // 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 dznrm2.Module( mem );
+	* // returns <Module>
+	*
+	* // Initialize the routine:
+	* mod.initializeSync();
+	*
+	* // Specify a vector length:
+	* var N = 5;
+	*
+	* // Define pointer (i.e., byte offsets) for storing the input vector:
+	* var xptr = 0;
+	*
+	* // Write vector values to module memory:
+	* var xbuf = oneTo( N*2, 'float64' );
+	* var x = new Complex128Array( xbuf.buffer );
+	* mod.write( xptr, x );
+	*
+	* // Perform computation:
+	* var out = mod.ndarray( N, xptr, 1, 0 );
+	* // returns ~19.62
+	*/
+	ndarray( N: number, xptr: number, strideX: number, offsetX: number ): number;
+}
+
+/**
+* Interface describing `dznrm2`.
+*/
+interface Routine extends ModuleWrapper {
+	/**
+	* Computes the L2-norm of a complex double-precision floating-point vector.
+	*
+	* @param N - number of indexed elements
+	* @param x - input array
+	* @param strideX - `x` stride length
+	* @returns L2-norm
+	*
+	* @example
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // Define a strided array:
+	* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+	*
+	* // Perform operation:
+	* var out = dznrm2.main( x.length, x, 1 );
+	* // returns ~9.54
+	*/
+	main( N: number, x: Complex128Array, strideX: number ): number;
+
+	/**
+	* Computes the L2-norm of a complex double-precision floating-point vector using alternative indexing semantics.
+	*
+	* @param N - number of indexed elements
+	* @param x - input array
+	* @param strideX - `x` stride length
+	* @param offsetX - starting index for `x`
+	* @returns L2-norm
+	*
+	* @example
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // Define a strided array:
+	* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+	*
+	* var out = dznrm2.ndarray( x.length, x, 1, 0 );
+	* // returns ~9.54
+	*/
+	ndarray( N: number, x: Complex128Array, strideX: number, offsetX: number ): number;
+
+	/**
+	* Returns a new WebAssembly module wrapper instance which uses the provided WebAssembly memory instance as its underlying memory.
+	*
+	* @param mem - WebAssembly memory instance
+	* @returns module wrapper instance
+	*
+	* @example
+	* var Memory = require( '@stdlib/wasm-memory' );
+	* var oneTo = require( '@stdlib/array-one-to' );
+	* var Complex128Array = require( '@stdlib/array-complex128' );
+	*
+	* // 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 dznrm2.Module( mem );
+	* // returns <Module>
+	*
+	* // Initialize the routine:
+	* mod.initializeSync();
+	*
+	* // Specify a vector length:
+	* var N = 5;
+	*
+	* // Define pointer (i.e., byte offsets) for storing the input vector:
+	* var xptr = 0;
+	*
+	* // Write vector values to module memory:
+	* var xbuf = oneTo( N*2, 'float64' );
+	* var x = new Complex128Array( xbuf.buffer );
+	* mod.write( xptr, x );
+	*
+	* // Perform computation:
+	* var out = mod.main( N, xptr, 1 );
+	* // returns ~19.62
+	*/
+	Module: ModuleConstructor;
+}
+
+/**
+* Computes the L2-norm of a complex double-precision floating-point vector.
+*
+* @param N - number of indexed elements
+* @param x - input array
+* @param strideX - `x` stride length
+* @returns L2-norm
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* var out = dznrm2.main( x.length, x, 1 );
+* // returns ~9.54
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* var out = dznrm2.ndarray( x.length, x, 1, 0 );
+* // returns ~9.54
+*/
+declare var dznrm2: Routine;
+
+
+// EXPORTS //
+
+export = dznrm2;

package/lib/binary.browser.js

@@ -0,0 +1,33 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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 base64ToUint8Array = require( '@stdlib/string-base-base64-to-uint8array' );
+
+
+// MAIN //
+
+var wasm = base64ToUint8Array( 'AGFzbQEAAAAADwhkeWxpbmsuMAEEAAAAAAETA2AAAGADf39/AXxgBH9/f38BfAIPAQNlbnYGbWVtb3J5AgAAAwQDAAECBzMDEV9fd2FzbV9jYWxsX2N0b3JzAAAIY19kem5ybTIAARBjX2R6bnJtMl9uZGFycmF5AAIK0gQDAwABCxoAIAAgASACQQEgAGsgAmxBACACQQBMGxACC7AEAgV8BH8gAEEATARARAAAAAAAAAAADwsgA0EBdCEJIAJBAXQhC0EAIQNBASECA0AgACADRkUEQAJAIAEgCUEDdGoiDCsDACIGmSIIRAAAAAAAAFBeZARAIAcgCEQAAAAAAABQHqIiBiAGoqAhB0EAIQIMAQsgCEQAAAAAAAAAIGMEQCACQQFxIQpBACECIApFDQEgBCAIRAAAAAAAAIBhoiIEIASioCEEQQEhAgwBCyAFIAYgBqKgIQULAkAgDCsDCCIGmSIIRAAAAAAAAFBeZARAIAcgCEQAAAAAAABQHqIiBiAGoqAhB0EAIQIMAQsgCEQAAAAAAAAAIGMEQCACQQFxIQpBACECIApFDQEgBCAIRAAAAAAAAIBhoiIEIASioCEEQQEhAgwBCyAFIAYgBqKgIQULIANBAWohAyAJIAtqIQkMAQsLAnwgB0QAAAAAAAAAAGQEQCAFRAAAAAAAAFAeokQAAAAAAABQHqIgB6AiBCAHIAVE////////739kGyAEIAVEAAAAAAAAAABlGyEFRAAAAAAAAJBhDAELRAAAAAAAAPA/IAREAAAAAAAAAABkRQ0AGiAFRAAAAAAAAAAAZUUgBUT////////vf2RyRQRAIAQhBUQAAAAAAABgHgwBCyAEn0QAAAAAAABgHqIiBiAFnyIFIAUgBmMiABsiBCAEoiAFIAYgABsgBKMiBCAEokQAAAAAAADwP6CiIQVEAAAAAAAA8D8LIAWfogs=' );
+
+
+// EXPORTS //
+
+module.exports = wasm;

package/lib/binary.js

@@ -0,0 +1,34 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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;

package/lib/index.js

@@ -0,0 +1,92 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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 calculate the L2-norm of a complex double-precision floating-point vector.
+*
+* @module @stdlib/blas-base-wasm-dznrm2
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+* var dznrm2 = require( '@stdlib/blas-base-wasm-dznrm2' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* // Perform operation:
+* var out = dznrm2.main( x.length, x, 1 );
+* // returns ~9.54
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+* var dznrm2 = require( '@stdlib/blas-base-wasm-dznrm2' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* // Perform operation:
+* var out = dznrm2.ndarray( x.length, x, 1, 0 );
+* // returns ~9.54
+*
+* @example
+* var Memory = require( '@stdlib/wasm-memory' );
+* var oneTo = require( '@stdlib/array-one-to' );
+* var Complex128Array = require( '@stdlib/array-complex128' );
+* var dznrm2 = require( '@stdlib/blas-base-wasm-dznrm2' );
+*
+* // 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 dznrm2.Module( mem );
+* // returns <Module>
+*
+* // Initialize the routine:
+* mod.initializeSync();
+*
+* // Specify a vector length:
+* var N = 5;
+*
+* // Define a pointer (i.e., byte offset) for storing the input vector:
+* var xptr = 0;
+*
+* // Write vector values to module memory:
+* var xbuf = oneTo( N*2, 'float64' );
+* var x = new Complex128Array( xbuf.buffer );
+* mod.write( xptr, x );
+*
+* // Perform computation:
+* var out = mod.main( N, xptr, 1 );
+* // returns ~19.62
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
+
+// exports: { "Module": "main.Module" }

package/lib/main.js

@@ -0,0 +1,64 @@
+
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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 setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-property' );
+var Routine = require( './routine.js' );
+var Module = require( './module.js' );
+
+
+// MAIN //
+
+/**
+* WebAssembly module to calculate the L2-norm of a complex double-precision floating-point vector.
+*
+* @name dznrm2
+* @type {Routine}
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* // Perform operation:
+* var out = dznrm2.main( x.length, x, 1 );
+* // returns ~9.54
+*
+* @example
+* var Complex128Array = require( '@stdlib/array-complex128' );
+*
+* // Define a strided array:
+* var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+*
+* // Perform operation:
+* var out = dznrm2.ndarray( x.length, x, 1, 0 );
+* // returns ~9.54
+*/
+var dznrm2 = new Routine();
+dznrm2.initializeSync(); // eslint-disable-line node/no-sync
+setReadOnly( dznrm2, 'Module', Module.bind( null ) );
+
+
+// EXPORTS //
+
+module.exports = dznrm2;