Program: MKLSREADLSD
mklsreadsid........read Seismic Data file
call: lsd=mklsreadlsd(pfad);
lsd=mklsreadlsd(pfad,silent);
pfad: full pth to the .lsd file to be read
silent: if present, nothing is written to the screen.
otherwise, the programm produces some output on read progress.
result: lsd: a LSD structure representing the file content.
This structure has the following fields:
.statcnt: number of stations defined in structure
.eventcnt: number of events defined in structure
.arrivalcnt: number of arrival data records defined in structure
.station: an array of sub structures containing positions of all stations.
each element of the array has the following fields:
.id: a string containing the station id
.lon: three elements vector defining station longitude
.lat: threee elements vector defining station latitude
.elev: three elements vector defining station elevation
.event: an array of sub structures containing informations about all events
each element of the array has the following fields:
.id: a string containing the event ID
.info: a string containing informal additional info
.lon: three elements vector defining constraints for event longitude
(event location is constrainded to this range by external evidence)
.lat: three elements vector defining constraints for event latitude
(event location is constrainded to this range by external evidence)
.depth: three elements vector defining constraints for event focal depth
(event location is constrainded to this range by external evidence,
this is of special importance for meteoroid impacts!)
.ot: three elements vector defining constraints for event focal depth
(event location is constrainded to this range
by external evidence)
.arrival: an array of arrival data (which does not imply a source localization)
each element is a sub structure with the following fields:
.id: string containing data record ID
.station: string, containing station identifier
.event: string, containing event identifier
.phase: string, containing seismic phase name
.at: arrival time
.baz: back azimuth angle
.emerg: emergence angle
.slo: slowness
An undefined string will be empty.
An undefined numeric quantity will be [NaN NaN NaN]: even if a quantity is undefined,
it will be possible to access the respective field of the result lsd structure with
indices 1,2,3.
Martin Knapmeyer, 09.09.2003, adapted for LOCSMITH 02.02.2005
Read M-File Source Code
eof.