+
+def _charpoly_sage_input(s):
+ r"""
+ Helper function that you can use on the string output from sage
+ to convert a charpoly coefficient into the corresponding input
+ to be cached.
+
+ SETUP::
+
+ sage: from mjo.eja.eja_algebra import JordanSpinEJA
+ sage: from mjo.eja.eja_utils import _charpoly_sage_input
+
+ EXAMPLES::
+
+ sage: J = JordanSpinEJA(4,QQ)
+ sage: a = J._charpoly_coefficients()
+ sage: a[0]
+ X1^2 - X2^2 - X3^2 - X4^2
+ sage: _charpoly_sage_input(str(a[0]))
+ 'X[0]**2 - X[1]**2 - X[2]**2 - X[3]**2'
+
+ """
+ import re
+
+ exponent_out = r"\^"
+ exponent_in = r"**"
+
+ digit_out = r"X([0-9]+)"
+
+ def replace_digit(m):
+ # m is a match object
+ return "X[" + str(int(m.group(1)) - 1) + "]"
+
+ s = re.sub(exponent_out, exponent_in, s)
+ return re.sub(digit_out, replace_digit, s)
+
+
+def _scale(x, alpha):
+ r"""
+ Scale the vector, matrix, or cartesian-product-of-those-things
+ ``x`` by ``alpha``.
+
+ This works around the inability to scale certain elements of
+ Cartesian product spaces, as reported in
+
+ https://trac.sagemath.org/ticket/31435
+
+ ..WARNING:
+
+ This will do the wrong thing if you feed it a tuple or list.
+
+ SETUP::
+
+ sage: from mjo.eja.eja_utils import _scale
+
+ EXAMPLES::
+
+ sage: v = vector(QQ, (1,2,3))
+ sage: _scale(v,2)
+ (2, 4, 6)
+ sage: m = matrix(QQ, [[1,2],[3,4]])
+ sage: M = cartesian_product([m.parent(), m.parent()])
+ sage: _scale(M((m,m)), 2)
+ ([2 4]
+ [6 8], [2 4]
+ [6 8])
+
+ """
+ if hasattr(x, 'cartesian_factors'):
+ P = x.parent()
+ return P(tuple( _scale(x_i, alpha)
+ for x_i in x.cartesian_factors() ))
+ else:
+ return x*alpha
+
+
+def _all2list(x):
+ r"""
+ Flatten a vector, matrix, or cartesian product of those things
+ into a long list.
+
+ If the entries of the matrix themselves belong to a real vector
+ space (such as the complex numbers which can be thought of as
+ pairs of real numbers), they will also be expanded in vector form
+ and flattened into the list.
+
+ SETUP::
+
+ sage: from mjo.eja.eja_utils import _all2list
+ sage: from mjo.hurwitz import (QuaternionMatrixAlgebra,
+ ....: Octonions,
+ ....: OctonionMatrixAlgebra)
+
+ EXAMPLES::
+
+ sage: _all2list([[1]])
+ [1]
+
+ ::
+
+ sage: V1 = VectorSpace(QQ,2)
+ sage: V2 = MatrixSpace(QQ,2)
+ sage: x1 = V1([1,1])
+ sage: x2 = V1([1,-1])
+ sage: y1 = V2.one()
+ sage: y2 = V2([0,1,1,0])
+ sage: _all2list((x1,y1))
+ [1, 1, 1, 0, 0, 1]
+ sage: _all2list((x2,y2))
+ [1, -1, 0, 1, 1, 0]
+ sage: M = cartesian_product([V1,V2])
+ sage: _all2list(M((x1,y1)))
+ [1, 1, 1, 0, 0, 1]
+ sage: _all2list(M((x2,y2)))
+ [1, -1, 0, 1, 1, 0]
+
+ ::
+
+ sage: _all2list(Octonions().one())
+ [1, 0, 0, 0, 0, 0, 0, 0]
+ sage: _all2list(OctonionMatrixAlgebra(1).one())
+ [1, 0, 0, 0, 0, 0, 0, 0]
+
+ ::
+
+ sage: _all2list(QuaternionAlgebra(QQ, -1, -1).one())
+ [1, 0, 0, 0]
+ sage: _all2list(QuaternionMatrixAlgebra(1).one())
+ [1, 0, 0, 0]
+
+ ::
+
+ sage: V1 = VectorSpace(QQ,2)
+ sage: V2 = OctonionMatrixAlgebra(1,field=QQ)
+ sage: C = cartesian_product([V1,V2])
+ sage: x1 = V1([3,4])
+ sage: y1 = V2.one()
+ sage: _all2list(C( (x1,y1) ))
+ [3, 4, 1, 0, 0, 0, 0, 0, 0, 0]
+
+ """
+ if hasattr(x, 'to_vector'):
+ # This works on matrices of e.g. octonions directly, without
+ # first needing to convert them to a list of octonions and
+ # then recursing down into the list. It also avoids the wonky
+ # list(x) when x is an element of a CFM. I don't know what it
+ # returns but it aint the coordinates. This will fall through
+ # to the iterable case the next time around.
+ return _all2list(x.to_vector())
+
+ try:
+ xl = list(x)
+ except TypeError: # x is not iterable
+ return [x]
+
+ if xl == [x]:
+ # Avoid the retardation of list(QQ(1)) == [1].
+ return [x]
+
+ return sum(list( map(_all2list, xl) ), [])
+
+