FLASH3.3 Release API

ROBODoc 4.99 manual

Generated from /asc/home/flashdocs/FLASH3_33/source/RuntimeParameters/RuntimeParameters_setPrev.F90 with ROBODoc v4.99.8 on Wed Oct 20 17:16:47 2010


[Functions] source/RuntimeParameters/RuntimeParameters_setPrev





  RuntimeParameters_setPrev(char*(in) :: name,
                     real/int/str/log(in) :: value) 


  This is an overloaded function. RuntimeParameters_setPrev
  under the hood implements RuntimeParameters_setPrevReal
  RuntimeParameters_setPrevInt, RuntimeParameters_setPrevStr

  This routine allows the user to keep track of a value from a restart run.
  The linked List holding the runtime parameters can hold 2 values, 
  a current value, and an "initial" or "previous" value.  The routine sets
  the value of the latter.  


  Take a run using Paramesh with a refinement level of 4.  The user
  runs the simulation for some time then writes a checkpoint. After
  examining the checkpoint data the user wants to increase the maximum
  resolution in the simulation and sets the refinement level to 6.
  Upon restart the grid may need to compare the values 4 and 6 and refine
  the grid further.  The value '4' would be read in from the checkpoint
  file and stored in the 'previous', while the value '6' would
  be stored in the 'current' slot.  We imagine there are only a few 
  runtime parameters in which this routine would be relevant.

  use RuntimeParameters, ONLY : RuntimeParameters_set
     integer :: lrefine_max

     lrefine_max = 4
     call RuntimeParameters_setPrev('lrefine_max', lrefine_max) 


  name:       name
  value:      name value


  Because RuntimeParameters_setPrev is an overloaded function, a user calling
  the routine must USE the interface RuntimeParameters_interface.