Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2025-04-01)
+## Unreleased (2025-06-04)
 
 <section class="features">
 
@@ -22,6 +22,7 @@
 
 <details>
 
+-   [`8bf8f93`](https://github.com/stdlib-js/stdlib/commit/8bf8f93d8fe5b05cd7de8347abb65255ec3b06aa) - **docs:** change examples for `complex/float64/base/mul-add` [(#7191)](https://github.com/stdlib-js/stdlib/pull/7191) _(by Shabareesh Shetty)_
 -   [`a1e230f`](https://github.com/stdlib-js/stdlib/commit/a1e230f29297caa89880e9c194c615a0400fb7bc) - **chore:** clean up cppcheck-suppress comments _(by Karan Anand)_
 -   [`b957f93`](https://github.com/stdlib-js/stdlib/commit/b957f93bfacfa2b307db9b30a45fa48ce5b4488b) - **docs:** fix description _(by Athan Reines)_
 -   [`eb938ff`](https://github.com/stdlib-js/stdlib/commit/eb938fff22223cbbfb04568e30a4f62f8455d3bc) - **bench:** fix incomplete refactoring _(by Athan Reines)_
@@ -37,10 +38,11 @@
 
 ### Contributors
 
-A total of 2 people contributed to this release. Thank you to the following contributors:
+A total of 3 people contributed to this release. Thank you to the following contributors:
 
 -   Athan Reines
 -   Karan Anand
+-   Shabareesh Shetty
 
 </section>
 

CONTRIBUTORS

@@ -43,22 +43,26 @@ Dev Goel <135586571+corsairier@users.noreply.github.com>
 Dhanyabad behera <110620935+dhanyabad11@users.noreply.github.com>
 Dhruv Arvind Singh <154677013+DhruvArvindSingh@users.noreply.github.com>
 Dhruvil Mehta <68022411+dhruvilmehta@users.noreply.github.com>
+Dipjyoti Das <126075231+dipexplorer@users.noreply.github.com>
 Divyansh Seth <59174836+sethdivyansh@users.noreply.github.com>
 Dominic Lim <46486515+domlimm@users.noreply.github.com>
 Dominik Moritz <domoritz@gmail.com>
 Dorrin Sotoudeh <dorrinsotoudeh123@gmail.com>
 EuniceSim142 <77243938+EuniceSim142@users.noreply.github.com>
 Frank Kovacs <fran70kk@gmail.com>
 GK Bishnoi <gkishan1kyt@gmail.com>
+GURU PRASAD SHARMA <168292003+GURUPRASADSHARMA@users.noreply.github.com>
 Gaurav <gaurav70380@gmail.com>
 Gautam sharma <gautamkrishnasharma1@gmail.com>
+Girish Garg <garggirish2020@gmail.com>
 Golden Kumar <103646877+AuenKr@users.noreply.github.com>
 Gunj Joshi <gunjjoshi8372@gmail.com>
 Gururaj Gurram <gururajgurram1512@gmail.com>
 Haroon Rasheed <51189276+haroon26@users.noreply.github.com>
-Harsh <149176984+hrshya@users.noreply.github.com>
+Harsh <harshyadav6078@gmail.com>
 HarshaNP <96897754+GittyHarsha@users.noreply.github.com>
 Harshita Kalani <harshitakalani02@gmail.com>
+Hemang Choudhary <coehemang@gmail.com>
 Hemant M Mehta <92446645+hemantmm@users.noreply.github.com>
 Hridyanshu <124202756+HRIDYANSHU054@users.noreply.github.com>
 Jaimin Godhani <112328542+Jai0401@users.noreply.github.com>
@@ -75,16 +79,20 @@ Jordan Gallivan <115050475+Jordan-Gallivan@users.noreply.github.com>
 Joris Labie <joris.labie1@gmail.com>
 Justin Dennison <justin1dennison@gmail.com>
 Justyn Shelby <96994781+ShelbyJustyn@users.noreply.github.com>
-Karan Anand <119553199+anandkaranubc@users.noreply.github.com>
+Karan Anand <anandkarancompsci@gmail.com>
+Karan Vasudevamurthy <karanlvm123@gmail.com>
+Karan Yadav <77043443+karanBRAVO@users.noreply.github.com>
 Karthik Prakash <116057817+skoriop@users.noreply.github.com>
 Kaushikgtm <162317291+Kaushikgtm@users.noreply.github.com>
 Kavyansh-Bagdi <153486713+Kavyansh-Bagdi@users.noreply.github.com>
 Kohantika Nath <145763549+kohantikanath@users.noreply.github.com>
 Krishnam Agarwal <83017176+888krishnam@users.noreply.github.com>
 Krishnendu Das <86651039+itskdhere@users.noreply.github.com>
 Kshitij-Dale <152467202+Kshitij-Dale@users.noreply.github.com>
+Lalit Narayan Yadav <162928571+LalitNarayanYadav@users.noreply.github.com>
 Lovelin Dhoni J B <100030865+lovelindhoni@users.noreply.github.com>
 MANI <77221000+Eternity0207@users.noreply.github.com>
+Mahfuza Humayra Mohona <mhmohona@gmail.com>
 Manik Sharma <maniksharma.rke@gmail.com>
 Manvith M <148960168+manvith2003@users.noreply.github.com>
 Marcus Fantham <mfantham@users.noreply.github.com>
@@ -95,10 +103,14 @@ Mohammad Bin Aftab <48010758+MohammadBinAftab@users.noreply.github.com>
 Mohammad Kaif <mdkaifprofession@gmail.com>
 Momtchil Momtchev <momtchil@momtchev.com>
 Muhammad Haris <harriskhan047@outlook.com>
+Muhammad Taaha Tariq <166188821+Taaha-Tariq@users.noreply.github.com>
+Muhmmad Saad <106260977+saad-imran-dev@users.noreply.github.com>
 Naresh Jagadeesan <naresh.naresh000@gmail.com>
 Naveen Kumar <stupiddint@gmail.com>
 Neeraj Pathak <neerajrpathak710@gmail.com>
+NirvedMishra <139633597+NirvedMishra@users.noreply.github.com>
 Nishant Shinde <97207366+nishant-s7@users.noreply.github.com>
+Nishant singh <38534128+Nishantsingh11@users.noreply.github.com>
 Nishchay Rajput <121144841+NishchayRajput@users.noreply.github.com>
 Nithin Katta <88046362+nithinkatta@users.noreply.github.com>
 Nourhan Hasan <109472010+TheNourhan@users.noreply.github.com>
@@ -111,8 +123,10 @@ Prajwal Kulkarni <prajwalkulkarni76@gmail.com>
 Pranav Goswami <pranavchiku11@gmail.com>
 Pranjal Jha <97080887+PraneGIT@users.noreply.github.com>
 Prashant Kumar Yadav <144602492+0PrashantYadav0@users.noreply.github.com>
+PrathamBhamare <164445568+PrathamBhamare@users.noreply.github.com>
 Pratik Singh <97464067+Pratik772846@users.noreply.github.com>
 Pratyush Kumar Chouhan <pratyushkumar0308@gmail.com>
+Pravesh Kunwar <praveshkunwar04@gmail.com>
 Priyansh Prajapati <88396544+itsspriyansh@users.noreply.github.com>
 Priyanshu Agarwal <113460573+AgPriyanshu18@users.noreply.github.com>
 Pulkit Gupta <65711278+pulkitgupta2@users.noreply.github.com>
@@ -126,12 +140,14 @@ Rishav <115060907+rishav2404@users.noreply.github.com>
 Rishav Tarway <rishavtarway@gmail.com>
 Robert Gislason <gztown2216@yahoo.com>
 Roman Stetsyk <25715951+romanstetsyk@users.noreply.github.com>
+Rupa <102663541+Rupa-Rd@users.noreply.github.com>
 Rutam Kathale <138517416+performant23@users.noreply.github.com>
 Ruthwik Chikoti <145591715+ruthwikchikoti@users.noreply.github.com>
 Ryan Seal <splrk@users.noreply.github.com>
 Rylan Yang <137365285+rylany27@users.noreply.github.com>
 SAHIL KUMAR <168997976+sahilk45@users.noreply.github.com>
 SHIVAM YADAV <120725381+Shivam-1827@users.noreply.github.com>
+Sachin Raj <120590207+schnrj@users.noreply.github.com>
 Sahil Goyal <87982509+sahil20021008@users.noreply.github.com>
 Sai Avinash <120403424+nasarobot@users.noreply.github.com>
 Sai Srikar Dumpeti <80447788+the-r3aper7@users.noreply.github.com>
@@ -152,14 +168,19 @@ Spandan Barve <contact@marsian.dev>
 Stephannie Jiménez Gacha <steff456@hotmail.com>
 Suhaib Ilahi <suhaib.elahi87@gmail.com>
 Suraj Kumar <125961509+kumarsuraj212003@users.noreply.github.com>
+Swapnil Hajare <69076366+Swapnil-2502@users.noreply.github.com>
 Tanishq Ahuja <68651083+TheGEN1U5@users.noreply.github.com>
 Tirtadwipa Manunggal <tirtadwipa.manunggal@gmail.com>
 Tudor Pagu <104032457+tudor-pagu@users.noreply.github.com>
 Tufailahmed Bargir <142114244+Tufailahmed-Bargir@users.noreply.github.com>
+Tushar Bhardwaj <155543597+TusharBhardwaj441@users.noreply.github.com>
+Uday Kakade <141299403+udaykakade25@users.noreply.github.com>
+Ujjwal Kirti <64329707+ujjwalkirti@users.noreply.github.com>
 Utkarsh <http://utkarsh11105@gmail.com>
 Utkarsh Raj <rajutkarsh2505@gmail.com>
 UtkershBasnet <119008923+UtkershBasnet@users.noreply.github.com>
 Vaibhav Patel <98279986+noobCoderVP@users.noreply.github.com>
+Vara Rahul Rajana <123227543+rajanarahul93@users.noreply.github.com>
 Varad Gupta <varadgupta21@gmail.com>
 Vinit Pandit <106718914+MeastroZI@users.noreply.github.com>
 Vivek Maurya <vm8118134@gmail.com>
@@ -168,12 +189,15 @@ Yaswanth Kosuru <116426380+yaswanthkosuru@users.noreply.github.com>
 Yernar Yergaziyev <yernar.yergaziyev@erg.kz>
 Yugal Kaushik <yugalkaushik14@gmail.com>
 Yuvi Mittal <128018763+yuvi-mittal@users.noreply.github.com>
+devshree-bhati <147095250+devshree-bhati@users.noreply.github.com>
 ditsu <170345142+ditsus@users.noreply.github.com>
 ekambains <bainsinbusiness@gmail.com>
 fadiothman22 <48636283+fadiothman22@users.noreply.github.com>
+iraandrushko <71790513+iraandrushko@users.noreply.github.com>
 lohithganni <116790357+lohithganni@users.noreply.github.com>
 olenkabilonizhka <62379231+olenkabilonizhka@users.noreply.github.com>
 pranav-1720 <123018993+pranav-1720@users.noreply.github.com>
 rahulrangers <127782777+rahulrangers@users.noreply.github.com>
 rainn <88160429+AmCodesLame@users.noreply.github.com>
 rei2hu <reimu@reimu.ws>
+zhanggy <geodaoyu@foxmail.com>

README.md

@@ -171,22 +171,18 @@ The function supports the following parameters:
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var Complex128 = require( '@stdlib/complex-float64-ctor' );
-var discreteUniform = require( '@stdlib/random-base-discrete-uniform' ).factory;
+var Complex128Array = require( '@stdlib/array-complex128' );
+var discreteUniform = require( '@stdlib/random-array-discrete-uniform' );
+var logEachMap = require( '@stdlib/console-log-each-map' );
 var muladd = require( '@stdlib/complex-float64-base-mul-add' );
 
-var rand = discreteUniform( -50, 50 );
-
-var z1;
-var z2;
-var z3;
-var i;
-for ( i = 0; i < 100; i++ ) {
-    z1 = new Complex128( rand(), rand() );
-    z2 = new Complex128( rand(), rand() );
-    z3 = muladd( z1, z2, z2 );
-    console.log( '(%s)*(%s) + (%s) = %s', z1.toString(), z2.toString(), z2.toString(), z3.toString() );
-}
+// Generate arrays of random values:
+var z1 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
+var z2 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
+var z3 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
+
+// Perform element-wise computation:
+logEachMap( '( (%s) * (%s) ) + (%s) = %s', z1, z2, z3, muladd );
 ```
 
 </section>

examples/index.js

@@ -18,19 +18,15 @@
 
 'use strict';
 
-var Complex128 = require( '@stdlib/complex-float64-ctor' );
-var discreteUniform = require( '@stdlib/random-base-discrete-uniform' ).factory;
+var Complex128Array = require( '@stdlib/array-complex128' );
+var discreteUniform = require( '@stdlib/random-array-discrete-uniform' );
+var logEachMap = require( '@stdlib/console-log-each-map' );
 var muladd = require( './../lib' );
 
-var rand = discreteUniform( -50, 50 );
+// Generate arrays of random values:
+var z1 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
+var z2 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
+var z3 = new Complex128Array( discreteUniform( 200, -50, 50 ) );
 
-var z1;
-var z2;
-var z3;
-var i;
-for ( i = 0; i < 100; i++ ) {
-	z1 = new Complex128( rand(), rand() );
-	z2 = new Complex128( rand(), rand() );
-	z3 = muladd( z1, z2, z2 );
-	console.log( '(%s)*(%s) + (%s) = %s', z1.toString(), z2.toString(), z2.toString(), z3.toString() );
-}
+// Perform element-wise computation:
+logEachMap( '( (%s) * (%s) ) + (%s) = %s', z1, z2, z3, muladd );

package.json

@@ -50,12 +50,14 @@
     "@stdlib/utils-library-manifest": "^0.2.2"
   },
   "devDependencies": {
+    "@stdlib/array-complex128": "^0.3.0",
     "@stdlib/array-float64": "^0.2.2",
     "@stdlib/assert-is-method": "^0.2.2",
     "@stdlib/assert-is-same-float64array": "^0.2.2",
+    "@stdlib/console-log-each-map": "github:stdlib-js/console-log-each-map#main",
     "@stdlib/math-base-assert-is-nan": "^0.2.2",
+    "@stdlib/random-array-discrete-uniform": "^0.2.1",
     "@stdlib/random-array-uniform": "^0.2.1",
-    "@stdlib/random-base-discrete-uniform": "^0.2.1",
     "@stdlib/random-base-uniform": "^0.2.1",
     "@stdlib/utils-try-require": "^0.2.2",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",