Add overflow/underflow examples

kgryte · kgryte · commit 07d036fbab21 · 2018-05-16T02:05:39.000-07:00
diff --git a/lib/node_modules/@stdlib/stats/incr/mprod/README.md b/lib/node_modules/@stdlib/stats/incr/mprod/README.md
@@ -69,6 +69,56 @@ p = accumulator();
 // returns 105.0
 ```
 
+Under certain conditions, overflow may be transient.
+
+```javascript
+// Large values:
+var x = 5.0e+300;
+var y = 1.0e+300;
+
+// Tiny value:
+var z = 2.0e-302;
+
+// Initialize an accumulator:
+var accumulator = incrmprod( 3 );
+
+var p = accumulator( x );
+// returns 5.0e+300
+
+// Transient overflow:
+p = accumulator( y );
+// returns Infinity
+
+// Recover a finite result:
+p = accumulator( z );
+// returns 1.0e+299
+```
+
+Similarly, under certain conditions, underflow may be transient.
+
+```javascript
+// Tiny values:
+var x = 4.0e-302;
+var y = 9.0e-303;
+
+// Large value:
+var z = 2.0e+300;
+
+// Initialize an accumulator:
+var accumulator = incrmprod( 3 );
+
+var p = accumulator( x );
+// returns 4.0e-302
+
+// Transient underflow:
+p = accumulator( y );
+// returns 0.0
+
+// Recover a non-zero result:
+p = accumulator( z );
+// returns 7.2e-304
+```
+
 </section>
 
 <!-- /.usage -->
