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.