5.2.14.1.1. eqcorrscan.utils.synth_seis.generate_synth_data

eqcorrscan.utils.synth_seis.generate_synth_data(nsta, ntemplates, nseeds, samp_rate, t_length, max_amp, max_lag, phaseout='all', jitter=0, noise=True, same_phase=False)[source]

Generate a synthetic dataset to be used for testing.

This will generate both templates and data to scan through. Templates will be generated using the utils.synth_seis functions. The day of data will be random noise, with random signal-to-noise ratio copies of the templates randomly seeded throughout the day. It also returns the seed times and signal-to-noise ratios used.

Parameters:
  • nsta (int) – Number of stations to generate data for < 15.

  • ntemplates (int) – Number of templates to generate, will be generated with random arrival times.

  • nseeds (int) – Number of copies of the template to seed within the day of noisy data for each template.

  • samp_rate (float) – Sampling rate to use in Hz

  • t_length (float) – Length of templates in seconds.

  • max_amp (float) – Maximum signal-to-noise ratio of seeds.

  • max_lag (float) – Maximum lag time in seconds (randomised).

  • jitter (int) – Random range to allow arrival shifts for seeded phases (samples)

  • noise (bool) – Set to False to give noise-free data.

  • same_phase (bool) – Whether to enforce all positive repeats (True) or not.

Returns:

Templates: List of obspy.core.stream.Stream

Return type:

list

Returns:

Data: obspy.core.stream.Stream of seeded noisy data

Return type:

obspy.core.stream.Stream

Returns:

Seeds: dictionary of seed SNR and time with time in samples.

Return type:

dict