Auto-generated commit

Author: stdlib-bot

CONTRIBUTORS

@@ -2,26 +2,26 @@
 #
 # Contributors listed in alphabetical order.
 
-Adarsh Palaskar <83298237+adarshpalaskar1@users.noreply.github.com>
-Aditya Sapra <110766802+adityacodes30@users.noreply.github.com>
+Adarsh Palaskar <adarshpalaskar99@gmail.com>
+Aditya Sapra <adityaework@gmail.com>
 AgPriyanshu18 <113460573+AgPriyanshu18@users.noreply.github.com>
 Ali Salesi <ali_sal1381@yahoo.com>
-Aman Bhansali <92033532+aman-095@users.noreply.github.com>
+Aman Bhansali <bhansali.1@iitj.ac.in>
 Amit Jimiwal <amitjimiwal45@gmail.com>
-Anudeep Sanapala <71971574+anudeeps0306@users.noreply.github.com>
+Anudeep Sanapala <anudeep0306@gmail.com>
 Athan Reines <kgryte@gmail.com>
 Brendan Graetz <bguiz@users.noreply.github.com>
 Bruno Fenzl <brunofenzl@gmail.com>
-Chinmay J <86140365+JawHawk@users.noreply.github.com>
+Chinmay Joshi <86140365+JawHawk@users.noreply.github.com>
 Christopher Dambamuromo <chridam@gmail.com>
 Dan Rose <danoftheroses@gmail.com>
 Daniel Killenberger <daniel.killenberger@gmail.com>
 Dominik Moritz <domoritz@gmail.com>
 Dorrin Sotoudeh <dorrinsotoudeh123@gmail.com>
 EuniceSim142 <77243938+EuniceSim142@users.noreply.github.com>
 Frank Kovacs <fran70kk@gmail.com>
-GUNJ JOSHI <gunjjoshi8372@gmail.com>
-Golden <103646877+AuenKr@users.noreply.github.com>
+Golden Kumar <103646877+AuenKr@users.noreply.github.com>
+Gunj Joshi <gunjjoshi8372@gmail.com>
 Harshita Kalani <harshitakalani02@gmail.com>
 Jaimin Godhani <112328542+Jai0401@users.noreply.github.com>
 James Gelok <jdgelok@gmail.com>
@@ -50,7 +50,7 @@ Pranav Goswami <goswami.4@iitj.ac.in>
 Praneki <97080887+PraneGIT@users.noreply.github.com>
 Pratik <97464067+Pratik772846@users.noreply.github.com>
 Priyansh <88396544+itsspriyansh@users.noreply.github.com>
-Raunak Kumar Gupta <95216822+raunak-dev-edu@users.noreply.github.com>
+Raunak Kumar Gupta <raunakmodanwal321@gmail.com>
 Rejoan Sardar <119718513+Rejoan-Sardar@users.noreply.github.com>
 Ricky Reusser <rsreusser@gmail.com>
 Robert Gislason <gztown2216@yahoo.com>
@@ -59,16 +59,16 @@ Rutam <138517416+performant23@users.noreply.github.com>
 Ryan Seal <splrk@users.noreply.github.com>
 Sai Srikar Dumpeti <80447788+the-r3aper7@users.noreply.github.com>
 Seyyed Parsa Neshaei <spneshaei@users.noreply.github.com>
-Shashank Shekhar Singh <123410790+Shashankss1205@users.noreply.github.com>
+Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 Shraddheya Shendre <shendreshraddheya@gmail.com>
-Shubham <shubh622005@gmail.com>
+Shubham Mishra <shubh622005@gmail.com>
 Snehil Shah <130062020+Snehil-Shah@users.noreply.github.com>
-Spandan Barve <114365550+marsian83@users.noreply.github.com>
+Spandan Barve <contact@marsian.dev>
 Stephannie Jiménez Gacha <steff456@hotmail.com>
-Utkarsh <137638507+Ut-the-pro@users.noreply.github.com>
+Utkarsh <http://utkarsh11105@gmail.com>
+Utkarsh Raj <rajutkarsh2505@gmail.com>
+Varad Gupta <varadgupta21@gmail.com>
 Yernar Yergaziyev <yernar.yergaziyev@erg.kz>
 nishant-s7 <97207366+nishant-s7@users.noreply.github.com>
 orimiles5 <97595296+orimiles5@users.noreply.github.com>
 rei2hu <reimu@reimu.ws>
-utkarsh_raj <49344502+rajutkarsh07@users.noreply.github.com>
-vr-varad <114755221+vr-varad@users.noreply.github.com>

base/count-same-value/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # countSameValue
 
-> Count the number of elements that are equal to a given value in an array.
+> Count the number of elements in an array that are equal to a specified value.
 
 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
 
