The targets.waveform module

class grond.targets.waveform.WaveformTargetGroup(**kwargs)[source]

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.

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.

class grond.targets.waveform.WaveformMisfitTarget(**kwargs)[source]

Undocumented.

flip_norm

bool, default: False

misfit_config

WaveformMisfitConfig

class grond.targets.waveform.WaveformMisfitConfig(**kwargs)[source]

Undocumented.

quantity

builtins.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

builtins.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)[source]

Carries the observations for a target and corresponding synthetics.

A number of different waveform or phase representations are possible.

processed_obs

Trace, optional

processed_syn

Trace, optional

filtered_obs

Trace, optional

filtered_syn

Trace, optional

spectrum_obs

TraceSpectrum, optional

spectrum_syn

TraceSpectrum, optional

taper

pyrocko.trace.Taper, optional

tobs_shift

float, optional

tsyn_pick

builtins.float (pyrocko.guts.Timestamp), optional

tshift

float, optional

cc

Trace, optional

piggyback_subresults

list of WaveformPiggybackSubresult objects, default: []