From ce68f3601188b05416095d34fe5916c332aa7e20 Mon Sep 17 00:00:00 2001 From: gururaj1512 Date: Tue, 11 Aug 2026 21:27:27 +0530 Subject: [PATCH 1/2] feat: add float16 dtype support to array/typed-real --- type: pre_commit_static_analysis_report description: Results of running static analysis checks when committing changes. report: - task: lint_filenames status: passed - task: lint_editorconfig status: passed - task: lint_markdown_pkg_readmes status: passed - task: lint_markdown_docs status: na - task: lint_markdown status: na - task: lint_package_json status: passed - task: lint_repl_help status: passed - task: lint_javascript_src status: na - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - task: lint_python status: na - task: lint_r status: na - task: lint_c_src status: na - task: lint_c_examples status: na - task: lint_c_benchmarks status: na - task: lint_c_tests_fixtures status: na - task: lint_shell status: na - task: lint_typescript_declarations status: passed - task: lint_typescript_tests status: na - task: lint_license_headers status: passed --- --- .../@stdlib/array/typed-real/README.md | 4 + .../array/typed-real/benchmark/benchmark.js | 18 ++++ .../benchmark/benchmark.length.float16.js | 94 +++++++++++++++++++ .../@stdlib/array/typed-real/docs/repl.txt | 1 + .../@stdlib/array/typed-real/package.json | 4 + .../@stdlib/array/typed-real/test/test.js | 68 ++++++++++++++ 6 files changed, 189 insertions(+) create mode 100644 lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.length.float16.js diff --git a/lib/node_modules/@stdlib/array/typed-real/README.md b/lib/node_modules/@stdlib/array/typed-real/README.md index 6117c92b5fa2..b8a5eff7f936 100644 --- a/lib/node_modules/@stdlib/array/typed-real/README.md +++ b/lib/node_modules/@stdlib/array/typed-real/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) - `int32`: 32-bit two's complement signed integers - `uint32`: 32-bit unsigned integers - `int16`: 16-bit two's complement signed integers @@ -189,6 +190,7 @@ console.log( arr ); - [`@stdlib/array/float64`][@stdlib/array/float64]: Float64Array. - [`@stdlib/array/float32`][@stdlib/array/float32]: Float32Array. +- [`@stdlib/array/float16`][@stdlib/array/float16]: Float16Array. - [`@stdlib/array/int32`][@stdlib/array/int32]: Int32Array. - [`@stdlib/array/uint32`][@stdlib/array/uint32]: Uint32Array. - [`@stdlib/array/int16`][@stdlib/array/int16]: Int16Array. @@ -215,6 +217,8 @@ console.log( arr ); [@stdlib/array/float32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/float32 +[@stdlib/array/float16]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/float16 + [@stdlib/array/int32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/int32 [@stdlib/array/uint32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/uint32 diff --git a/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.js b/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.js index 5292f84ab64b..d24940cae983 100644 --- a/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.js @@ -83,6 +83,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 = realarray( 0, 'float16' ); + if ( arr.length !== 0 ) { + b.fail( 'should have length 0' ); + } + } + b.toc(); + if ( !isTypedArray( arr ) ) { + b.fail( 'should return a typed array' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); + bench( format( '%s:dtype=%s', pkg, 'int32' ), function benchmark( b ) { var arr; var i; diff --git a/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.length.float16.js b/lib/node_modules/@stdlib/array/typed-real/benchmark/benchmark.length.float16.js new file mode 100644 index 000000000000..2dda9c0849cc --- /dev/null +++ b/lib/node_modules/@stdlib/array/typed-real/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 realarray = 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 = realarray( 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/typed-real/docs/repl.txt b/lib/node_modules/@stdlib/array/typed-real/docs/repl.txt index 6c93288b4e30..dae3ae1453b6 100644 --- a/lib/node_modules/@stdlib/array/typed-real/docs/repl.txt +++ b/lib/node_modules/@stdlib/array/typed-real/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). - int32: 32-bit two's complement signed integers. - uint32: 32-bit unsigned integers. - int16: 16-bit two's complement signed integers. diff --git a/lib/node_modules/@stdlib/array/typed-real/package.json b/lib/node_modules/@stdlib/array/typed-real/package.json index 6e6ff5e64151..4bfe0044e4c3 100644 --- a/lib/node_modules/@stdlib/array/typed-real/package.json +++ b/lib/node_modules/@stdlib/array/typed-real/package.json @@ -63,6 +63,7 @@ "matrix", "float64array", "float32array", + "float16array", "int32array", "uint32array", "int16array", @@ -78,6 +79,9 @@ "float", "single-precision", "float32", + "half", + "half-precision", + "float16", "ieee754", "integer", "int32", diff --git a/lib/node_modules/@stdlib/array/typed-real/test/test.js b/lib/node_modules/@stdlib/array/typed-real/test/test.js index ab0c41df5069..cce02d2cdc0c 100644 --- a/lib/node_modules/@stdlib/array/typed-real/test/test.js +++ b/lib/node_modules/@stdlib/array/typed-real/test/test.js @@ -23,6 +23,7 @@ var tape = require( 'tape' ); var Float64Array = require( '@stdlib/array/float64' ); var Float32Array = require( '@stdlib/array/float32' ); +var Float16Array = require( '@stdlib/array/float16' ); var Int32Array = require( '@stdlib/array/int32' ); var Uint32Array = require( '@stdlib/array/uint32' ); var Int16Array = require( '@stdlib/array/int16' ); @@ -302,6 +303,13 @@ tape( 'the function returns a typed array (dtype=float32)', function test( t ) { t.end(); }); +tape( 'the function returns a typed array (dtype=float16)', function test( t ) { + var arr = realarray( 'float16' ); + t.strictEqual( instanceOf( arr, Float16Array ), true, 'returns expected value' ); + t.strictEqual( arr.length, 0, 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32)', function test( t ) { var arr = realarray( 'int32' ); t.strictEqual( instanceOf( arr, Int32Array ), true, 'returns expected value' ); @@ -372,6 +380,13 @@ tape( 'the function returns a typed array (dtype=float32, length)', function tes t.end(); }); +tape( 'the function returns a typed array (dtype=float16, length)', function test( t ) { + var arr = realarray( 10, 'float16' ); + t.strictEqual( instanceOf( arr, Float16Array ), true, 'returns expected value' ); + t.strictEqual( arr.length, 10, 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, length)', function test( t ) { var arr = realarray( 10, 'int32' ); t.strictEqual( instanceOf( arr, Int32Array ), true, 'returns expected value' ); @@ -454,6 +469,17 @@ tape( 'the function returns a typed array (dtype=float32, array)', function test t.end(); }); +tape( 'the function returns a typed array (dtype=float16, array)', function test( t ) { + var arr = [ 1.0, 2.0, 3.0 ]; + var out = realarray( arr, 'float16' ); + t.strictEqual( instanceOf( out, Float16Array ), true, 'returns expected value' ); + t.strictEqual( out.length, 3, 'returns expected value' ); + t.strictEqual( out[ 0 ], arr[ 0 ], 'returns expected value' ); + t.strictEqual( out[ 1 ], arr[ 1 ], 'returns expected value' ); + t.strictEqual( out[ 2 ], arr[ 2 ], 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, array)', function test( t ) { var arr = [ 1.0, 2.0, 3.0 ]; var out = realarray( arr, 'int32' ); @@ -564,6 +590,17 @@ tape( 'the function returns a typed array (dtype=float32, typed array)', functio t.end(); }); +tape( 'the function returns a typed array (dtype=float16, typed array)', function test( t ) { + var arr = new Uint32Array( [ 1.0, 2.0, 3.0 ] ); + var out = realarray( arr, 'float16' ); + t.strictEqual( instanceOf( out, Float16Array ), true, 'returns expected value' ); + t.strictEqual( out.length, 3, 'returns expected value' ); + t.strictEqual( out[ 0 ], arr[ 0 ], 'returns expected value' ); + t.strictEqual( out[ 1 ], arr[ 1 ], 'returns expected value' ); + t.strictEqual( out[ 2 ], arr[ 2 ], 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, typed array)', function test( t ) { var arr = new Float32Array( [ 1.0, 2.0, 3.0 ] ); var out = realarray( arr, 'int32' ); @@ -669,6 +706,16 @@ tape( 'the function returns a typed array (dtype=float32, arraybuffer)', functio t.end(); }); +tape( 'the function returns a typed array (dtype=float16, arraybuffer)', function test( t ) { + var buf = new ArrayBuffer( 8 ); + var out = realarray( buf, 'float16' ); + t.strictEqual( instanceOf( out, Float16Array ), true, 'returns expected value' ); + t.strictEqual( out.length, 4, 'returns expected value' ); + t.strictEqual( out[ 0 ], 0.0, 'returns expected value' ); + t.strictEqual( out[ 1 ], 0.0, 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, arraybuffer)', function test( t ) { var buf = new ArrayBuffer( 8 ); var out = realarray( buf, 'int32' ); @@ -794,6 +841,17 @@ tape( 'the function returns a typed array (dtype=float32, arraybuffer, byteoffse t.end(); }); +tape( 'the function returns a typed array (dtype=float16, arraybuffer, byteoffset)', function test( t ) { + var buf = new ArrayBuffer( 16 ); + var out = realarray( buf, 4, 'float16' ); + t.strictEqual( instanceOf( out, Float16Array ), true, 'returns expected value' ); + t.strictEqual( out.length, 6, 'returns expected value' ); + t.strictEqual( out[ 0 ], 0.0, 'returns expected value' ); + t.strictEqual( out[ 1 ], 0.0, 'returns expected value' ); + t.strictEqual( out[ 2 ], 0.0, 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, arraybuffer, byteoffset)', function test( t ) { var buf = new ArrayBuffer( 16 ); var out = realarray( buf, 4, 'int32' ); @@ -934,6 +992,16 @@ tape( 'the function returns a typed array (dtype=float32, arraybuffer, byteoffse t.end(); }); +tape( 'the function returns a typed array (dtype=float16, arraybuffer, byteoffset, length)', function test( t ) { + var buf = new ArrayBuffer( 16 ); + var out = realarray( buf, 4, 2, 'float16' ); + t.strictEqual( instanceOf( out, Float16Array ), true, 'returns expected value' ); + t.strictEqual( out.length, 2, 'returns expected value' ); + t.strictEqual( out[ 0 ], 0.0, 'returns expected value' ); + t.strictEqual( out[ 1 ], 0.0, 'returns expected value' ); + t.end(); +}); + tape( 'the function returns a typed array (dtype=int32, arraybuffer, byteoffset, length)', function test( t ) { var buf = new ArrayBuffer( 16 ); var out = realarray( buf, 4, 2, 'int32' ); From feaa0b894528655dd49e2048387a30c17fd0a986 Mon Sep 17 00:00:00 2001 From: Athan Date: Tue, 11 Aug 2026 17:08:20 -0700 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Athan Signed-off-by: Athan --- lib/node_modules/@stdlib/array/typed-real/README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/lib/node_modules/@stdlib/array/typed-real/README.md b/lib/node_modules/@stdlib/array/typed-real/README.md index b8a5eff7f936..d1e133295dbf 100644 --- a/lib/node_modules/@stdlib/array/typed-real/README.md +++ b/lib/node_modules/@stdlib/array/typed-real/README.md @@ -190,7 +190,6 @@ console.log( arr ); - [`@stdlib/array/float64`][@stdlib/array/float64]: Float64Array. - [`@stdlib/array/float32`][@stdlib/array/float32]: Float32Array. -- [`@stdlib/array/float16`][@stdlib/array/float16]: Float16Array. - [`@stdlib/array/int32`][@stdlib/array/int32]: Int32Array. - [`@stdlib/array/uint32`][@stdlib/array/uint32]: Uint32Array. - [`@stdlib/array/int16`][@stdlib/array/int16]: Int16Array. @@ -217,8 +216,6 @@ console.log( arr ); [@stdlib/array/float32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/float32 -[@stdlib/array/float16]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/float16 - [@stdlib/array/int32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/int32 [@stdlib/array/uint32]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/uint32