@@ -42,7 +42,7 @@ var countSameValue = require( '@stdlib/array/base/count-same-value' );
 
 #### countSameValue( x, value )
 
-Counts the number of elements that are equal to a given value in an array.
+Counts the number of elements in an array that are equal to a specified value.
 
 ```javascript
 var x = [ 0, 1, 0, 1, 2 ];
@@ -72,10 +72,12 @@ var out = countSameValue( x, 1 );
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var sample = require( '@stdlib/random/sample' );
+var bernoulli = require( '@stdlib/random/array/bernoulli' );
 var countSameValue = require( '@stdlib/array/base/count-same-value' );
 
-var x = sample( [ 1, 2, 3, 4, 5 ] );
+var x = bernoulli( 10, 0.5, {
+    'dtype': 'generic'
+});
 console.log( x );
 
 var n = countSameValue( x, 1 );

base/count-same-value/docs/repl.txt

@@ -1,6 +1,7 @@
 
 {{alias}}( x, value )
-    Counts the number of elements that are equal to a given value in an array.
+    Counts the number of elements in an array that are equal to a specified
+    value.
 
     Parameters
     ----------
@@ -13,7 +14,7 @@
     Returns
     -------
     out: integer
-        Number of elements that are equal to the given value.
+        Number of elements that are equal to the specified value.
 
     Examples
     --------

base/count-same-value/docs/types/index.d.ts

@@ -23,11 +23,11 @@
 import { Collection } from '@stdlib/types/array';
 
 /**
-* Counts the number of elements that are equal to a given value in an array.
+* Counts the number of elements in an array that are equal to a specified value.
 *
 * @param x - input array
-* @param value - given value
-* @returns number of elements that are equal to the given value
+* @param value - search value
+* @returns number of elements that are equal to a specified value
 *
 * @example
 * var x = [ 0, 1, 0, 1, 1 ];

base/count-same-value/examples/index.js

@@ -18,10 +18,12 @@
 
 'use strict';
 
-var sample = require( '@stdlib/random/sample' );
+var bernoulli = require( '@stdlib/random/array/bernoulli' );
 var countSameValue = require( './../lib' );
 
-var x = sample( [ 1, 2, 3, 4, 5 ] );
+var x = bernoulli( 10, 0.5, {
+	'dtype': 'generic'
+});
 console.log( x );
 
 var n = countSameValue( x, 1 );

base/count-same-value/lib/index.js

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Count the number of elements that are equal to a given value in an array.
+* Count the number of elements in an array that are equal to a specified value.
 *
 * @module @stdlib/array/base/count-same-value
 *

base/count-same-value/lib/main.js

@@ -21,30 +21,30 @@
 // MODULES //
 
 var isComplexLike = require( '@stdlib/assert/is-complex-like' );
-var real = require( '@stdlib/complex/real' );
-var imag = require( '@stdlib/complex/imag' );
 var reinterpret = require( '@stdlib/strided/base/reinterpret-complex' );
 var isComplexTypedArray = require( './../../../base/assert/is-complex-typed-array' );
 var isAccessorArray = require( './../../../base/assert/is-accessor-array' );
 var resolveGetter = require( './../../../base/resolve-getter' );
 var isSameValue = require( '@stdlib/assert/is-same-value' );
+var real = require( '@stdlib/complex/real' );
+var imag = require( '@stdlib/complex/imag' );
 
 
 // FUNCTIONS //
 
 /**
-* Counts the number of elements that are equal to a given value in an indexed array.
+* Counts the number of elements in an array that are equal to a specified value.
 *
 * @private
 * @param {Collection} x - input array
-* @param {*} value - given value
-* @returns {NonNegativeInteger} number of elements that are equal to the given value
+* @param {*} value - search value
+* @returns {NonNegativeInteger} number of elements that are equal to a specified value
 *
 * @example
-* var x = [ 0, 1, 0, 1 ];
+* var x = [ 0, 1, 0, 1, 1 ];
 *
 * var n = indexed( x, 1 );
-* // returns 2
+* // returns 3
 */
 function indexed( x, value ) {
 	var n;
@@ -60,20 +60,20 @@ function indexed( x, value ) {
 }
 
 /**
-* Counts the number of elements that are equal to a given value in an accessor array.
+* Counts the number of elements in an accessor array that are equal to a specified value.
 *
 * @private
 * @param {Collection} x - input array
-* @param {*} value - given value
-* @returns {NonNegativeInteger} number of elements that are equal to the given value
+* @param {*} value - search value
+* @returns {NonNegativeInteger} number of elements that are equal to a provided value
 *
 * @example
 * var toAccessorArray = require( '@stdlib/array/base/to-accessor-array' );
 *
-* var x = toAccessorArray( [ 0, 1, 0, 1 ] );
+* var x = toAccessorArray( [ 0, 1, 0, 1, 1 ] );
 *
 * var n = accessors( x, 1 );
-* // returns 2
+* // returns 3
 */
 function accessors( x, value ) {
 	var get;
@@ -92,16 +92,16 @@ function accessors( x, value ) {
 }
 
 /**
-* Counts the number of elements that are equal to a given value in a complex array.
+* Counts the number of elements in a complex array that are equal to a specified value.
 *
 * @private
 * @param {Collection} x - input array
-* @param {*} value - given value
-* @returns {NonNegativeInteger} number of elements that are equal to the given value
+* @param {*} value - search value
+* @returns {NonNegativeInteger} number of elements that are equal to a specified value
 *
 * @example
-* var Complex128 = require( '@stdlib/complex/float64' );
 * var Complex128Array = require( '@stdlib/array/complex128' );
+* var Complex128 = require( '@stdlib/complex/float64' );
 *
 * var x = new Complex128Array( [ 1.0, 2.0, 0.0, 0.0, 3.0, 4.0, 0.0, 0.0 ] );
 *
@@ -118,15 +118,14 @@ function complex( x, value ) {
 	if ( !isComplexLike( value ) ) {
 		return 0;
 	}
-
 	re = real( value );
 	im = imag( value );
 
 	view = reinterpret( x, 0 );
 
 	n = 0;
 	for ( i = 0; i < view.length; i += 2 ) {
-		if ( isSameValue( view[ i ], re ) && isSameValue( view[ i + 1 ], im ) ) {
+		if ( isSameValue( view[ i ], re ) && isSameValue( view[ i+1 ], im ) ) {
 			n += 1;
 		}
 	}
@@ -137,11 +136,11 @@ function complex( x, value ) {
 // MAIN //
 
 /**
-* Counts the number of elements that are equal to a given value in an array.
+* Counts the number of elements in an array that are equal to a specified value.
 *
 * @param {Collection} x - input array
-* @param {*} value - given value
-* @returns {NonNegativeInteger} number of elements that are equal to the given value
+* @param {*} value - search value
+* @returns {NonNegativeInteger} number of elements that are equal to a specified value
 *
 * @example
 * var x = [ 0, 1, 0, 1, 1 ];

base/count-same-value/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/array/base/count-same-value",
   "version": "0.0.0",
-  "description": "Count the number of elements that are equal to a given value in an array.",
+  "description": "Count the number of elements in an array that are equal to a specified value.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",
@@ -60,6 +60,7 @@
     "summation",
     "countif",
     "total",
-    "same"
+    "same",
+    "equal"
   ]
 }

base/count-same-value/test/test.js

@@ -56,10 +56,15 @@ tape( 'the function distinguishes between positive and negative zeros (generic)'
 	var x;
 
 	x = [ 0.0, -0.0, 0.0, -0.0, 0.0, NaN, 1.0 ];
+
 	expected = 3;
 	actual = countSameValue( x, 0.0 );
+	t.strictEqual( actual, expected, 'returns expected value' );
 
+	expected = 2;
+	actual = countSameValue( x, -0.0 );
 	t.strictEqual( actual, expected, 'returns expected value' );
+
 	t.end();
 });
 
@@ -68,7 +73,7 @@ tape( 'the function considers all NaN values to be identical (generic)', functio
 	var actual;
 	var x;
 
-	x = [ NaN, 0, NaN, 2, NaN, 9, NaN ];
+	x = [ NaN, 0.0, NaN, 2.0, NaN, 9.0, NaN ];
 	expected = 4;
 	actual = countSameValue( x, NaN );
 
@@ -95,10 +100,15 @@ tape( 'the function distinguishes between positive and negative zeros (accessors
 	var x;
 
 	x = toAccessorArray( [ 0.0, -0.0, 0.0, -0.0, 0.0, NaN, 1.0 ] );
+
 	expected = 3;
 	actual = countSameValue( x, 0.0 );
+	t.strictEqual( actual, expected, 'returns expected value' );
 
+	expected = 2;
+	actual = countSameValue( x, -0.0 );
 	t.strictEqual( actual, expected, 'returns expected value' );
+
 	t.end();
 });
 
@@ -107,7 +117,7 @@ tape( 'the function considers all NaN values to be identical (accessors)', funct
 	var actual;
 	var x;
 
-	x = toAccessorArray( [ NaN, 0, NaN, 2, NaN, 9, NaN ] );
+	x = toAccessorArray( [ NaN, 0.0, NaN, 2.0, NaN, 9.0, NaN ] );
 	expected = 4;
 	actual = countSameValue( x, NaN );
 
@@ -134,10 +144,15 @@ tape( 'the function distinguishes between positive and negative zeros (real type
 	var x;
 
 	x = new Float32Array( [ 0.0, -0.0, 0.0, -0.0, 0.0, NaN, 1.0 ] );
+
 	expected = 3;
 	actual = countSameValue( x, 0.0 );
+	t.strictEqual( actual, expected, 'returns expected value' );
 
+	expected = 2;
+	actual = countSameValue( x, -0.0 );
 	t.strictEqual( actual, expected, 'returns expected value' );
+
 	t.end();
 });
 
@@ -146,7 +161,7 @@ tape( 'the function considers all NaN values to be identical (real typed array)'
 	var actual;
 	var x;
 
-	x = new Float32Array( [ NaN, 0, NaN, 2, NaN, 9, NaN ] );
+	x = new Float32Array( [ NaN, 0.0, NaN, 2.0, NaN, 9.0, NaN ] );
 	expected = 4;
 	actual = countSameValue( x, NaN );
 
@@ -172,7 +187,7 @@ tape( 'the function distinguishes between positive and negative zeros (complex t
 	var actual;
 	var x;
 
-	x = new Complex128Array( [ 0.0, -0.0, 0.0, -0.0, 0.0, 0.0, -0.0, -0.0, -0.0, 0.0 ] );
+	x = new Complex128Array( [ 0.0, -0.0, 0.0, -0.0, 0.0, 0.0, -0.0, -0.0, -0.0, 0.0 ] ); // eslint-disable-line max-len
 	expected = 2;
 	actual = countSameValue( x, new Complex128( 0.0, -0.0 ) );
 

base/lib/index.js

@@ -432,6 +432,15 @@ setReadOnly( ns, 'copyIndexed', require( './../../base/copy-indexed' ) );
 */
 setReadOnly( ns, 'countFalsy', require( './../../base/count-falsy' ) );
 
+/**
+* @name countSameValue
+* @memberof ns
+* @readonly
+* @type {Function}
+* @see {@link module:@stdlib/array/base/count-same-value}
+*/
+setReadOnly( ns, 'countSameValue', require( './../../base/count-same-value' ) );
+
 /**
 * @name countTruthy
 * @memberof ns

mskreject/README.md

@@ -95,6 +95,12 @@ console.log( y );
 
 <section class="related">
 
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/array/mskfilter`][@stdlib/array/mskfilter]</span><span class="delimiter">: </span><span class="description">apply a mask to a provided input array.</span>
+
 </section>
 
 <!-- /.related -->
