diff --git a/lib/node_modules/@stdlib/array/nans/README.md b/lib/node_modules/@stdlib/array/nans/README.md index c54f60f46e30..30e0e56b5ab6 100644 --- a/lib/node_modules/@stdlib/array/nans/README.md +++ b/lib/node_modules/@stdlib/array/nans/README.md @@ -53,6 +53,7 @@ The function recognizes the following data types: - `float64`: double-precision floating-point numbers (IEEE 754) - `float32`: single-precision floating-point numbers (IEEE 754) +- `float16`: half-precision floating-point numbers (IEEE 754) - `complex128`: double-precision complex floating-point numbers - `complex64`: single-precision complex floating-point numbers - `generic`: generic JavaScript values diff --git a/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.js b/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.js index a18ea44186c4..0fae31a28674 100644 --- a/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.js @@ -84,6 +84,24 @@ bench( format( '%s:dtype=%s', pkg, 'float32' ), function benchmark( b ) { b.end(); }); +bench( format( '%s:dtype=%s', pkg, 'float16' ), function benchmark( b ) { + var arr; + var i; + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + arr = nans( 0, 'float16' ); + if ( arr.length !== 0 ) { + b.fail( 'should have length 0' ); + } + } + b.toc(); + if ( !isTypedArrayLike( arr ) ) { + b.fail( 'should return a typed array' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); + bench( format( '%s:dtype=%s', pkg, 'complex128' ), function benchmark( b ) { var arr; var i; diff --git a/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.length.float16.js b/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.length.float16.js new file mode 100644 index 000000000000..6d2d4ea01f1f --- /dev/null +++ b/lib/node_modules/@stdlib/array/nans/benchmark/benchmark.length.float16.js @@ -0,0 +1,94 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2026 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 bench = require( '@stdlib/bench' ); +var pow = require( '@stdlib/math/base/special/pow' ); +var isTypedArray = require( '@stdlib/assert/is-typed-array' ); +var format = require( '@stdlib/string/format' ); +var pkg = require( './../package.json' ).name; +var nans = require( './../lib' ); + + +// FUNCTIONS // + +/** +* Creates a benchmark function. +* +* @private +* @param {PositiveInteger} len - array length +* @returns {Function} benchmark function +*/ +function createBenchmark( len ) { + return benchmark; + + /** + * Benchmark function. + * + * @private + * @param {Benchmark} b - benchmark instance + */ + function benchmark( b ) { + var arr; + var i; + + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + arr = nans( len, 'float16' ); + if ( arr.length !== len ) { + b.fail( 'unexpected length' ); + } + } + b.toc(); + if ( !isTypedArray( arr ) ) { + b.fail( 'should return a typed array' ); + } + b.pass( 'benchmark finished' ); + b.end(); + } +} + + +// MAIN // + +/** +* Main execution sequence. +* +* @private +*/ +function main() { + var len; + var min; + var max; + var f; + var i; + + min = 1; // 10^min + max = 6; // 10^max + + for ( i = min; i <= max; i++ ) { + len = pow( 10, i ); + f = createBenchmark( len ); + bench( format( '%s:dtype=%s,len=%d', pkg, 'float16', len ), f ); + } +} + +main(); diff --git a/lib/node_modules/@stdlib/array/nans/docs/repl.txt b/lib/node_modules/@stdlib/array/nans/docs/repl.txt index 44d0695bec1f..edaa3db3527c 100644 --- a/lib/node_modules/@stdlib/array/nans/docs/repl.txt +++ b/lib/node_modules/@stdlib/array/nans/docs/repl.txt @@ -6,6 +6,7 @@ - float64: double-precision floating-point numbers (IEEE 754) - float32: single-precision floating-point numbers (IEEE 754) + - float16: half-precision floating-point numbers (IEEE 754) - complex128: double-precision complex floating-point numbers - complex64: single-precision complex floating-point numbers - generic: generic JavaScript values diff --git a/lib/node_modules/@stdlib/array/nans/docs/types/index.d.ts b/lib/node_modules/@stdlib/array/nans/docs/types/index.d.ts index 4ea2823eacaa..066ba1fdb129 100644 --- a/lib/node_modules/@stdlib/array/nans/docs/types/index.d.ts +++ b/lib/node_modules/@stdlib/array/nans/docs/types/index.d.ts @@ -20,7 +20,7 @@ /// -import { Complex128Array, Complex64Array, FloatingPointDataType } from '@stdlib/types/array'; +import { Complex128Array, Complex64Array, Float16Array, FloatingPointDataType } from '@stdlib/types/array'; /** * Data type. @@ -53,6 +53,19 @@ declare function nans( length: number, dtype: 'float64' ): Float64Array; */ declare function nans( length: number, dtype: 'float32' ): Float32Array; +/** +* Creates an array filled with NaNs and having a specified length. +* +* @param length - array length +* @param dtype - data type +* @returns filled array +* +* @example +* var arr = nans( 2, 'float16' ); +* // returns [ NaN, NaN ] +*/ +declare function nans( length: number, dtype: 'float16' ): Float16Array; + /** * Creates an array filled with NaNs and having a specified length. * @@ -107,6 +120,7 @@ declare function nans( length: number, dtype: 'generic' ): Array; * * - `float64`: double-precision floating-point numbers (IEEE 754) * - `float32`: single-precision floating-point numbers (IEEE 754) +* - `float16`: half-precision floating-point numbers (IEEE 754) * - `complex128`: double-precision complex floating-point numbers * - `complex64`: single-precision complex floating-point numbers * - `generic`: generic JavaScript values diff --git a/lib/node_modules/@stdlib/array/nans/docs/types/test.ts b/lib/node_modules/@stdlib/array/nans/docs/types/test.ts index e5d2914c15e2..a295c3b76d4f 100644 --- a/lib/node_modules/@stdlib/array/nans/docs/types/test.ts +++ b/lib/node_modules/@stdlib/array/nans/docs/types/test.ts @@ -26,6 +26,7 @@ import nans = require( './index' ); nans( 10 ); // $ExpectType Float64Array nans( 10, 'float64' ); // $ExpectType Float64Array nans( 10, 'float32' ); // $ExpectType Float32Array + nans( 10, 'float16' ); // $ExpectType Float16ArrayFallback nans( 10, 'complex128' ); // $ExpectType Complex128Array nans( 10, 'complex64' ); // $ExpectType Complex64Array nans( 10, 'generic' ); // $ExpectType number[] diff --git a/lib/node_modules/@stdlib/array/nans/package.json b/lib/node_modules/@stdlib/array/nans/package.json index aea9160dd4b7..5afa0df568c4 100644 --- a/lib/node_modules/@stdlib/array/nans/package.json +++ b/lib/node_modules/@stdlib/array/nans/package.json @@ -63,6 +63,7 @@ "matrix", "float64array", "float32array", + "float16array", "complex128array", "complex64array", "complex128", @@ -77,6 +78,9 @@ "float", "single-precision", "float32", + "half", + "half-precision", + "float16", "ieee754", "generic", "fill", diff --git a/lib/node_modules/@stdlib/array/nans/test/test.js b/lib/node_modules/@stdlib/array/nans/test/test.js index 680a8ec5da76..431c9fb83a8e 100644 --- a/lib/node_modules/@stdlib/array/nans/test/test.js +++ b/lib/node_modules/@stdlib/array/nans/test/test.js @@ -23,8 +23,10 @@ var tape = require( 'tape' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var isnanf = require( '@stdlib/math/base/assert/is-nanf' ); +var isnanf16 = require( '@stdlib/number/float16/base/assert/is-nan' ); var Float64Array = require( '@stdlib/array/float64' ); var Float32Array = require( '@stdlib/array/float32' ); +var Float16Array = require( '@stdlib/array/float16' ); var Complex64Array = require( '@stdlib/array/complex64' ); var Complex128Array = require( '@stdlib/array/complex128' ); var reinterpret64 = require( '@stdlib/strided/base/reinterpret-complex64' ); @@ -178,6 +180,20 @@ tape( 'the function returns a filled array (dtype=float32)', function test( t ) t.end(); }); +tape( 'the function returns a filled array (dtype=float16)', function test( t ) { + var arr; + var i; + + arr = nans( 5, 'float16' ); + t.strictEqual( instanceOf( arr, Float16Array ), true, 'returns expected value' ); + t.strictEqual( arr.length, 5, 'returns expected value' ); + + for ( i = 0; i < arr.length; i++ ) { + t.strictEqual( isnanf16( arr[ i ] ), true, 'returns expected value for element '+i ); + } + t.end(); +}); + tape( 'the function returns a filled array (dtype=complex128)', function test( t ) { var arr; var i;