-fdtd/-storefieldsat: when to store

 ##############################################################################
 # Flags: nomenu, noprompt, nomessage,                                        #
 ##############################################################################
 # section: -storefieldsat                                                    #
 ##############################################################################
 # name  = noname-0001                                                        #
 # whattosave= both                     -- e-fields, h-fields, both, clouds   #
 # firstsaved   = undefined                                                   #
 # lastsaved    = undefined                                                   #
 # distancesaved= undefined                                                   #
 ##############################################################################
 # doit, list, ?, return, help                                                #
 ##############################################################################

• name:
  The name to be used to identify the stored data later. If you enter the name of an already defined set, you can edit the parameters for this already defined set. If you specify a name of "name= a", the saved e-fields are later accessible in the post-processor under the name "a_e_1" for the first stored field. The first stored h-field of the set is accessible as "a_h_1".
• whattosave:
  Possible values are e-fields, h-fields, both, clouds. The clouds value is for PIC-computations, it specifies that only the data of free moving charges shall be stored at the selected times. If you have a PIC-computation running, and you have selected one of e-fields, h-fields, both, the data of free moving charges are stored as well.
• firstsaved:
  The first time where the datasets shall be stored on files.
• lastsaved:
  The last time where the datasets shall be stored on files.
• distancesaved:
  The time-distance between datasets to be saved.
• doit:
  Stores the current data and enables the editing of the parameters of a set that is not yet defined (a new set).
• list:
  Lists the names of the already defined sets.

Example The following specifies that we want to store both the electric and magnetic fields in the time span of 10 periods to 12 periods. The distance shall be 0.1 periods. In the timespan between 20 periods and 30 periods, we want to store only the electric field. The distance between the saved fields shall be a quarter period.

 define(FREQ, 1e9)

 -fdtd
    -storefieldsat
      name= a, what= both
         firstsaved= 10/FREQ
         lastsaved=  12/FREQ
         distance=   0.1/FREQ
      doit

      name= b, what= e-fields
         firstsaved= 20/FREQ
         lastsaved=  30/FREQ
         distance=   0.25/FREQ
      doit

Example The following specifies that we want to store the electric fields every 100 HF-periods. Every 100 HF-periods, the fields shall be stored with a time density of 1/8 period.

 define(FREQ, 1e9)

 -fdtd
    -storefieldsat
      do ii= 100, 1000, 100
         #
         # This 'name= a-ii' gets expanded to eg. 'name= a-100'
         #
         name= a-ii, what= e-fields
            firstsaved=  ii       /FREQ
            lastsaved=  (ii+1+1/8)/FREQ
            distance=   1/8/FREQ
         doit
      enddo