Program: MKLSGRIDEVAL

  mklsgrideval..........iterates the current grid until convergence
 
  call: [exitstatus,mygrid,ttsupport]=mklsgrideval(lsopt,mygrid,simpledata,cumdatacnt,ttsupport);
 
            lsopt: (structure)
                   LOCSMITH options structure as returned by MKLSOPT
 
            mygrid: (structure)
                    LOCSMITH search grid
 
            simpledata: (strcuture)
                    LSD structure containing seismic arrival data and
                    station data.
 
            cumdatacnt: (numeric array)
                    The IDs of all nodes of MYGRID that were evaluated for less
                    or equal CUMDATACNT data values.
 
            ttsupport: (structure)
                    TTSUPPORT structure as needed by the used travel time
                    software package.
 
  result:
  
          exitstatus: (string)
                   a string denoting the reason why MKLOCSMITH came to a
                   halt. This string should be considered when evaluating
                   the output. The follwiong values are possible:
 
                   'unexpected': the exit status is initialized with this
                                 value. At any legal exit condition, a new
                                 value should be written into the string.
                                 If this is not the case, the init value
                                 remains, because the stopping of the
                                 routine was indeed due to an unexpected
                                 reason. This should never occur.
 
                   'no data':    There is no data to evaluate. No grid is
                                 generated and no location produced.
 
                   'horizontally converged':  The desired spatial grid resolution for the
                                 location has been reached. The routine
                                 quits because the job is done.
 
                   'horizontal iteration timeout': 
                                 The maximum number of iterations to 
                                 determine the horizontal extent of the 
                                 location has been reached. 
                                 This limit is defined in lsopt.iter_max.
                                 If this occurs, the job is NOT
                                 done and you should probably repeat the
                                 location with a higher iter_max limit.
                                 lsopt.iter_max is intended to be an
                                 emergency brake to avoid infinite
                                 iteration, not a standard tool to finish
                                 the program!
 
          mygrid: (structure array)
                  The search grid as it is at the end of the location
                  process. This is a LOCSMITH search grid structure as
                  returned by MKLSGRIDNEW.
 
          ttsupport: (structure)
                   TTSUPPORT structure. This structure might be as returned
                   by MKLSEMPTYTTSUPPORT, i.e. unspecific, or with fields
                   that are specific for the used travel time software.
 
 
  This routine evaluates the grid as given in MYGRID. The individual layers
  are iterated until convergence or timeout, but no new layers are
  generated. This is location on a fixed vertical sampling.
 
  Martin Knapmeyer, 04.07.2005, 05.02.2007

Read M-File Source Code


eof.