5.8. seismo_logs

Functions to read log-files for seismic data to determine whether there are timing issues present. Designed to be used with the EQcorrscan package and to flag data that has more than a threshold timing issue.

Note

Currently only written to read RefTek rt130 log-files, and will not read all parameters - only for use when checking logs during cross-correlation. For full log-file exploration, Passcal tools: logpeek is useful.

copyright:Calum Chamberlain, Chet Hopp.
license:GNU Lesser General Public License, Version 3 (https://www.gnu.org/copyleft/lesser.html)
seismo_logs.check_all_logs(directory, time_thresh)[source]

Function to check all the log-files in a directory tree for timing errors.

Parameters:
  • directory (String) – Directory to search within
  • time_thresh (float) – Time threshold in seconds
Returns:

List of :class: datetime.datetime for which timing is above threshold

seismo_logs.flag_time_err(phase_err, time_thresh=0.02)[source]

Fucntion to scan through a list of tuples of time stamps and phase errors and return a list of time stamps with timing errors above a threshold.

Parameters:time_thresh (float) – Threshold to declare a timing error for
Returns:List of datetime.datetime
seismo_logs.rt_location_log(logfile)[source]

Function to read a specific RefTek RT130 log-file and find all location information.

Parameters:logfile (String) – The logfile to look in
Returns:list of tuples of lat, lon, elevation in decimal degrees and km.
seismo_logs.rt_time_log(logfile, startdate)[source]

Function to open and read a log-file as written by a RefTek RT130 datalogger. The information within is then scanned for timing errors above the threshold.

Parameters:
  • logfile (String) – The logfile to look in
  • startdate – The start of the file as a date - files contain timing and the julian day, but not the year.
Returns:

List of tuple of :class: datetime.datetime, float as time stamps and phase error.