X-Git-Url: http://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=dunshire%2Fgames.py;h=7dd280651fe954c6c1550a962bb2637f7122148a;hb=1567b13174de89884c7cbdd06b2f87bce63ed83e;hp=437b53336ab5791cbf010ff15aa5f78509ea57c0;hpb=e297d8d0471068f10d4953570047d6770ceeb7be;p=dunshire.git
diff --git a/dunshire/games.py b/dunshire/games.py
index 437b533..7dd2806 100644
--- a/dunshire/games.py
+++ b/dunshire/games.py
@@ -4,15 +4,15 @@ Symmetric linear games and their solutions.
This module contains the main :class:`SymmetricLinearGame` class that
knows how to solve a linear game.
"""
-
from cvxopt import matrix, printing, solvers
from .cones import CartesianProduct
from .errors import GameUnsolvableException, PoorScalingException
from .matrices import (append_col, append_row, condition_number, identity,
- inner_product)
-from . import options
+ inner_product, norm, specnorm)
+from .options import ABS_TOL, FLOAT_FORMAT, DEBUG_FLOAT_FORMAT
+
+printing.options['dformat'] = FLOAT_FORMAT
-printing.options['dformat'] = options.FLOAT_FORMAT
class Solution:
"""
@@ -23,7 +23,7 @@ class Solution:
--------
>>> print(Solution(10, matrix([1,2]), matrix([3,4])))
- Game value: 10.0000000
+ Game value: 10.000...
Player 1 optimal:
[ 1]
[ 2]
@@ -179,11 +179,15 @@ class SymmetricLinearGame:
----------
L : list of list of float
- A matrix represented as a list of ROWS. This representation
- agrees with (for example) SageMath and NumPy, but not with CVXOPT
- (whose matrix constructor accepts a list of columns).
-
- K : :class:`SymmetricCone`
+ A matrix represented as a list of **rows**. This representation
+ agrees with (for example) `SageMath `_
+ and `NumPy `_, but not with CVXOPT (whose
+ matrix constructor accepts a list of columns). In reality, ``L``
+ can be any iterable type of the correct length; however, you
+ should be extremely wary of the way we interpret anything other
+ than a list of rows.
+
+ K : dunshire.cones.SymmetricCone
The symmetric cone instance over which the game is played.
e1 : iterable float
@@ -220,8 +224,7 @@ class SymmetricLinearGame:
[ 1],
e2 = [ 1]
[ 2]
- [ 3],
- Condition((L, K, e1, e2)) = 31.834...
+ [ 3]
Lists can (and probably should) be used for every argument::
@@ -239,8 +242,7 @@ class SymmetricLinearGame:
e1 = [ 1]
[ 1],
e2 = [ 1]
- [ 1],
- Condition((L, K, e1, e2)) = 1.707...
+ [ 1]
The points ``e1`` and ``e2`` can also be passed as some other
enumerable type (of the correct length) without much harm, since
@@ -262,8 +264,7 @@ class SymmetricLinearGame:
e1 = [ 1]
[ 1],
e2 = [ 1]
- [ 1],
- Condition((L, K, e1, e2)) = 1.707...
+ [ 1]
However, ``L`` will always be intepreted as a list of rows, even
if it is passed as a :class:`cvxopt.base.matrix` which is
@@ -284,8 +285,7 @@ class SymmetricLinearGame:
e1 = [ 1]
[ 1],
e2 = [ 1]
- [ 1],
- Condition((L, K, e1, e2)) = 6.073...
+ [ 1]
>>> L = cvxopt.matrix(L)
>>> print(L)
[ 1 3]
@@ -300,8 +300,7 @@ class SymmetricLinearGame:
e1 = [ 1]
[ 1],
e2 = [ 1]
- [ 1],
- Condition((L, K, e1, e2)) = 6.073...
+ [ 1]
"""
def __init__(self, L, K, e1, e2):
@@ -323,6 +322,8 @@ class SymmetricLinearGame:
if not self._e2 in K:
raise ValueError('the point e2 must lie in the interior of K')
+ # Initial value of cached method.
+ self._L_specnorm_value = None
def __str__(self):
@@ -333,17 +334,15 @@ class SymmetricLinearGame:
' L = {:s},\n' \
' K = {!s},\n' \
' e1 = {:s},\n' \
- ' e2 = {:s},\n' \
- ' Condition((L, K, e1, e2)) = {:f}.'
- indented_L = '\n '.join(str(self._L).splitlines())
- indented_e1 = '\n '.join(str(self._e1).splitlines())
- indented_e2 = '\n '.join(str(self._e2).splitlines())
+ ' e2 = {:s}'
+ indented_L = '\n '.join(str(self.L()).splitlines())
+ indented_e1 = '\n '.join(str(self.e1()).splitlines())
+ indented_e2 = '\n '.join(str(self.e2()).splitlines())
return tpl.format(indented_L,
- str(self._K),
+ str(self.K()),
indented_e1,
- indented_e2,
- self.condition())
+ indented_e2)
def L(self):
@@ -466,8 +465,8 @@ class SymmetricLinearGame:
The payoff operator takes pairs of strategies to a real
number. For example, if player one's strategy is :math:`x` and
player two's strategy is :math:`y`, then the associated payoff
- is :math:`\left\langle L\left(x\right),y \right\rangle` \in
- \mathbb{R}. Here, :math:`L` denotes the same linear operator as
+ is :math:`\left\langle L\left(x\right),y \right\rangle \in
+ \mathbb{R}`. Here, :math:`L` denotes the same linear operator as
:meth:`L`. This method computes the payoff given the two
players' strategies.
@@ -494,7 +493,6 @@ class SymmetricLinearGame:
strategies::
>>> from dunshire import *
- >>> from dunshire.options import ABS_TOL
>>> K = NonnegativeOrthant(3)
>>> L = [[1,-5,-15],[-1,2,-3],[-12,-15,1]]
>>> e1 = [1,1,1]
@@ -503,7 +501,7 @@ class SymmetricLinearGame:
>>> soln = SLG.solution()
>>> x_bar = soln.player1_optimal()
>>> y_bar = soln.player2_optimal()
- >>> abs(SLG.payoff(x_bar, y_bar) - soln.game_value()) < ABS_TOL
+ >>> SLG.payoff(x_bar, y_bar) == soln.game_value()
True
"""
@@ -581,12 +579,13 @@ class SymmetricLinearGame:
return matrix(0, (self.dimension(), 1), tc='d')
- def _A(self):
- """
+ def A(self):
+ r"""
Return the matrix ``A`` used in our CVXOPT construction.
- This matrix ``A`` appears on the right-hand side of ``Ax = b``
- in the statement of the CVXOPT conelp program.
+ This matrix :math:`A` appears on the right-hand side of
+ :math:`Ax = b` in the `statement of the CVXOPT conelp program
+ `_.
.. warning::
@@ -598,7 +597,7 @@ class SymmetricLinearGame:
matrix
A ``1``-by-``(1 + self.dimension())`` row vector. Its first
- entry is zero, and the rest are the entries of ``e2``.
+ entry is zero, and the rest are the entries of :meth:`e2`.
Examples
--------
@@ -609,21 +608,22 @@ class SymmetricLinearGame:
>>> e1 = [1,1,1]
>>> e2 = [1,2,3]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._A())
+ >>> print(SLG.A())
[0.0000000 1.0000000 2.0000000 3.0000000]
"""
- return matrix([0, self._e2], (1, self.dimension() + 1), 'd')
+ return matrix([0, self.e2()], (1, self.dimension() + 1), 'd')
- def _G(self):
+ def G(self):
r"""
Return the matrix ``G`` used in our CVXOPT construction.
- Thus matrix ``G`` appears on the left-hand side of ``Gx + s = h``
- in the statement of the CVXOPT conelp program.
+ Thus matrix :math:`G` appears on the left-hand side of :math:`Gx
+ + s = h` in the `statement of the CVXOPT conelp program
+ `_.
.. warning::
@@ -645,7 +645,7 @@ class SymmetricLinearGame:
>>> e1 = [1,2,3]
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._G())
+ >>> print(SLG.G())
[ 0.0000000 -1.0000000 0.0000000 0.0000000]
[ 0.0000000 0.0000000 -1.0000000 0.0000000]
[ 0.0000000 0.0000000 0.0000000 -1.0000000]
@@ -657,15 +657,17 @@ class SymmetricLinearGame:
"""
identity_matrix = identity(self.dimension())
return append_row(append_col(self._zero(), -identity_matrix),
- append_col(self._e1, -self._L))
+ append_col(self.e1(), -self.L()))
- def _c(self):
- """
+ def c(self):
+ r"""
Return the vector ``c`` used in our CVXOPT construction.
- The column vector ``c`` appears in the objective function
- value ```` in the statement of the CVXOPT conelp program.
+ The column vector :math:`c` appears in the objective function
+ value :math:`\left\langle c,x \right\rangle` in the `statement
+ of the CVXOPT conelp program
+ `_.
.. warning::
@@ -676,7 +678,7 @@ class SymmetricLinearGame:
-------
matrix
- A ``self.dimension()``-by-``1`` column vector.
+ A :meth:`dimension`-by-``1`` column vector.
Examples
--------
@@ -687,7 +689,7 @@ class SymmetricLinearGame:
>>> e1 = [1,2,3]
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._c())
+ >>> print(SLG.c())
[-1.0000000]
[ 0.0000000]
[ 0.0000000]
@@ -698,12 +700,13 @@ class SymmetricLinearGame:
return matrix([-1, self._zero()])
- def _C(self):
+ def C(self):
"""
Return the cone ``C`` used in our CVXOPT construction.
- The cone ``C`` is the cone over which the conelp program takes
- place.
+ This is the cone over which the `CVXOPT conelp program
+ `_
+ takes place.
Returns
-------
@@ -720,7 +723,7 @@ class SymmetricLinearGame:
>>> e1 = [1,2,3]
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._C())
+ >>> print(SLG.C())
Cartesian product of dimension 6 with 2 factors:
* Nonnegative orthant in the real 3-space
* Nonnegative orthant in the real 3-space
@@ -728,12 +731,13 @@ class SymmetricLinearGame:
"""
return CartesianProduct(self._K, self._K)
- def _h(self):
- """
+ def h(self):
+ r"""
Return the ``h`` vector used in our CVXOPT construction.
- The ``h`` vector appears on the right-hand side of :math:`Gx + s
- = h` in the statement of the CVXOPT conelp program.
+ The :math:`h` vector appears on the right-hand side of :math:`Gx
+ + s = h` in the `statement of the CVXOPT conelp program
+ `_.
.. warning::
@@ -755,7 +759,7 @@ class SymmetricLinearGame:
>>> e1 = [1,2,3]
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._h())
+ >>> print(SLG.h())
[0.0000000]
[0.0000000]
[0.0000000]
@@ -770,12 +774,13 @@ class SymmetricLinearGame:
@staticmethod
- def _b():
- """
+ def b():
+ r"""
Return the ``b`` vector used in our CVXOPT construction.
- The vector ``b`` appears on the right-hand side of :math:`Ax =
- b` in the statement of the CVXOPT conelp program.
+ The vector :math:`b` appears on the right-hand side of :math:`Ax
+ = b` in the `statement of the CVXOPT conelp program
+ `_.
This method is static because the dimensions and entries of
``b`` are known beforehand, and don't depend on any other
@@ -801,7 +806,7 @@ class SymmetricLinearGame:
>>> e1 = [1,2,3]
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> print(SLG._b())
+ >>> print(SLG.b())
[1.0000000]
@@ -809,6 +814,188 @@ class SymmetricLinearGame:
return matrix([1], tc='d')
+ def player1_start(self):
+ """
+ Return a feasible starting point for player one.
+
+ This starting point is for the CVXOPT formulation and not for
+ the original game. The basic premise is that if you scale
+ :meth:`e2` by the reciprocal of its squared norm, then you get a
+ point in :meth:`K` that makes a unit inner product with
+ :meth:`e2`. We then get to choose the primal objective function
+ value such that the constraint involving :meth:`L` is satisfied.
+
+ Returns
+ -------
+
+ dict
+ A dictionary with two keys, ``'x'`` and ``'s'``, which
+ contain the vectors of the same name in the CVXOPT primal
+ problem formulation.
+
+ The vector ``x`` consists of the primal objective function
+ value concatenated with the strategy (for player one) that
+ achieves it. The vector ``s`` is essentially a dummy
+ variable, and is computed from the equality constraing in
+ the CVXOPT primal problem.
+
+ """
+ p = self.e2() / (norm(self.e2()) ** 2)
+ dist = self.K().ball_radius(self.e1())
+ nu = - self._L_specnorm()/(dist*norm(self.e2()))
+ x = matrix([nu, p], (self.dimension() + 1, 1))
+ s = - self.G()*x
+
+ return {'x': x, 's': s}
+
+
+ def player2_start(self):
+ """
+ Return a feasible starting point for player two.
+
+ This starting point is for the CVXOPT formulation and not for
+ the original game. The basic premise is that if you scale
+ :meth:`e1` by the reciprocal of its squared norm, then you get a
+ point in :meth:`K` that makes a unit inner product with
+ :meth:`e1`. We then get to choose the dual objective function
+ value such that the constraint involving :meth:`L` is satisfied.
+
+ Returns
+ -------
+
+ dict
+ A dictionary with two keys, ``'y'`` and ``'z'``, which
+ contain the vectors of the same name in the CVXOPT dual
+ problem formulation.
+
+ The ``1``-by-``1`` vector ``y`` consists of the dual
+ objective function value. The last :meth:`dimension` entries
+ of the vector ``z`` contain the strategy (for player two)
+ that achieves it. The remaining entries of ``z`` are
+ essentially dummy variables, computed from the equality
+ constraint in the CVXOPT dual problem.
+
+ """
+ q = self.e1() / (norm(self.e1()) ** 2)
+ dist = self.K().ball_radius(self.e2())
+ omega = self._L_specnorm()/(dist*norm(self.e1()))
+ y = matrix([omega])
+ z2 = q
+ z1 = y*self.e2() - self.L().trans()*z2
+ z = matrix([z1, z2], (self.dimension()*2, 1))
+
+ return {'y': y, 'z': z}
+
+
+ def _L_specnorm(self):
+ """
+ Compute the spectral norm of :meth:`L` and cache it.
+
+ The spectral norm of the matrix :meth:`L` is used in a few
+ places. Since it can be expensive to compute, we want to cache
+ its value. That is not possible in :func:`specnorm`, which lies
+ outside of a class, so this is the place to do it.
+
+ Returns
+ -------
+
+ float
+ A nonnegative real number; the largest singular value of
+ the matrix :meth:`L`.
+
+ Examples
+ --------
+
+ >>> from dunshire import *
+ >>> from dunshire.matrices import specnorm
+ >>> L = [[1,2],[3,4]]
+ >>> K = NonnegativeOrthant(2)
+ >>> e1 = [1,1]
+ >>> e2 = e1
+ >>> SLG = SymmetricLinearGame(L,K,e1,e2)
+ >>> specnorm(SLG.L()) == SLG._L_specnorm()
+ True
+
+ """
+ if self._L_specnorm_value is None:
+ self._L_specnorm_value = specnorm(self.L())
+ return self._L_specnorm_value
+
+
+ def tolerance_scale(self, solution):
+ r"""
+ Return a scaling factor that should be applied to :const:`ABS_TOL`
+ for this game.
+
+ When performing certain comparisons, the default tolerance
+ :const:`ABS_TOL` may not be appropriate. For example, if we expect
+ ``x`` and ``y`` to be within :const:`ABS_TOL` of each other,
+ than the inner product of ``L*x`` and ``y`` can be as far apart
+ as the spectral norm of ``L`` times the sum of the norms of
+ ``x`` and ``y``. Such a comparison is made in :meth:`solution`,
+ and in many of our unit tests.
+
+ The returned scaling factor found from the inner product
+ mentioned above is
+
+ .. math::
+
+ \left\lVert L \right\rVert_{2}
+ \left( \left\lVert \bar{x} \right\rVert
+ + \left\lVert \bar{y} \right\rVert
+ \right),
+
+ where :math:`\bar{x}` and :math:`\bar{y}` are optimal solutions
+ for players one and two respectively. This scaling factor is not
+ formally justified, but attempting anything smaller leads to
+ test failures.
+
+ .. warning::
+
+ Optimal solutions are not unique, so the scaling factor
+ obtained from ``solution`` may not work when comparing other
+ solutions.
+
+ Parameters
+ ----------
+
+ solution : Solution
+ A solution of this game, used to obtain the norms of the
+ optimal strategies.
+
+ Returns
+ -------
+
+ float
+ A scaling factor to be multiplied by :const:`ABS_TOL` when
+ making comparisons involving solutions of this game.
+
+ Examples
+ --------
+
+ The spectral norm of ``L`` in this case is around ``5.464``, and
+ the optimal strategies both have norm one, so we expect the
+ tolerance scale to be somewhere around ``2 * 5.464``, or
+ ``10.929``::
+
+ >>> from dunshire import *
+ >>> L = [[1,2],[3,4]]
+ >>> K = NonnegativeOrthant(2)
+ >>> e1 = [1,1]
+ >>> e2 = e1
+ >>> SLG = SymmetricLinearGame(L,K,e1,e2)
+ >>> SLG.tolerance_scale(SLG.solution())
+ 10.929...
+
+ """
+ norm_p1_opt = norm(solution.player1_optimal())
+ norm_p2_opt = norm(solution.player2_optimal())
+ scale = self._L_specnorm()*(norm_p1_opt + norm_p2_opt)
+
+ # Don't return anything smaller than 1... we can't go below
+ # out "minimum tolerance."
+ return max(1, scale)
+
def solution(self):
"""
@@ -844,11 +1031,11 @@ class SymmetricLinearGame:
>>> e2 = [1,1,1]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
>>> print(SLG.solution())
- Game value: -6.1724138
+ Game value: -6.172...
Player 1 optimal:
- [ 0.551...]
- [-0.000...]
- [ 0.448...]
+ [0.551...]
+ [0.000...]
+ [0.448...]
Player 2 optimal:
[0.448...]
[0.000...]
@@ -864,7 +1051,7 @@ class SymmetricLinearGame:
>>> e2 = [4,5,6]
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
>>> print(SLG.solution())
- Game value: 0.0312500
+ Game value: 0.031...
Player 1 optimal:
[0.031...]
[0.062...]
@@ -900,8 +1087,8 @@ class SymmetricLinearGame:
>>> print(SLG.solution())
Game value: 18.767...
Player 1 optimal:
- [-0.000...]
- [ 9.766...]
+ [0.000...]
+ [9.766...]
Player 2 optimal:
[1.047...]
[0.000...]
@@ -918,27 +1105,68 @@ class SymmetricLinearGame:
>>> print(SLG.solution())
Game value: 24.614...
Player 1 optimal:
- [ 6.371...]
- [-0.000...]
+ [6.371...]
+ [0.000...]
Player 2 optimal:
[2.506...]
[0.000...]
+ This is another one that was difficult numerically, and caused
+ trouble even after we fixed the first two::
+
+ >>> from dunshire import *
+ >>> L = [[57.22233908627052301199, 41.70631373437460354126],
+ ... [83.04512571985074487202, 57.82581810406928468637]]
+ >>> K = NonnegativeOrthant(2)
+ >>> e1 = [7.31887017043399268346, 0.89744171905822367474]
+ >>> e2 = [0.11099824781179848388, 6.12564670639315345113]
+ >>> SLG = SymmetricLinearGame(L,K,e1,e2)
+ >>> print(SLG.solution())
+ Game value: 70.437...
+ Player 1 optimal:
+ [9.009...]
+ [0.000...]
+ Player 2 optimal:
+ [0.136...]
+ [0.000...]
+
+ And finally, here's one that returns an "optimal" solution, but
+ whose primal/dual objective function values are far apart::
+
+ >>> from dunshire import *
+ >>> L = [[ 6.49260076597376212248, -0.60528030227678542019],
+ ... [ 2.59896077096751731972, -0.97685530240286766457]]
+ >>> K = IceCream(2)
+ >>> e1 = [1, 0.43749513972645248661]
+ >>> e2 = [1, 0.46008379832200291260]
+ >>> SLG = SymmetricLinearGame(L, K, e1, e2)
+ >>> print(SLG.solution())
+ Game value: 11.596...
+ Player 1 optimal:
+ [ 1.852...]
+ [-1.852...]
+ Player 2 optimal:
+ [ 1.777...]
+ [-1.777...]
+
"""
try:
- opts = {'show_progress': options.VERBOSE}
- soln_dict = solvers.conelp(self._c(),
- self._G(),
- self._h(),
- self._C().cvxopt_dims(),
- self._A(),
- self._b(),
+ opts = {'show_progress': False}
+ soln_dict = solvers.conelp(self.c(),
+ self.G(),
+ self.h(),
+ self.C().cvxopt_dims(),
+ self.A(),
+ self.b(),
+ primalstart=self.player1_start(),
+ dualstart=self.player2_start(),
options=opts)
except ValueError as error:
if str(error) == 'math domain error':
# Oops, CVXOPT tried to take the square root of a
# negative number. Report some details about the game
# rather than just the underlying CVXOPT crash.
+ printing.options['dformat'] = DEBUG_FLOAT_FORMAT
raise PoorScalingException(self)
else:
raise error
@@ -963,39 +1191,47 @@ class SymmetricLinearGame:
# that CVXOPT is convinced the problem is infeasible (and that
# cannot happen).
if soln_dict['status'] in ['primal infeasible', 'dual infeasible']:
+ printing.options['dformat'] = DEBUG_FLOAT_FORMAT
raise GameUnsolvableException(self, soln_dict)
+ # For the game value, we could use any of:
+ #
+ # * p1_value
+ # * p2_value
+ # * (p1_value + p2_value)/2
+ # * the game payoff
+ #
+ # We want the game value to be the payoff, however, so it
+ # makes the most sense to just use that, even if it means we
+ # can't test the fact that p1_value/p2_value are close to the
+ # payoff.
+ payoff = self.payoff(p1_optimal, p2_optimal)
+ soln = Solution(payoff, p1_optimal, p2_optimal)
+
# The "optimal" and "unknown" results, we actually treat the
# same. Even if CVXOPT bails out due to numerical difficulty,
# it will have some candidate points in mind. If those
# candidates are good enough, we take them. We do the same
- # check (perhaps pointlessly so) for "optimal" results.
+ # check for "optimal" results.
#
# First we check that the primal/dual objective values are
- # close enough (one could be low by ABS_TOL, the other high by
- # it) because otherwise CVXOPT might return "unknown" and give
- # us two points in the cone that are nowhere near optimal.
- if abs(p1_value - p2_value) > 2*options.ABS_TOL:
+ # close enough because otherwise CVXOPT might return "unknown"
+ # and give us two points in the cone that are nowhere near
+ # optimal. And in fact, we need to ensure that they're close
+ # for "optimal" results, too, because we need to know how
+ # lenient to be in our testing.
+ #
+ if abs(p1_value - p2_value) > self.tolerance_scale(soln)*ABS_TOL:
+ printing.options['dformat'] = DEBUG_FLOAT_FORMAT
raise GameUnsolvableException(self, soln_dict)
# And we also check that the points it gave us belong to the
# cone, just in case...
if (p1_optimal not in self._K) or (p2_optimal not in self._K):
+ printing.options['dformat'] = DEBUG_FLOAT_FORMAT
raise GameUnsolvableException(self, soln_dict)
- # For the game value, we could use any of:
- #
- # * p1_value
- # * p2_value
- # * (p1_value + p2_value)/2
- # * the game payoff
- #
- # We want the game value to be the payoff, however, so it
- # makes the most sense to just use that, even if it means we
- # can't test the fact that p1_value/p2_value are close to the
- # payoff.
- payoff = self.payoff(p1_optimal, p2_optimal)
- return Solution(payoff, p1_optimal, p2_optimal)
+ return soln
def condition(self):
@@ -1007,8 +1243,12 @@ class SymmetricLinearGame:
can show up. We define the condition number of this game to be
the average of the condition numbers of ``G`` and ``A`` in the
CVXOPT construction. If the condition number of this game is
- high, then you can expect numerical difficulty (such as
- :class:`PoorScalingException`).
+ high, you can problems like :class:`PoorScalingException`.
+
+ Random testing shows that a condition number of around ``125``
+ is about the best that we can solve reliably. However, the
+ failures are intermittent, and you may get lucky with an
+ ill-conditioned game.
Returns
-------
@@ -1026,13 +1266,11 @@ class SymmetricLinearGame:
>>> e1 = [1]
>>> e2 = e1
>>> SLG = SymmetricLinearGame(L, K, e1, e2)
- >>> actual = SLG.condition()
- >>> expected = 1.8090169943749477
- >>> abs(actual - expected) < options.ABS_TOL
- True
+ >>> SLG.condition()
+ 1.809...
"""
- return (condition_number(self._G()) + condition_number(self._A()))/2
+ return (condition_number(self.G()) + condition_number(self.A()))/2
def dual(self):
@@ -1064,14 +1302,13 @@ class SymmetricLinearGame:
[ 3],
e2 = [ 1]
[ 1]
- [ 1],
- Condition((L, K, e1, e2)) = 44.476...
+ [ 1]
"""
- # We pass ``self._L`` right back into the constructor, because
+ # We pass ``self.L()`` right back into the constructor, because
# it will be transposed there. And keep in mind that ``self._K``
# is its own dual.
- return SymmetricLinearGame(self._L,
- self._K,
- self._e2,
- self._e1)
+ return SymmetricLinearGame(self.L(),
+ self.K(),
+ self.e2(),
+ self.e1())