@@ -105,6 +111,12 @@ console.log( y );
 
 [@stdlib/array/dtypes]: https://github.com/stdlib-js/array/tree/main/dtypes
 
+<!-- <related-links> -->
+
+[@stdlib/array/mskfilter]: https://github.com/stdlib-js/array/tree/main/mskfilter
+
+<!-- </related-links> -->
+
 </section>
 
 <!-- /.links -->

safe-casts/README.md

@@ -128,6 +128,7 @@ for ( i = 0; i < DTYPES.length; i++ ) {
 -   <span class="package-name">[`@stdlib/array/convert`][@stdlib/array/convert]</span><span class="delimiter">: </span><span class="description">convert an array to an array of a different data type.</span>
 -   <span class="package-name">[`@stdlib/array/convert-same`][@stdlib/array/convert-same]</span><span class="delimiter">: </span><span class="description">convert an array to the same data type as a second input array.</span>
 -   <span class="package-name">[`@stdlib/array/dtypes`][@stdlib/array/dtypes]</span><span class="delimiter">: </span><span class="description">list of array data types.</span>
+-   <span class="package-name">[`@stdlib/array/mostly-safe-casts`][@stdlib/array/mostly-safe-casts]</span><span class="delimiter">: </span><span class="description">return a list of array data types to which a provided array data type can be safely cast and, for floating-point data types, can be downcast.</span>
 -   <span class="package-name">[`@stdlib/array/same-kind-casts`][@stdlib/array/same-kind-casts]</span><span class="delimiter">: </span><span class="description">return a list of array data types to which a provided array data type can be safely cast or cast within the same kind.</span>
 -   <span class="package-name">[`@stdlib/ndarray/safe-casts`][@stdlib/ndarray/safe-casts]</span><span class="delimiter">: </span><span class="description">return a list of ndarray data types to which a provided ndarray data type can be safely cast.</span>
 
@@ -147,6 +148,8 @@ for ( i = 0; i < DTYPES.length; i++ ) {
 
 [@stdlib/array/convert-same]: https://github.com/stdlib-js/array/tree/main/convert-same
 
+[@stdlib/array/mostly-safe-casts]: https://github.com/stdlib-js/array/tree/main/mostly-safe-casts
+
 [@stdlib/array/same-kind-casts]: https://github.com/stdlib-js/array/tree/main/same-kind-casts
 
 [@stdlib/ndarray/safe-casts]: https://github.com/stdlib-js/ndarray-safe-casts