4.10.1.1. pyPamtraRadarSimulator.core

4.10.1.1.1. Module Contents

4.10.1.1.1.1. Functions

radarSimulator(diameterSpec, specWidth, backSpec, fallVelSpec, pathIntegratedAttenuation, height, verticalWind, horizontalWind, eddyDissipationRate, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarAirmotion=True, radarAirmotionModel='constant', radarAirmotionVmin=0, radarAirmotionVmax=0, radarAirmotionLinearSteps=30, radarAirmotionStepVmin=0.5, radarPNoise1000=-30, radarK2=0.93, radarNAve=150, radarBeamwidthDeg=0.2, radarIntegrationTime=60, seed=0, verbosity=0)

Convert a spectrum of hydrometeor backscattering (per hydrometeor)

createRadarSpectrum(diameterSpec, specWidth, backSpec, fallVelSpec, verticalWind, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarAirmotion=True, radarAirmotionModel='constant', radarAirmotionVmin=0, radarAirmotionVmax=0, radarAirmotionLinearSteps=30, radarAirmotionStepVmin=0.5, radarK2=0.93, verbosity=0)

First step of the radar simulator which creates an idealized radar

simulateRadarSpectrum(height, eddyDissipationRate, horizontalWind, mergedParticleSpec, pathIntegratedAttenuation, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarPNoise1000=-30, radarK2=0.93, radarNAve=150, radarBeamwidthDeg=0.2, radarIntegrationTime=60, seed=0, verbosity=0)

param height

altitude in m

calcSpectralBroadening(eddyDissipationRate, horizontalWind, height, wavelength, radarBeamwidthDeg=0.2, radarIntegrationTime=60, kolmogorov=0.5, verbosity=0)

Estimate the spectral broadening due to turbulence and horizontal wind.

4.10.1.1.1.2. Attributes

__version__

__version__ = 0.1[source]
radarSimulator(diameterSpec, specWidth, backSpec, fallVelSpec, pathIntegratedAttenuation, height, verticalWind, horizontalWind, eddyDissipationRate, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarAirmotion=True, radarAirmotionModel='constant', radarAirmotionVmin=0, radarAirmotionVmax=0, radarAirmotionLinearSteps=30, radarAirmotionStepVmin=0.5, radarPNoise1000=-30, radarK2=0.93, radarNAve=150, radarBeamwidthDeg=0.2, radarIntegrationTime=60, seed=0, verbosity=0)[source]

Convert a spectrum of hydrometeor backscattering (per hydrometeor) as a function of size into a merged spectrum as a function of velocity. Note that the optional shapes of all input variables have to be the same.

Parameters

  • diameterSpec – Hydrometeo Diameter in m. Shape (range, hydrometeor, hydrometeorBin)

  • backSpec – Hydrometeo backscattering cross section in m2. Shape (range, hydrometeor, hydrometeorBin)

  • fallVelSpec – Fall velocity in m/s. Shape (range, hydrometeor, hydrometeorBin)

  • pathIntegratedAttenuation – path integrated attenuation in dB

  • height – altitude in m

  • verticalWind – vertical wind in m/s

  • horizontalWind – horizontal wind in m/s

  • eddyDissipationRate – eddy dissipation rate in m^(2/3) s^(-1)

  • wavelength – wavelength in m

  • radarMaxV – maximum radar nyquist velocity in m/s (Default value = 7.885)

  • radarMinV – minimum radar nyquist velocity in m/s (Default value = -7.885)

  • radarAliasingNyquistInterv – defines how often the spectrum is folded to consider aliasing (default 1) (Default value = 1)

  • radarNFFT – bins of the radar spectrum (Default value = 256)

  • radarAirmotion – consider vertical air motion (Default value = True)

  • radarAirmotionModel (["constant","linear","step"]) – (Default value = “constant”)

  • radarAirmotionVmin – (Default value = 0)

  • radarAirmotionVmax – (Default value = 0)

  • radarAirmotionLinearSteps – (Default value = 30)

  • radarAirmotionStepVmin – (Default value = 0.5)

  • radarPNoise1000 – Radar noise at 1 km range in dB (Default value = -30)

  • radarK2 – dielectric constant |K|² (always for liquid water by convention) for the radar equation (Default value = 0.93)

  • radarNAve – radar number of averages (Default value = 150)

  • radarBeamwidthDeg – radar full beam width 2-way 6dB drop (Default value = 0.2)

  • radarIntegrationTime – radar integration time (Default value = 60)

  • seed – Seed of the random number generator. 0 means the seed is randomly generated (Default value = 0)

  • verbosity – Fortran verbosity level (Default value = 0)

Returns

radar_spectrum – Simulated radar spectrum in mm6/m3/(m/s).

Return type

