Pylint cleanup for tests.

Remove two more defunct TODO items.

Print the game data along with every GameUnsolvableException.

Rename "xi" and "gamma" to "p" and "q" to avoid name clashes with CVXOPT.

Remove a few completed TODO items.

Separate and organize the various documentation sections.

Reorganize the test source code and doc building.

Move unit test code into its own file (unders test/ instead of src/).

Add another TODO.

Switch to Mathjax for the docs and finish the "Background" section.

Remove a completed TODO.

Enable doctesting of ReST docs with `make doctest`.

Do a bunch more README work.

Add one more TODO.

Tweak the makefile now that the imports work better.

Clean up a bit of the import mess.

Remove docs with `make clean`.

Do a bunch more work on the intro/background.

Begin writing the background/introduction material.

Locally disable another pylint warning to get clean again.

Fiddle with the pylint settings.

Make sure SymmetricPSD doesn't contain asymmetric matrices.

Eliminate some unused variables by slicing a tuple before assignment.

Fix two more pylint bad-variable-name warnings.

Add a .pylintrc file and fix a few warnings.

Add tests for Lyapunov games over the ice-cream cone.

Return CVXOPT matrices from the random matrix functions.

Test the dual game value of a Lyapunov game over the orthant.

Remove unused import.

Add another TODO for Lyapunov game tests.

Add a test for Lyapunov games over the orthant.

Add eigenvalues_re() to compute real parts of eigenvalues of any matrix.

Refactor the random matrix functions a bit.

Use syevr instead of syev for eigenvalues.

Add a test for the value of a positive operator on the nonnegative orthant.

Add tests for the orthogonality relationships of a game solution.

Fix (or cover up) a bunch of pylint warnings.

Add tests for the "translated" and "negated" games (from a few corollaries).

Remove a completed TODO.

Attempt to recover from "unknown" solutions.

Sometimes CVXOPT was coming back with "unknown" solutions that looked
pretty close to real solutions. Now, instead of failing immediately,
we check to see if the primal/dual objectives are within ABS_TOL of
each other, and whether or not the optimal solutions lie in the
cone. If they all do, we take that as our solution and succeed rather
than raising an exception.

This required the loosening of what it means to be in the cone. Before
this commit, a point needed to be "far" inside the cone (past the
tolerance). Now it can lie outside of the cone (but still within the
tolerance). This weakens the checks that we perform on e1 and e2, but
gives us an easy way to check the optimal strategies.

Set ABS_TOL to 1e-6 to fix solution comparisons in the test suite.

Remove a completed TODO.

Get rid of the contains_strict() methods and compare against ABS_TOL.

Since we're comparing floating point numbers in the containment tests,
we should be doing it against a tolerance. But then, it becomes
pointless to distinguish between strict and non-strict containment.
So, this commit leaves only the __contains__() methods and checks
against options.ABS_TOL.

Add two more tests for nonnegative scaling factors.

Add another TODO about failing tests.

Add a test for an example in the Gowda/Ravindran paper.

Replace one TODO with something else, and add a new one.

Remove a completed TODO.

Finish overhauling the docstrings to numpy format.

Switch the docs style of cones.py and update cartesian product containment.

The docs for cones.py have all been switched (roughly) to use the
numpy style. In the process, I noticed that cartesian product
containment was a lot weirder than it needs to be. The "point" that
the __contains__() and contains_strict() methods take is now a tuple
corresponding to the factors of the cartesian product.

Another shot at documenting the options module.

More "easy" docs work in matrices.py/options.py.

Rename the "symmetric_linear_game" module to "games".

Begin overhauling docs to numpy format.

Overwrite apidoc output by default for now.

Enable the napoleon Sphinx extension.

Move the README into doc/, add it to the Sphinx index, and tweak that.

Begin adding Sphinx crap for API doc generation.

Add another TODO item.

Add a unit test for the ice cream cone solution.

Add a first unit test to check that a solution is always obtained.

Transpose the input matrix "L" by default and document that fact.

Load unit tests from symmetric_linear_game in the test suite.

Add an options module to consolidate a few random "settings."

Fix pylint warnings in matrices.py.

Add one more variable exception to the `make lint` target.

Add an inner_product() for matrices.

Add another TODO item (find feasible starting points).

Test that vec() is a no-op on vectors.

Fix SymmetricPSD documentation and add the column-major vec() function.

Remove a completed TODO item.

Add doctests for the solution of some easy games.

Add some more doctests for SymmetricPSD containment.

Factor out srcdir in the makefile.

Rename a variable to make pylint happy.

Add rough eigenvalue-based containment testing for SymmetricPSD.

Add an eigenvalues() method to matrices.py.

Remove three completed TODO items.

Fix dict sorting in and add another big example to errors.py.

Add a few docs/examples to errors.py.

Enable doctests in errors.py.

Add a few SymmetricCone examples.

Add the game dual() method and document symmetric_linear_game.py.

Add variable name exceptions to the `make lint` target.

Update the `make clean` target for the new source locations.

Reorganize the source under src/dunshire.

Fix lint warnings and a few variable errors in symmetric_linear_game.py.

Move the pretty_print_dict() method out of the class (make it a function).

Play with the error/solution formatting some more.

More work-in-progress on solutions and their errors.

Remove member vars from SymmetricLinearCone and work on the solution dict.

Add the errors module, in a non-working state.

Start to clean up pylint warnings in symmetric_linear_game.py.

Add a "make lint" target.

Add doctests for the matrices module and fix its pylint warnings.

Add documentation, tests, and containment functions to the cones module.

Add a norm function to the matrices module.

Add another TODO to compare against a tolerance parameter.

Add a most basic test suite runner (for doctests only, at the moment).

Add another TODO to check the dimensions of the PSD cone.