The targets.waveform module

class grond.targets.waveform.WaveformMisfitConfig(**kwargs)

Undocumented.

♦ quantity

str (pyrocko.gf.meta.QuantityType), default: 'displacement'

♦ fmin

float, default: 0.0

minimum frequency of bandpass filter

♦ fmax

float

maximum frequency of bandpass filter

♦ ffactor

float, default: 1.5

♦ tmin

pyrocko.gf.meta.Timing, optional

Start of main time window used for waveform fitting.

♦ tmax

pyrocko.gf.meta.Timing, optional

End of main time window used for waveform fitting.

♦ tfade

float, optional

Decay time of taper prepended and appended to main time window used for waveform fitting [s].

♦ pick_synthetic_traveltime

pyrocko.gf.meta.Timing, optional

Synthetic phase arrival definition for alignment of observed and synthetic traces.

♦ pick_phasename

str, optional

Name of picked phase for alignment of observed and synthetic traces.

♦ domain

str (DomainChoice), default: 'time_domain'

Type of data characteristic to be fitted.

Available choices are: 'time_domain', 'frequency_domain', 'log_frequency_domain', 'envelope', 'absolute', 'cc_max_norm'

♦ norm_exponent

int, default: 2

Exponent to use in norm (1: L1-norm, 2: L2-norm)

♦ tautoshift_max

float, default: 0.0

If non-zero, allow synthetic and observed traces to be shifted against each other by up to +/- the given value [s].

♦ autoshift_penalty_max

float, default: 0.0

If non-zero, a penalty misfit is added for non-zero shift values.

The penalty value is computed as autoshift_penalty_max * normalization_factor * tautoshift**2 / tautoshift_max**2

class grond.targets.waveform.WaveformMisfitResult(**kwargs)

Carries the observations for a target and corresponding synthetics.

A number of different waveform or phase representations are possible.

♦ processed_obs

pyrocko.trace.Trace, optional

♦ processed_syn

pyrocko.trace.Trace, optional

♦ filtered_obs

pyrocko.trace.Trace, optional

♦ filtered_syn

pyrocko.trace.Trace, optional

♦ spectrum_obs

TraceSpectrum, optional

♦ spectrum_syn

TraceSpectrum, optional

♦ taper

pyrocko.trace.Taper, optional

♦ tobs_shift

float, optional

♦ tsyn_pick

pyrocko.util.get_time_float (pyrocko.guts.Timestamp), optional

♦ tshift

float, optional

♦ cc

pyrocko.trace.Trace, optional

♦ piggyback_subresults

list of WaveformPiggybackSubresult objects, default: []

class grond.targets.waveform.WaveformMisfitTarget(**kwargs)

Undocumented.

♦ flip_norm

bool, default: False

♦ misfit_config

WaveformMisfitConfig

♦ only_use_stations_with_picks

bool, optional, default: False

class grond.targets.waveform.WaveformTargetGroup(**kwargs)

Handles seismogram targets or other targets of dynamic ground motion.

♦ distance_min

float, optional

excludes targets nearer to source, along a great circle

♦ distance_max

float, optional

excludes targets farther from source, along a great circle

♦ distance_3d_min

float, optional

excludes targets nearer from source (direct distance)

♦ distance_3d_max

float, optional

excludes targets farther from source (direct distance)

♦ depth_min

float, optional

excludes targets with smaller depths

♦ depth_max

float, optional

excludes targets with larger depths

♦ include

list of str objects, optional

If not None, list of stations/components to include according to their STA, NET.STA, NET.STA.LOC, or NET.STA.LOC.CHA codes.

♦ exclude

list of str objects, default: []

Stations/components to be excluded according to their STA, NET.STA, NET.STA.LOC, or NET.STA.LOC.CHA codes.

♦ only_use_stations_with_picks

bool, optional, default: False

Choose if targets without arrival picks should be excluded (True) or should be used without time shifts (False).

♦ limit

int, optional

♦ channels

list of str objects, optional

set channels to include, e.g. [‘Z’, ‘T’]

♦ misfit_config

WaveformMisfitConfig

♦ store_id_selector

StoreIDSelector, optional

select GF store based on event-station geometry.