array_like

createRadarSpectrum(diameterSpec, specWidth, backSpec, fallVelSpec, verticalWind, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarAirmotion=True, radarAirmotionModel='constant', radarAirmotionVmin=0, radarAirmotionVmax=0, radarAirmotionLinearSteps=30, radarAirmotionStepVmin=0.5, radarK2=0.93, verbosity=0)[source]

First step of the radar simulator which creates an idealized radar spectrum for each hydrometeor.

Parameters

  • diameterSpec (array_like) – Hydrometeo Diameter in m. Shape (range, hydrometeor, hydrometeorBin)

  • backSpec (array_like) – Hydrometeo backscattering cross section in m2. Shape (range, hydrometeor, hydrometeorBin)

  • fallVelSpec – Fall velocity in m/s. Shape (range, hydrometeor, hydrometeorBin)

  • pressure (array_like) – Pressure in pa

  • wavelength (array_like) – wavelength in m

  • radarMaxV – maximum radar nyquist velocity in m/s (Default value = 7.885)

  • radarMinV – minimum radar nyquist velocity in m/s (Default value = -7.885)

  • radarAliasingNyquistInterv – defines how often the spectrum is folded to consider aliasing (default 1) (Default value = 1)

  • radarNFFT – bins of the radar spectrum (Default value = 256)

  • radarAirmotion – consider vertical air motion (Default value = True)

  • radarAirmotionModel (["constant","linear","step"]) – (Default value = “constant”)

  • radarAirmotionVmin – (Default value = 0)

  • radarAirmotionVmax – (Default value = 0)

  • radarAirmotionLinearSteps – (Default value = 30)

  • radarAirmotionStepVmin – (Default value = 0.5)

  • radarK2 – dielectric constant |K|² (always for liquid water by convention) for the radar equation (Default value = 0.93)

  • verbosity – Fortran verbosity level (Default value = 0)

Returns

particleSpec – Idealized radar spectrum in mm6/m3.

Return type

array_like

simulateRadarSpectrum(height, eddyDissipationRate, horizontalWind, mergedParticleSpec, pathIntegratedAttenuation, wavelength, radarMaxV=7.885, radarMinV=-7.885, radarAliasingNyquistInterv=1, radarNFFT=256, radarPNoise1000=-30, radarK2=0.93, radarNAve=150, radarBeamwidthDeg=0.2, radarIntegrationTime=60, seed=0, verbosity=0)[source]
Parameters

  • height – altitude in m

  • eddyDissipationRate – eddy dissipation rate in m^(2/3) s^(-1)

  • horizontalWind – horizontal wind in m/s

  • mergedParticleSpec – idealized radar spectrum in mm6/m3. Sum for all hydrometeors.

  • pathIntegratedAttenuation – path integrated attenuation in dB

  • wavelength – wavelength in m

  • radarMaxV – maximum radar nyquist velocity in m/s (Default value = 7.885)

  • radarMinV – minimum radar nyquist velocity in m/s (Default value = -7.885)

  • radarAliasingNyquistInterv – defines how often the spectrum is folded to consider aliasing (Default value = 1)

  • radarNFFT – bins of the radar spectrum (Default value = 256)

  • radarPNoise1000 – Radar noise at 1 km range in dB (Default value = -30)

  • radarK2 – dielectric constant |K|² (always for liquid water by convention) for the radar equation (Default value = 0.93)

  • radarNAve – radar number of averages (Default value = 150)

  • radarBeamwidthDeg – radar full beam width 2-way 6dB drop (Default value = 0.2)

  • radarIntegrationTime – radar integration time (Default value = 60)

  • seed – Seed of the random number generator. 0 means the seed is randomly generated (Default value = 0)

  • verbosity – Fortran verbosity level (Default value = 0)

calcSpectralBroadening(eddyDissipationRate, horizontalWind, height, wavelength, radarBeamwidthDeg=0.2, radarIntegrationTime=60, kolmogorov=0.5, verbosity=0)[source]

Estimate the spectral broadening due to turbulence and horizontal wind.

Parameters

  • eddyDissipationRate (array_like) – eddy dissipation rate in m^(2/3) s^(-1)

  • horizontalWind (array_like) – horizontal wind in m/s

  • height (array_like) – heigth in m

  • radarBeamwidthDeg (float) – Full width half power Beamwidth in degrees (Default value = 0.2)

  • radarIntegrationTime (float) – Integration time in seconds (Default value = 60)

  • wavelength (float) – wavelength in m

  • kolmogorov (float, optional) – Kolmogorov constant (default 0.5)

  • verbosity (integer, optional) – Define verbosity level (default 0)

Returns

radar_spectrum – Simulated radar spectrum in mm6/m3/(m/s).

Return type

array_like