4.48 sddsmatrixmult

• description: sddsmatrixmult multiplies the matrices represented in the 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 corrector to produce a new file containing values of expected bpm change:

  sddsmatrixmult response correctorChange bpmExpectedChange

• synopsis:

  sddsmatrixmult [-pipe=[input][,output]] [file1] file2 [output] [-commute] [-reuse] [-verbose] [-ascii]

• files: The first file (file1) is the SDDS file for left-hand matrix of product. The second file (file2) is the SDDS file for right-hand matrix of product. The third file contains the product matrix data.
• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -commute — Use file1 for right-hand matrix and file2 for left-hand matrix. Useful with -pipe option
  • -reuse — If one file runs out of data pages, then reuse the last one.
  • -ascii — Produces an output in ascii mode. Default is binary.
  • -verbose — Write diagnostic messages to stderr.
• author: L. Emery ANL