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.