chore: stuff from code review

Author: aayush0325

lib/node_modules/@stdlib/math/base/special/cabsf/README.md

@@ -33,7 +33,7 @@ The [absolute value][absolute-value] of a [complex][@stdlib/complex/float32/ctor
 ```
 
 <!-- <div class="equation" align="center" data-raw-text="|a + bi| = \sqrt{a^2 + b^2}" data-equation="eq:absolute_value_complex">
-    <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@d4edb68b52a6c646be5683023c5a24890300727f/lib/node_modules/@stdlib/math/base/special/cabsf/docs/img/equation_absolute_value_complex.svg" alt="Absolute value">
+    <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@462b40597988f604d5c05a46279cbb16105a24d3/lib/node_modules/@stdlib/math/base/special/cabsf/docs/img/equation_absolute_value_complex.svg" alt="Absolute value">
     <br>
 </div> -->
 
@@ -55,7 +55,7 @@ var cabsf = require( '@stdlib/math/base/special/cabsf' );
 
 #### cabsf( z )
 
-Computes an [absolute value][absolute-value] of a single-precision [complex][@stdlib/complex/float32/ctor] floating-point number.
+Computes the [absolute value][absolute-value] of a single-precision [complex][@stdlib/complex/float32/ctor] floating-point number.
 
 ```javascript
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
@@ -78,13 +78,16 @@ var y = cabsf( new Complex64( 5.0, 3.0 ) );
 
 ```javascript
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
-var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
 var cabsf = require( '@stdlib/math/base/special/cabsf' );
 
+// Create a PRNG to generate uniformly distributed pseudorandom integers:
+var rand = discreteUniform( -50, 50 );
+
 var z;
 var i;
 for ( i = 0; i < 100; i++ ) {
-    z = new Complex64( discreteUniform( -50, 50 ), discreteUniform( -50, 50 ) );
+    z = new Complex64( rand(), rand() );
     console.log( 'cabsf(%s) = %d', z.toString(), cabsf( z ) );
 }
 ```

lib/node_modules/@stdlib/math/base/special/cabsf/benchmark/c/benchmark.c

@@ -78,7 +78,7 @@ static double tic( void ) {
 *
 * @return random number
 */
-static double rand_float( void ) {
+static float rand_float( void ) {
 	int r = rand();
 	return (float)r / ( (float)RAND_MAX + 1.0f );
 }
@@ -93,8 +93,8 @@ static double benchmark( void ) {
 	double elapsed;
 	float re;
 	float im;
-	float y;
 	double t;
+	float y;
 	int i;
 
 	t = tic();

lib/node_modules/@stdlib/math/base/special/cabsf/benchmark/julia/benchmark.jl

@@ -2,7 +2,7 @@
 #
 # @license Apache-2.0
 #
-# Copyright (c) 2024 The Stdlib Authors.
+# Copyright (c) 2021 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.
@@ -16,129 +16,58 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import BenchmarkTools
-using Printf
-
-# Benchmark variables:
-name = "cabsf";
-repeats = 3;
+import JSON
 
 """
-	print_version()
-
-Prints the TAP version.
+    gen( re, im, name )
 
-# Examples
-
-``` julia
-julia> print_version()
-```
-"""
-function print_version()
-	@printf( "TAP version 13\n" );
-end
-
-"""
-	print_summary( total, passing )
-
-Print the benchmark summary.
+Generate fixture data and write to file.
 
 # Arguments
 
-* `total`: total number of tests
-* `passing`: number of passing tests
+* `re`: domain (real components)
+* `im`: domain (imaginary components)
+* `name::AbstractString`: output filename
 
 # Examples
 
 ``` julia
-julia> print_summary( 3, 3 )
+julia> re = range( -1.0, stop = 1.0, length = 2001 );
+julia> im = range( -1.0, stop = 1.0, length = 2001 );
+julia> gen( re, im, \"data.json\" );
 ```
 """
-function print_summary( total, passing )
-	@printf( "#\n" );
-	@printf( "1..%d\n", total ); # TAP plan
-	@printf( "# total %d\n", total );
-	@printf( "# pass  %d\n", passing );
-	@printf( "#\n" );
-	@printf( "# ok\n" );
-end
-
-"""
-	print_results( iterations, elapsed )
-
-Print benchmark results.
-
-# Arguments
-
-* `iterations`: number of iterations
-* `elapsed`: elapsed time (in seconds)
-
-# Examples
-
-``` julia
-julia> print_results( 1000000, 0.131009101868 )
-```
-"""
-function print_results( iterations, elapsed )
-	rate = iterations / elapsed
-
-	@printf( "  ---\n" );
-	@printf( "  iterations: %d\n", iterations );
-	@printf( "  elapsed: %0.9f\n", elapsed );
-	@printf( "  rate: %0.9f\n", rate );
-	@printf( "  ...\n" );
-end
-
-"""
-	benchmark()
-
-Run a benchmark.
-
-# Notes
-
-* Benchmark results are returned as a two-element array: [ iterations, elapsed ].
-* The number of iterations is not the true number of iterations. Instead, an 'iteration' is defined as a 'sample', which is a computed estimate for a single evaluation.
-* The elapsed time is in seconds.
-
-# Examples
-
-``` julia
-julia> out = benchmark();
-```
-"""
-function benchmark()
-	t = BenchmarkTools.@benchmark abs( ComplexF32( (rand()*1000.0) - 500.0, (rand()*1000.0) - 500.0 ) ) samples=1e6
-
-	# Compute the total "elapsed" time and convert from nanoseconds to seconds:
-	s = sum( t.times ) / 1.0e9;
-
-	# Determine the number of "iterations":
-	iter = length( t.times );
+function gen( re, im, name )
+	z = complex.( re, im );
+	y = Array{Float32}( undef, length(z) );
+	for i in eachindex(z)
+		y[i] = abs( ComplexF32( z[i] ) );
+	end
 
-	# Return the results:
-	[ iter, s ];
+	# Store data to be written to file as a collection:
+	data = Dict([
+		("re", re),
+		("im", im),
+		("expected", y)
+	]);
+
+	# Based on the script directory, create an output filepath:
+	filepath = joinpath( dir, name );
+
+	# Write the data to the output filepath as JSON:
+	outfile = open( filepath, "w" );
+	write( outfile, JSON.json(data) );
+	write( outfile, "\n" );
+	close( outfile );
 end
 
-"""
-	main()
-
-Run benchmarks.
-
-# Examples
+# Get the filename:
+file = @__FILE__;
 
-``` julia
-julia> main();
-```
-"""
-function main()
-	print_version();
-	for i in 1:repeats
-		@printf( "# julia::%s\n", name );
-		results = benchmark();
-		print_results( results[ 1 ], results[ 2 ] );
-		@printf( "ok %d benchmark finished\n", i );
-	end
-	print_summary( repeats, repeats );
-end
+# Extract the directory in which this file resides:
+dir = dirname( file );
 
-main();
+# Generate fixture data:
+re = range( -1000.0, stop = 1000.0, length = 2003 );
+im = range( -1000.0, stop = 1000.0, length = 2003 );
+gen( re, im, "data.json" );

lib/node_modules/@stdlib/math/base/special/cabsf/examples/index.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 The Stdlib Authors.
+* Copyright (c) 2021 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.
@@ -22,6 +22,7 @@ var Complex64 = require( '@stdlib/complex/float32/ctor' );
 var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
 var cabsf = require( './../lib' );
 
+// Create a PRNG to generate uniformly distributed pseudorandom integers:
 var rand = discreteUniform( -50, 50 );
 
 var z;

lib/node_modules/@stdlib/math/base/special/cabsf/lib/index.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 The Stdlib Authors.
+* Copyright (c) 2021 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.

lib/node_modules/@stdlib/math/base/special/cabsf/lib/main.js

@@ -28,7 +28,7 @@ var imag = require( '@stdlib/complex/float32/imag' );
 // MAIN //
 
 /**
-* Computes the absolute value of a double-precision complex floating-point number.
+* Computes the absolute value of a single-precision complex floating-point number.
 *
 * @param {Complex64} z - complex number
 * @returns {number} absolute value

lib/node_modules/@stdlib/math/base/special/cabsf/test/fixtures/julia/data.json

@@ -2,7 +2,7 @@
 #
 # @license Apache-2.0
 #
-# Copyright (c) 2018 The Stdlib Authors.
+# Copyright (c) 2021 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.