Add more positive operator examples from the paper.

[sage.d.git] / mjo / cone / cone.py

diff --git a/mjo/cone/cone.py b/mjo/cone/cone.py
index 28a84231d1eb461a1e12d0df258f980e48f21f2d..ae3ec48cddc9700d4f63ae378fc01b178dee6e3b 100644 (file)
--- a/mjo/cone/cone.py
+++ b/mjo/cone/cone.py
@@ -179,12 +179,6 @@ def positive_operator_gens(K):
 
     EXAMPLES:
 
-    The trivial cone in a trivial space has no positive operators::
-
-        sage: K = Cone([], ToricLattice(0))
-        sage: positive_operator_gens(K)
-        []
-
     Positive operators on the nonnegative orthant are nonnegative matrices::
 
         sage: K = Cone([(1,)])
@@ -198,6 +192,27 @@ def positive_operator_gens(K):
         [0 0], [0 0], [1 0], [0 1]
         ]
 
+    The trivial cone in a trivial space has no positive operators::
+
+        sage: K = Cone([], ToricLattice(0))
+        sage: positive_operator_gens(K)
+        []
+
+    Every operator is positive on the trivial cone::
+
+        sage: K = Cone([(0,)])
+        sage: positive_operator_gens(K)
+        [[1], [-1]]
+
+        sage: K = Cone([(0,0)])
+        sage: K.is_trivial()
+        True
+        sage: positive_operator_gens(K)
+        [
+        [1 0]  [-1  0]  [0 1]  [ 0 -1]  [0 0]  [ 0  0]  [0 0]  [ 0  0]
+        [0 0], [ 0  0], [0 0], [ 0  0], [1 0], [-1  0], [0 1], [ 0 -1]
+        ]
+
     Every operator is positive on the ambient vector space::
 
         sage: K = Cone([(1,),(-1,)])
@@ -215,14 +230,58 @@ def positive_operator_gens(K):
         [0 0], [ 0  0], [0 0], [ 0  0], [1 0], [-1  0], [0 1], [ 0 -1]
         ]
 
+    A non-obvious application is to find the positive operators on the
+    right half-plane::
+
+        sage: K = Cone([(1,0),(0,1),(0,-1)])
+        sage: positive_operator_gens(K)
+        [
+        [1 0]  [0 0]  [ 0  0]  [0 0]  [ 0  0]
+        [0 0], [1 0], [-1  0], [0 1], [ 0 -1]
+        ]
+
     TESTS:
 
-    A positive operator on a cone should send its generators into the cone::
+    Each positive operator generator should send the generators of the
+    cone into the cone::
+
+        sage: set_random_seed()
+        sage: K = random_cone(max_ambient_dim=5)
+        sage: pi_of_K = positive_operator_gens(K)
+        sage: all([ K.contains(P*x) for P in pi_of_K for x in K ])
+        True
+
+    Each positive operator generator should send a random element of the
+    cone into the cone::
+
+        sage: set_random_seed()
+        sage: K = random_cone(max_ambient_dim=5)
+        sage: pi_of_K = positive_operator_gens(K)
+        sage: all([ K.contains(P*K.random_element()) for P in pi_of_K ])
+        True
+
+    A random element of the positive operator cone should send the
+    generators of the cone into the cone::
+
+        sage: set_random_seed()
+        sage: K = random_cone(max_ambient_dim=5)
+        sage: pi_of_K = positive_operator_gens(K)
+        sage: L = ToricLattice(K.lattice_dim()**2)
+        sage: pi_cone = Cone([ g.list() for g in pi_of_K ], lattice=L)
+        sage: P = matrix(K.lattice_dim(), pi_cone.random_element().list())
+        sage: all([ K.contains(P*x) for x in K ])
+        True
+
+    A random element of the positive operator cone should send a random
+    element of the cone into the cone::
 
         sage: set_random_seed()
         sage: K = random_cone(max_ambient_dim=5)
         sage: pi_of_K = positive_operator_gens(K)
-        sage: all([K.contains(p*x) for p in pi_of_K for x in K.rays()])
+        sage: L = ToricLattice(K.lattice_dim()**2)
+        sage: pi_cone = Cone([ g.list() for g in pi_of_K ], lattice=L)
+        sage: P = matrix(K.lattice_dim(), pi_cone.random_element().list())
+        sage: K.contains(P*K.random_element())
         True
 
     The dimension of the cone of positive operators is given by the