11.12 elegantto

• description: elegantto translates an elegant-style (or a MAD file, with some restrictions) into formats accepted by other programs, such as COSY, PARMELA, PATPET, PATRICIA, TRANSPORT, and XORBIT. Will also generate an SDDS file containing lattice data.
• examples: The following command would translate the elegant lattice file lattice.lte into a TRANSPORT lattice file with 10mm quadrupole aperture and 5mm sextupole aperture, at an energy of 1.5 GeV.

  elegantto lattice.lte lattice.trin -transport=10,5,1.5

• synopsis:

  elegantto inputfile outputfile {-patricia | -patpet | -transport[=quadAper(mm),sextAper(mm),p(GeV/c)] | -parmela[=quadAper(mm),sextAper(mm),p(GeV/c)] | -sdds[=p(GeV/c)]  | -cosy=quadAper(mm),sextAper(mm),p(MeV/c)  | -xorbit | -mad8 } [-angle_tolerance=value] [-flip_k_signs] [-magnets=filename] [-header=filename] [-ender=filename]

• files:
  • inputfile — An elegant-style lattice file.
  • outputfile — A file containing lattice data in the chosen format.
• switches:
  • -cosy — Provide data for the program COSY INFINITY. This can take a little while as the program must figure out the Enge coefficients that correspond to the FINT and HGAP values for all the dipoles. The user should test the output carefully.
  • -mad8 — Provide data for the program MAD8.
  • -patricia — Provide data for the program PATRICIA.
  • -patpet — Provide data for the program PATPET, a merging of the programs PATRICIA and PETROS.
  • -transport[=quadAper(mm),sextAper(mm),p(GeV/c)] — Provide data for the program TRANSPORT (original style). One may give apertures for the quadrupoles and sextupoles, as well as the beam momentum in GeV/c.
  • -parmela[=quadAper(mm),sextAper(mm),p(GeV/c)] — Provide data for the program PARMELA. One may give apertures for the quadrupoles and sextupoles, as well as the beam momentum in GeV/c.
  • -sdds[=p(GeV/c)] — Provide data in SDDS form. One may give the beam momentum in GeV/c.
  • -angle_tolerance=value — PATPET and PATRICIA only allow sector and rectangular bends. This tolerance, in radians, determines how far from sector or rectangular a bend definition may be and still get processed.
  • -flip_k_signs — Changes the signs of all quadrupoles.
  • -magnets=filename — Results in output of an additional SDDS file with the magnet layout. This is the same file that would be generated by the magnets field of the run_setup command in elegant.
  • -header=filename, -ender=filename — Allow specification of files to be prepended and appended to the lattice output. For example, if additional commands are required prior to the lattice definition to set up the run, they would be put in the header file. If additional commands are needed after the lattice definition to initiate processing, they would be put in the ender file.
• author: M. Borland, ANL/APS.