Package xal.tools.math.r6

Class R6x6

java.lang.Object
xal.tools.math.BaseMatrix<M>
xal.tools.math.SquareMatrix<R6x6>
xal.tools.math.r6.R6x6
All Implemented Interfaces:
IArchive
public class R6x6 extends SquareMatrix<R6x6>

Represents an element of R6×6, the set of real, 6×6 matrices. The class also contains the usual set of matrix operations and linear transforms on R6 that are represented by these matrices.

Since:
Oct 15, 2013
Author:
Christopher K. Allen

  • Field Details

  • Constructor Details

    • R6x6

      public R6x6() throws UnsupportedOperationException
      Zero argument constructor for R6x6. Returns a matrix of zeros.
      Throws:
      UnsupportedOperationException - only thrown in the absence of this constructor
      Since:
      Oct 15, 2013

    • R6x6

      public R6x6(double[][] arrVals) throws ArrayIndexOutOfBoundsException
      Initializing constructor for R6x6. The matrix elements are set to those in the given Java native array, which must be 6×6 dimensional.
      Parameters:
      arrVals - initial values for new matrix
      Throws:
      ArrayIndexOutOfBoundsException - the given native array is not 6×6 dimensional
      Since:
      Oct 15, 2013

    • R6x6

      public R6x6(String strTokens) throws IllegalArgumentException, NumberFormatException

      Parsing Constructor - creates an instance of the child class and initialize it according to a token string of element values.

      The token string argument is assumed to be one-dimensional and packed by column (ala FORTRAN).

      Parameters:
      strTokens - token vector of getSize()^2 numeric values
      Throws:
      IllegalArgumentException - wrong number of string tokens
      NumberFormatException - bad number format, unparseable
      Since:
      Oct 15, 2013

    • R6x6

      public R6x6(R6x6 matParent) throws UnsupportedOperationException
      Copy constructor for R6x6. Creates a deep copy of the given object. The dimensions are set and the internal array is cloned.
      Parameters:
      matParent - the matrix to be cloned
      Throws:
      UnsupportedOperationException - base class has not defined a public, zero-argument constructor
      Since:
      Oct 15, 2013

  • Method Details

    • newZero

      public static R6x6 newZero()
      Create a new instance of a zero matrix.
      Returns:
      zero vector

    • newIdentity

      public static R6x6 newIdentity()
      Create a new identity matrix
      Returns:
      6×6 real identity matrix

    • rotationProduct

      public static R6x6 rotationProduct(R3x3 matSO3)

      Compute the rotation matrix in phase space that is essentially the Cartesian product of the given rotation matrix in SO(3). That is, if the given argument is the rotation O, the returned matrix, denoted M, is the M = O×O×I embedding into homogeneous phase space R6×6×{1}. Thus, M ∈ SO(6) ⊂ R6×6×{1}.

      Viewing phase-space as a 6D manifold built as the tangent bundle over R3 configuration space, then the fibers of 3D configuration space at a point (x,y,z) are represented by the Cartesian planes (x',y',z'). The returned phase matrix rotates these fibers in the same manner as their base point (x,y,z).

      This is a convenience method to build the above rotation matrix in SO(7).

      Parameters:
      matSO3 - a rotation matrix in three dimensions, i.e., a member of SO(3) ⊂ R3×3
      Returns:
      rotation matrix in S0(7) which is direct product of rotations in S0(3)

    • parse

      public static R6x6 parse(String strTokens) throws IllegalArgumentException, NumberFormatException

      Create a new R6x6 instance and initialize it according to a token string of element values.

      The token string argument is assumed to be one-dimensional and packed by column (ala FORTRAN).

      Parameters:
      strTokens - token vector of 6x6=36 numeric values
      Returns:
      real matrix with elements initialized by the given numeric tokens
      Throws:
      IllegalArgumentException - wrong number of string tokens
      NumberFormatException - bad number format, unparseable

    • clone

      public R6x6 clone()
      Creates and returns a deep copy of this matrix.
      Specified by:
      clone in class BaseMatrix<R6x6>
      Since:
      Jul 3, 2014
      See Also:

    • newInstance

      protected R6x6 newInstance(int row, int cnt)
      Handles object creation required by the base class.
      Specified by:
      newInstance in class BaseMatrix<R6x6>
      Parameters:
      row - Number of rows.
      cnt - Number of columns.
      Returns:
      uninitialized matrix object of type M
      Since:
      Jun 17, 2014
      See Also:
      • xal.tools.math.BaseMatrix#newInstance()