pysteps.noise.fftgenerators.initialize_nonparam_2d_ssft_filter

pysteps.noise.fftgenerators.initialize_nonparam_2d_ssft_filter#

pysteps.noise.fftgenerators.initialize_nonparam_2d_ssft_filter(field, **kwargs)#

Function to compute the local Fourier filters using the Short-Space Fourier filtering approach.

Parameters:
  • field (array-like) – Two- or three-dimensional array containing one or more input fields. All values are required to be finite. If more than one field are passed, the average fourier filter is returned. It assumes that fields are stacked by the first axis: [nr_fields, y, x].

  • win_size (int or two-element tuple of ints) – Size-length of the window to compute the SSFT (default (128, 128)).

  • win_fun ({'hann', 'tukey', None}) – Optional tapering function to be applied to the input field, generated with pysteps.utils.tapering.compute_window_function() (default ‘tukey’).

  • overlap (float [0,1[) – The proportion of overlap to be applied between successive windows (default 0.3).

  • war_thr (float [0,1]) – Threshold for the minimum fraction of rain needed for computing the FFT (default 0.1).

  • rm_rdisc (bool) – Whether or not to remove the rain/no-rain disconituity. It assumes no-rain pixels are assigned with lowest value.

  • fft_method (str or tuple) – A string or a (function,kwargs) tuple defining the FFT method to use (see “FFT methods” in pysteps.utils.interface.get_method()). Defaults to “numpy”.

Returns:

field – Four-dimensional array containing the 2d fourier filters distributed over a 2d spatial grid. It can be passed to pysteps.noise.fftgenerators.generate_noise_2d_ssft_filter().

Return type:

array-like

References

[NBS+17]