sonify module

sonify.sonify(network, station, channel, starttime, endtime, location='*', freqmin=None, freqmax=None, speed_up_factor=200, fps=1, resolution='4K', output_dir=None, spec_win_dur=5, db_lim='smart', log=False, utc_offset=None)[source]

Produce an animated spectrogram with a soundtrack derived from sped-up seismic or infrasound data.

Parameters:
  • network (str) – SEED network code

  • station (str) – SEED station code

  • channel (str) – SEED channel code

  • starttime (UTCDateTime) – Start time of animation (UTC)

  • endtime (UTCDateTime) – End time of animation (UTC)

  • location (str) – SEED location code

  • freqmin (int or float) – Lower bandpass corner [Hz] (defaults to 20 Hz / speed_up_factor)

  • freqmax (int or float) – Upper bandpass corner [Hz] (defaults to 20,000 Hz / speed_up_factor or the Nyquist frequency, whichever is smaller)

  • speed_up_factor (int) – Factor by which to speed up the waveform data (higher values = higher pitches)

  • fps (int) – Frames per second of output video

  • resolution (str) – Resolution of output video; one of ‘crude’ (640 \(\times\) 360), ‘720p’ (1280 \(\times\) 720), ‘1080p’ (1920 \(\times\) 1080), ‘2K’ (2560 \(\times\) 1440), or ‘4K’ (3840 \(\times\) 2160)

  • output_dir (str or Path) – Directory where output video should be saved (defaults to cwd())

  • spec_win_dur (int or float) – Duration of spectrogram window [s]

  • db_lim (tuple or str) – Tuple defining min and max colormap cutoffs [dB], ‘smart’ for a sensible automatic choice, or None for no clipping

  • log (bool) – If True, use log scaling for \(y\)-axis of spectrogram

  • utc_offset (int or float) – If not None, convert UTC time to local time using this offset [hours] before plotting