8.16 sddsfindresonances

• description: sddsfindresonances scans frequency map analysis data and identifies resonances.
• examples:

  sddsfindresonances run.fma run.res -multipoles=dipole,quad,sext,oct -type=skew sddsfindresonances run.fma run.res -multipoles=sext,oct -type=skew,norm

• synopsis:

  sddsfindresonances [-pipe=[input][,output]] [inputFile] [outputfile] -multipoles=[all=integer]|[dipole,][quadrupole,][sextupole,][octupole,] [-type=[normal,][skew]] [-variables=firstColumn,secondColumn]

• files:
  • inputFile — By default, frequency map analysis output file from elegant’s frequency_map command or equivalent, containing at minimum the columns x, y, nux, and nuy. Each page of the file is treated separately.
  • outputFile — Contains the identified resonance lines, one resonance line per page. The file contains the columns x, y, nux, and nuy, along with parameters that identify the resonance.
• switches:
  • pipe — The standard SDDS Toolkit pipe option.
  • multipoles=[all=integer]|[dipole,][quadrupole,][sextupole,][octupole,] — Choose what order of resonances to search for by naming the type of magnet that nominally drives it, or by giving the maximum order to search (all option).
  • -type=[normal,][skew] — Specify normal- or skew-driven resonances. Default is both.
  • -variables=firstColumn,secondColumn — Use to change the default names for the coordinate variables.
• authors: H. Shang, M. Borland. (ANL).