4.9.1.1. pyPamtraRadarMoments.core

4.9.1.1.1. Module Contents

4.9.1.1.1.1. Functions

calc_hildebrandSekhon(spectrum, radarNAve=1, verbosity=0)

Calculate the mean and maximum of noise of the linear radar spectrum

calc_radarMoments(spectrum, verbosity=0, radarMaxV=7.885, radarMinV=-7.885, radarNAve=150, momentsNPeaks=3, momentsNoiseDistanceFactor=0, momentsSpecNoiseMean=None, momentsSpecNoiseMax=None, momentsPeakMinSnr=-10, momentsPeakMinBins=2, momentsSmoothSpectrum=True, momentsUseWiderPeak=False, momentsReceiverMiscalibration=0)

Calculates the moments, slopes and edges of the linear radar spectrum.

4.9.1.1.1.2. Attributes

__version__

__version__ = 0.1[source]
calc_hildebrandSekhon(spectrum, radarNAve=1, verbosity=0)[source]

Calculate the mean and maximum of noise of the linear radar spectrum following Hildebrand and Sekhon 1974.

Parameters

  • spectrum (array_like [mm⁶/m³/(m/s)]) – linear radar spectrum. Can be 1D or 2D.

  • radarNAve (int, optional) – number of averages (default 1)

  • verbosity (int, optional) – verbosity level (default 0)

Returns

  • meanNoise (array_like or float) – spectral mean noise level in linear units, noise power = meanNoise*nFFT

  • maxNoise (array_like or float) – spectral maximum noise level in linear units

calc_radarMoments(spectrum, verbosity=0, radarMaxV=7.885, radarMinV=-7.885, radarNAve=150, momentsNPeaks=3, momentsNoiseDistanceFactor=0, momentsSpecNoiseMean=None, momentsSpecNoiseMax=None, momentsPeakMinSnr=-10, momentsPeakMinBins=2, momentsSmoothSpectrum=True, momentsUseWiderPeak=False, momentsReceiverMiscalibration=0)[source]

Calculates the moments, slopes and edges of the linear radar spectrum.

Parameters

  • spectrum (array_like) – linear radar spectrum [mm⁶/m³/(m/s)]. Can be 1D or 2D.

  • verbosity (int, optional) – verbosity level (default 0)

  • radarMaxV (float, optional) – MVimum Nyquist Velocity (default 7.885)

  • radarMinV (float, optional) – Minimum Nyquist Velocity (default -7.885)

  • radarNAve (int, optional) – No of averages per spectrum (default 150)

  • momentsNpeaks (int, optional) – No of peaks which should be determined (default 3)

  • momentsNoiseDistanceFactor (float, optional) – factor between noise and noise max. If 0, noiase max is obtained using calc_hildebrandSekhon (default 0)

  • specNoiseMean (array_like or float, optional) – linear mean noise per spectral bin in mm: mm6/m3. If None, it is determined using calc_hildebrandSekhon (default None)

  • momentsSpecNoiseMean (array_like or float, optional) – linear maximum noise per spectral bin in mm: mm6/m3. If None, it is determined using calc_hildebrandSekhon (default None)

  • momentsPeakMinSnr (float, optional) – minimum linear SNR for each peak (default 1.2)

  • momentsPeakMinBins (int, optional) – minimal number of bins per peak (default 2)

  • momentsSmoothSpectrum (bool, optional) – smooth spectrum before estiamting moments (default True)

  • momentsUseWiderPeak (bool, optional) – include edges into peak (default False)

  • momentsReceiverMiscalibration – simulate a wrong radar receiver calibration [dB] (default 0)

  • float – simulate a wrong radar receiver calibration [dB] (default 0)

  • optional – simulate a wrong radar receiver calibration [dB] (default 0)

Returns

  • spectrumOut (array_like) – radar spectrum with noise removed [mm⁶/m³]

  • moments (array_like) – 0th - 4th moment [mm⁶/m³, m/s, m/s,-,-]

  • slope (array_like) – slope of the peak [dB/(m/s)]

  • edge (array_like) – left(0) and right(1) edge the peak [m/s]

  • quality (array_like) – quality flag: 1st byte: aliasing; 2nd byte: more peaks present; 7th: no peak found; 8th: principal peak isolated

  • noiseMean (float) – mean intgrated noise power in linear units