From: Michael Orlitzky <michael@orlitzky.com>
Date: Fri, 19 Jul 2019 20:15:55 +0000 (-0400)
Subject: eja: text the inner product axiom of an EJA.
X-Git-Url: https://gitweb.michael.orlitzky.com/?a=commitdiff_plain;h=e9c4a273e982b5fe2e7f4dd5e6f92f863ea38861;p=sage.d.git

eja: text the inner product axiom of an EJA.
---

diff --git a/mjo/eja/euclidean_jordan_algebra.py b/mjo/eja/euclidean_jordan_algebra.py
index b258398..3cec4fa 100644
--- a/mjo/eja/euclidean_jordan_algebra.py
+++ b/mjo/eja/euclidean_jordan_algebra.py
@@ -94,6 +94,20 @@ class FiniteDimensionalEuclideanJordanAlgebra(FiniteDimensionalAlgebra):
         The inner product associated with this Euclidean Jordan algebra.
 
         Will default to the trace inner product if nothing else.
+
+        EXAMPLES:
+
+        The inner product must satisfy its axiom for this algebra to truly
+        be a Euclidean Jordan Algebra::
+
+            sage: set_random_seed()
+            sage: J = random_eja()
+            sage: x = J.random_element()
+            sage: y = J.random_element()
+            sage: z = J.random_element()
+            sage: (x*y).inner_product(z) == y.inner_product(x*z)
+            True
+
         """
         if (not x in self) or (not y in self):
             raise TypeError("arguments must live in this algebra")