4.69 sddsmatrixmult

• description: sddsmatrixmult multiplies the matrices represented in two input files and puts the results in the output file. String columns are ignored and not copied to the output file.
• examples: In an accelerator beamline a linear relationship exists between the corrector dipole setpoints and the beam position monitor (BPM) readbacks. The matrix data in file response is multiplied with the columns of file correctorChange to produce bpmExpectedChange.
  sddsmatrixmult response correctorChange bpmExpectedChange  
      

• synopsis:
      sddsmatrixmult [-pipe=[input][,output]] [file1] file2 [output] [-commute] [-reuse] [-threads=number] [-verbose] [-ascii]  
      

• files: The first file (file1) is the SDDS file for the left-hand matrix of the product. The second file (file2) is the SDDS file for the right-hand matrix. The third file contains the product matrix data.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -commute — Use file1 for the right-hand matrix and file2 for the left-hand matrix. Useful with -pipe.
  • -reuse — If one file runs out of data pages, reuse the last one.
  • -threads=number — Specifies the number of threads for matrix multiplication. SDDS page I/O is performed serially. The default is 1.
  • -ascii — Produce output in ASCII mode. Default is binary.
  • -verbose — Write diagnostic messages to stderr.
• see also: sddsmatrixop()
• author: L. Emery, ANL/APS.