Compatibility with TraceWin DAT files

LightWin uses the same format as TraceWin for the linac structure. As TraceWin developers implemented a significant number of elements and commands, those will be progressively implemented in LightWin too.

“Useless” commands and elements

Some instructions will raise a warning, even if they will not influence the results. As an example, if you use Envelope1D, transverse dynamics are not considered and the fact that transverse field maps are not implemented should not be a problem.

“Useful” commands and elements

You should clean the DAT to remove any command that influences the design of the linac. In particular: SET_ADV, ADJUST commands. Warnings may not always appear, so be careful that Envelope1D or Envelope3D results match TraceWin’s. If you choose TraceWin solver for the optimization, both LightWin and TraceWin could modify the design of the linac at the same time, so unexpected side effects may appear.

Note

Since 0.6.21, SET_SYNC_PHASE commands can be kept in the original DAT. Since 0.8.0b3, the SET_SYNC_PHASE can be exported in the output DAT file.

See also: ListOfElements.store_settings_in_dat() (the method which is actually called to create the DAT).

How to implement commands or elements

You can implement the desired elements and git push them, or file an issue on GitHub and I will try to add the desired element(s) as soon as possible.

Note

Add an example.

Warning

Field maps file formats must be ascii, binary files to handled yet