X-Git-Url: https://gitweb.michael.orlitzky.com/?p=dunshire.git;a=blobdiff_plain;f=test%2Frandomgen.py;h=bfc70f3cf320031f6c8b7047ebdf9746288c0882;hp=8c5ebfcbbfa24dd4e99929940bb56424839fbf87;hb=0274de467062ab29d2a41d2a91ec0b28fcd95c8d;hpb=2b44481f8a79cbab75ddc0f73eea813b66e17d62

diff --git a/test/randomgen.py b/test/randomgen.py
index 8c5ebfc..bfc70f3 100644
--- a/test/randomgen.py
+++ b/test/randomgen.py
@@ -9,9 +9,13 @@ from dunshire.cones import NonnegativeOrthant, IceCream
 from dunshire.games import SymmetricLinearGame
 from dunshire.matrices import (append_col, append_row, identity)
 
-MAX_COND = 100
+MAX_COND = 125
 """
-The maximum condition number of a randomly-generated game.
+The maximum condition number of a randomly-generated game. When the
+condition number of the games gets too high, we start to see
+:class:`PoorScalingException` being thrown. There's no science to
+choosing the upper bound -- it got lowered until those exceptions
+stopped popping up. It's at ``125`` because ``129`` doesn't work.
 """
 
 RANDOM_MAX = 10
@@ -29,8 +33,8 @@ def random_scalar():
     -------
 
     float
-        A random real number between ``-RANDOM_MAX`` and ``RANDOM_MAX``,
-        inclusive.
+        A random real number between negative and positive
+        :const:`RANDOM_MAX`, inclusive.
 
     Examples
     --------
@@ -50,8 +54,8 @@ def random_nn_scalar():
     -------
 
     float
-        A random nonnegative real number between zero and ``RANDOM_MAX``,
-        inclusive.
+        A random nonnegative real number between zero and
+        :const:`RANDOM_MAX`, inclusive.
 
     Examples
     --------
@@ -71,7 +75,8 @@ def random_natural():
     -------
 
     int
-        A random natural number between ``1`` and ``RANDOM_MAX`` inclusive.
+        A random natural number between ``1`` and :const:`RANDOM_MAX`,
+        inclusive.
 
     Examples
     --------
@@ -101,8 +106,8 @@ def random_matrix(row_count, column_count=None):
     -------
 
     matrix
-        A new matrix whose entries are random floats chosen uniformly from
-        the interval ``[-RANDOM_MAX, RANDOM_MAX]``.
+        A new matrix whose entries are random floats chosen uniformly
+        between negative and positive :const:`RANDOM_MAX`.
 
     Examples
     --------
@@ -184,7 +189,7 @@ def random_diagonal_matrix(dims):
 
     matrix
         A new matrix whose diagonal entries are random floats chosen
-        using func:`random_scalar` and whose off-diagonal entries are
+        using :func:`random_scalar` and whose off-diagonal entries are
         zero.
 
     Examples
@@ -267,7 +272,7 @@ def random_lyapunov_like_icecream(dims):
     matrix
         A new matrix, Lyapunov-like on the ice-cream cone in ``dims``
         dimensions, whose free entries are random floats chosen uniformly
-        from the interval ``[-RANDOM_MAX, RANDOM_MAX]``.
+        between negative and positive :const:`RANDOM_MAX`.
 
     References
     ----------
@@ -306,7 +311,7 @@ def random_orthant_game():
     We generate each of ``L``, ``K``, ``e1``, and ``e2`` randomly within
     the constraints of the nonnegative orthant, and then construct a
     game from them. The process is repeated until we generate a game with
-    a condition number under ``MAX_COND``.
+    a condition number under :const:`MAX_COND`.
 
     Returns
     -------
@@ -341,7 +346,7 @@ def random_icecream_game():
     We generate each of ``L``, ``K``, ``e1``, and ``e2`` randomly within
     the constraints of the ice-cream cone, and then construct a game
     from them. The process is repeated until we generate a game with a
-    condition number under ``MAX_COND``.
+    condition number under :const:`MAX_COND`.
 
     Returns
     -------
@@ -390,14 +395,17 @@ def random_ll_orthant_game():
     to have a :func:`random_diagonal_matrix` as its operator. Such
     things are Lyapunov-like on the nonnegative orthant. That process is
     repeated until the condition number of the resulting game is within
-    ``MAX_COND``.
+    :const:`MAX_COND`.
 
     Returns
     -------
 
     SymmetricLinearGame
-        A random game over some nonnegative orthant whose ``payoff`` method
-        is based on a Lyapunov-like ``L`` operator.
+
+        A random game over some nonnegative orthant whose
+        :meth:`dunshire.games.SymmetricLinearGame.payoff` method is
+        based on a Lyapunov-like
+        :meth:`dunshire.games.SymmetricLinearGame.L` operator.
 
     Examples
     --------
@@ -428,14 +436,16 @@ def random_ll_icecream_game():
     We first construct a :func:`random_icecream_game` and then modify it
     to have a :func:`random_lyapunov_like_icecream` operator. That
     process is repeated until the condition number of the resulting game
-    is within ``MAX_COND``.
+    is within :const:`MAX_COND`.
 
     Returns
     -------
 
     SymmetricLinearGame
-        A random game over some ice-cream cone whose ``payoff`` method
-        is based on a Lyapunov-like ``L`` operator.
+        A random game over some ice-cream cone whose
+        :meth:`dunshire.games.SymmetricLinearGame.payoff` method
+        is based on a Lyapunov-like
+        :meth:`dunshire.games.SymmetricLinearGame.L` operator.
 
     Examples
     --------
@@ -467,14 +477,16 @@ def random_positive_orthant_game():
     We first construct a :func:`random_orthant_game` and then modify it
     to have a :func:`random_nonnegative_matrix` as its operator. That
     process is repeated until the condition number of the resulting game
-    is within ``MAX_COND``.
+    is within :const:`MAX_COND`.
 
     Returns
     -------
 
     SymmetricLinearGame
-        A random game over some nonnegative orthant whose ``payoff`` method
-        is based on a positive ``L`` operator.
+        A random game over some nonnegative orthant whose
+        :meth:`dunshire.games.SymmetricLinearGame.payoff` method
+        is based on a positive
+        :meth:`dunshire.games.SymmetricLinearGame.L` operator.
 
     Examples
     --------