4.68 sddsmatrixop

• description: sddsmatrixop performs general matrix operations. The matrices and operations are specified on the command line and are executed in an RPN-like fashion. String columns are ignored and not copied to the output file.
• examples: Multiply two matrices:
  sddsmatrixop A.matrix C.matrix -push=B.matrix -multiply  
      

  Compute Y = (1 + (A + B)C)^-1:

  sddsmatrixop A.matrix Y.matrix -push=B.matrix -add -push=C.matrix -mult -identity -add -invert  
      

• synopsis:
  sddsmatrixop [inputmatrix] [outputmatrix] [-pipe=[in|out]] [-verbose]  
    [-push=<matrix>] [-multiply] [-add] [-substract] [-invert] ...  
      

• files: inputmatrix is the SDDS file containing the initial matrix on the stack. outputmatrix is the SDDS file to receive the resulting matrix.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -push=<matrix> — Push a matrix onto the stack.
  • -verbose — Write diagnostic messages to stderr.
  • -identity[=<number>] — Push an identity matrix. If a number is given, it sets the dimension; otherwise uses the dimension of the top matrix.
  • -add — Addition operator.
  • -substract — Subtraction operator.
  • -multiply[=hadamard] — Matrix multiplication. If =hadamard is given, performs element-by-element multiplication.
  • -divide=hadamard — Element-by-element division.
  • -swap — Swap the top two elements of the stack.
  • -scalarmultiply=<value> — Multiply the matrix by a constant.
  • -scalardivide=<value> — Divide the matrix by a constant.
  • -transpose — Matrix transpose.
  • -invert — Matrix inversion.
• see also:
  • sddsmatrixmult()
  • sddsmatrix2column()
• author: H. Shang, ANL.