`salvus.opt.data_normalizations.normalized_misfit`

Compute a per-trace normalized misfit and adjoint source.

Functions

`compute_normalized_misfit()`

def compute_normalized_misfit(
    data_array_synthetic: xr.DataArray,
    data_array_observed: xr.DataArray | None,
    misfit_function: MisfitFunctionProtocol,
    event: Event,
    extra_kwargs_misfit_function: dict[str, typing.Any] | None = None,
    normalization: Normalization | None = None,
    _extra_output: ExtraOutput | None = None,
    _write_normalized_adjoint_source: typing.Callable | None = None,
    _receiver_field: str | None = None,
) -> xr.Dataset: ...

Compute misfit and adjoint source on normalized data.

Parameters

data_array_synthetic xr.DataArray — synthetic waveforms.
data_array_observed xr.DataArray | None — observed waveforms.
misfit_function MisfitFunctionProtocol — Callback function of actual misfit function.
event Event — The event object.
extra_kwargs_misfit_function dict[str, typing.Any] | None — Extra arguments passed to the misfit function.
normalization Normalization | None — Optional data normalization.
_extra_output ExtraOutput | None — Extra output configuration.
_write_normalized_adjoint_source typing.Callable | None — Callback function to potentially write the normalized adjoint sources prior to the application of the jacobian of the normalization.
_receiver_field str | None — Receiver field of extra output.

Returns xr.Dataset — tuple of misfit value and adjoint source

`compute_normalized_misfit_per_trace()`

def compute_normalized_misfit_per_trace(
    data_synthetic: npt.NDArray,
    data_observed: npt.NDArray | None,
    sampling_rate_in_hertz: float,
    misfit_function: TraceMisfitFunctionProtocol,
    extra_kwargs_misfit_function: dict | None = None,
    normalization: TraceNormalization | None = None,
) -> tuple[float, npt.NDArray]: ...

Compute misfit and adjoint source on normalized data.

Parameters

data_synthetic npt.NDArray — synthetic waveforms.
data_observed npt.NDArray | None — observed waveforms.
sampling_rate_in_hertz float — Sampling rate.
misfit_function TraceMisfitFunctionProtocol — Callback function of actual misfit function.
extra_kwargs_misfit_function dict | None — Extra arguments passed to the misfit function.
normalization TraceNormalization | None — Optional data normalization.

Returns tuple[float, npt.NDArray] — tuple of misfit value and adjoint source