Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -22,6 +22,7 @@
 
 <details>
 
+-   [`016b07f`](https://github.com/stdlib-js/stdlib/commit/016b07f8610e21332af7bfbc38afbacdbeac8583) - **refactor:** rename/reorder parameters _(by Athan Reines)_
 -   [`f40ccb7`](https://github.com/stdlib-js/stdlib/commit/f40ccb75929e92538b8c366145589addccdaafbe) - **feat:** add `ndarray/base/ternary-loop-interchange-order` [(#9499)](https://github.com/stdlib-js/stdlib/pull/9499) _(by Muhammad Haris, Athan Reines)_
 
 </details>

README.md

@@ -73,7 +73,7 @@ To view installation and usage instructions specific to each branch build, be su
 var ternaryLoopOrder = require( '@stdlib/ndarray-base-binary-loop-interchange-order' );
 ```
 
-#### ternaryLoopOrder( shape, stridesW, stridesX, stridesY, stridesZ )
+#### ternaryLoopOrder( shape, stridesX, stridesY, stridesZ, stridesW )
 
 Reorders [ndarray][@stdlib/ndarray/ctor] dimensions and associated strides for [loop interchange][loop-interchange].
 
@@ -82,25 +82,25 @@ Reorders [ndarray][@stdlib/ndarray/ctor] dimensions and associated strides for [
 var shape = [ 2, 2 ];
 
 // Define the strides for the input arrays:
-var stridesW = [ 2, 1 ]; // row-major
-var stridesX = [ 4, 2 ]; // row-major
-var stridesY = [ 1, 2 ]; // column-major
+var stridesX = [ 2, 1 ]; // row-major
+var stridesY = [ 4, 2 ]; // row-major
+var stridesZ = [ 1, 2 ]; // column-major
 
 // Define the strides for the output array:
-var stridesZ = [ 1, 2 ]; // column-major
+var stridesW = [ 1, 2 ]; // column-major
 
 // Resolve the loop interchange order:
-var o = ternaryLoopOrder( shape, stridesW, stridesX, stridesY, stridesZ );
+var o = ternaryLoopOrder( shape, stridesX, stridesY, stridesZ, stridesW );
 // returns {...}
 ```
 
 The function returns an object having the following properties:
 
 -   **sh**: ordered dimensions.
--   **sw**: first input array strides sorted in loop order.
--   **sx**: second input array strides sorted in loop order.
--   **sy**: third input array strides sorted in loop order.
--   **sz**: output array strides sorted in loop order.
+-   **sx**: first input array strides sorted in loop order.
+-   **sy**: second input array strides sorted in loop order.
+-   **sz**: third input array strides sorted in loop order.
+-   **sw**: output array strides sorted in loop order.
 
 For all returned arrays, the first element corresponds to the innermost loop, and the last element corresponds to the outermost loop.
 
@@ -143,13 +143,13 @@ var getStrides = require( '@stdlib/ndarray-strides' );
 var ternaryLoopOrder = require( '@stdlib/ndarray-base-binary-loop-interchange-order' );
 
 // Create ndarrays:
-var w = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-var x = array( [ [ 5, 6 ], [ 7, 8 ] ] );
-var y = array( [ [ 9, 10 ], [ 11, 12 ] ] );
-var z = array( [ [ 0, 0 ], [ 0, 0 ] ] );
+var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
+var y = array( [ [ 5, 6 ], [ 7, 8 ] ] );
+var z = array( [ [ 9, 10 ], [ 11, 12 ] ] );
+var w = array( [ [ 0, 0 ], [ 0, 0 ] ] );
 
 // Resolve loop interchange data:
-var o = ternaryLoopOrder( getShape( w ), getStrides( w ), getStrides( x ), getStrides( y ), getStrides( z ) );
+var o = ternaryLoopOrder( getShape( x ), getStrides( x ), getStrides( y ), getStrides( z ), getStrides( w ) );
 // returns {...}
 
 console.log( o );

benchmark/benchmark.js

@@ -23,13 +23,14 @@
 var bench = require( '@stdlib/bench-harness' );
 var isArray = require( '@stdlib/assert-is-array' );
 var shape2strides = require( '@stdlib/ndarray-base-shape2strides' );
+var format = require( '@stdlib/string-format' );
 var pkg = require( './../package.json' ).name;
 var ternaryLoopOrder = require( './../lib' );
 
 
 // MAIN //
 
-bench( pkg+'::row-major', function benchmark( b ) {
+bench( format( '%s::row-major', pkg ), function benchmark( b ) {
 	var strides;
 	var factors;
 	var shape;
@@ -52,14 +53,20 @@ bench( pkg+'::row-major', function benchmark( b ) {
 		}
 	}
 	b.toc();
-	if ( !isArray( out.sh ) || !isArray( out.sx ) || !isArray( out.sy ) || !isArray( out.sz ) ) { // eslint-disable-line max-len
+	if (
+		!isArray( out.sh ) ||
+		!isArray( out.sx ) ||
+		!isArray( out.sy ) ||
+		!isArray( out.sz ) ||
+		!isArray( out.sw )
+	) {
 		b.fail( 'should return an array' );
 	}
 	b.pass( 'benchmark finished' );
 	b.end();
 });
 
-bench( pkg+'::column-major', function benchmark( b ) {
+bench( format( '%s::column-major', pkg ), function benchmark( b ) {
 	var strides;
 	var factors;
 	var shape;
@@ -82,7 +89,13 @@ bench( pkg+'::column-major', function benchmark( b ) {
 		}
 	}
 	b.toc();
-	if ( !isArray( out.sh ) || !isArray( out.sx ) || !isArray( out.sy ) || !isArray( out.sz ) ) { // eslint-disable-line max-len
+	if (
+		!isArray( out.sh ) ||
+		!isArray( out.sx ) ||
+		!isArray( out.sy ) ||
+		!isArray( out.sz ) ||
+		!isArray( out.sw )
+	) {
 		b.fail( 'should return an array' );
 	}
 	b.pass( 'benchmark finished' );

dist/index.js

@@ -1,14 +1,14 @@
 
-{{alias}}( shape, stridesW, stridesX, stridesY, stridesZ )
+{{alias}}( shape, stridesX, stridesY, stridesZ, stridesW )
     Reorders ndarray dimensions and associated strides for loop interchange.
 
     The function returns an object having the following properties:
 
     - sh: ordered dimensions.
-    - sw: first input array strides sorted in loop order.
-    - sx: second input array strides sorted in loop order.
-    - sy: third input array strides sorted in loop order.
-    - sz: output array strides sorted in loop order.
+    - sx: first input array strides sorted in loop order.
+    - sy: second input array strides sorted in loop order.
+    - sz: third input array strides sorted in loop order.
+    - sw: output array strides sorted in loop order.
 
     For all returned arrays, the first element corresponds to the innermost
     loop, and the last element corresponds to the outermost loop.
@@ -21,16 +21,16 @@
     shape: ArrayLikeObject<integer>
         Array dimensions.
 
-    stridesW: ArrayLikeObject<integer>
+    stridesX: ArrayLikeObject<integer>
         First input array strides.
 
-    stridesX: ArrayLikeObject<integer>
+    stridesY: ArrayLikeObject<integer>
         Second input array strides.
 
-    stridesY: ArrayLikeObject<integer>
+    stridesZ: ArrayLikeObject<integer>
         Third input array strides.
 
-    stridesZ: ArrayLikeObject<integer>
+    stridesW: ArrayLikeObject<integer>
         Output array strides.
 
     Returns
@@ -41,25 +41,30 @@
     out.sh: Array<integer>
         Ordered dimensions.
 
-    out.sw: Array<integer>
+    out.sx: Array<integer>
         First input array strides sorted in loop order.
 
-    out.sx: Array<integer>
+    out.sy: Array<integer>
         Second input array strides sorted in loop order.
 
-    out.sy: Array<integer>
+    out.sz: Array<integer>
         Third input array strides sorted in loop order.
 
-    out.sz: Array<integer>
+    out.sw: Array<integer>
         Output array strides sorted in loop order.
 
     Examples
     --------
-    > var w = {{alias:@stdlib/ndarray/array}}( [ [ 1, 2 ], [ 3, 4 ] ] );
-    > var x = {{alias:@stdlib/ndarray/array}}( [ [ 5, 6 ], [ 7, 8 ] ] );
-    > var y = {{alias:@stdlib/ndarray/array}}( [ [ 9, 10 ], [ 11, 12 ] ] );
-    > var z = {{alias:@stdlib/ndarray/array}}( [ [ 0, 0 ], [ 0, 0 ] ] );
-    > var o = {{alias}}( w.shape, w.strides, x.strides, y.strides, z.strides )
+    > var x = {{alias:@stdlib/ndarray/array}}( [ [ 1, 2 ], [ 3, 4 ] ] );
+    > var y = {{alias:@stdlib/ndarray/array}}( [ [ 5, 6 ], [ 7, 8 ] ] );
+    > var z = {{alias:@stdlib/ndarray/array}}( [ [ 9, 10 ], [ 11, 12 ] ] );
+    > var w = {{alias:@stdlib/ndarray/array}}( [ [ 0, 0 ], [ 0, 0 ] ] );
+    > var sh = {{alias:@stdlib/ndarray/shape}}( x );
+    > var sx = {{alias:@stdlib/ndarray/strides}}( x );
+    > var sy = {{alias:@stdlib/ndarray/strides}}( y );
+    > var sz = {{alias:@stdlib/ndarray/strides}}( z );
+    > var sw = {{alias:@stdlib/ndarray/strides}}( w );
+    > var o = {{alias}}( sh, sx, sy, sz, sw )
     {...}
 
     See Also