define_field_saving

• description: Field saving refers to writing the simulation fields to disk in such a way that they can be reloaded in subsequent runs. At this time, it saves only the time-dependent field components, not the external fields defined with define_solenoid or constant_fields.

• example:

  &define_field_saving
      filename = "gunRun.fsave",
      time_interval = 1e-9,
      double start_time = 5e-9
  &end
  

  This command results in saving of the fields at 1ns intervals starting at simulated time of 5ns to file "gunRun.fsave". Successive saves are placed in successive SDDS pages.

• synopsis and defaults:

  &define_field_saving
      STRING filename = NULL;
      double time_interval = 0;
      double start_time = 0;
      long save_before_exiting = 0;
  &end
  

• details:
  • filename: Name of an SDDS file to which to write the field saves.
  • time_interval: Simulated time interval in seconds between successive saves.
  • start_time: Simulated time at which to make the first save.
  • save_before_exiting: Flag requesting that a save be made just prior to program termination.