Functions

mcradar.utilities.db2lin(data)

Convert from logarithm to linear units

Parameters

data (single value or an array) –

Returns

Return type

returns the data converted to linear

mcradar.utilities.lin2db(data)

Convert from linear to logarithm units

Parameters

data (single value or an array) –

Returns

Return type

returns the data converted to dB

mcradar.tableOperator.calcRho(mcTable)

Calculate the density of each super particles.

Parameters

mcTable (output from getMcSnowTable()) –

Returns

  • mcTable with an additional column for the density.

  • The density is calculated separately for aspect ratio < 1

  • and for aspect ratio >= 1.

mcradar.tableOperator.creatKdpCols(mcTable, wls)

Create the KDP column

Parameters

  • mcTable (output from getMcSnowTable()) –

  • wls (wavelenght (iterable) [mm]) –

Returns

  • mcTable with an empty column ‘sKDP_’ for*

  • storing the calculated KDP of a given wavelength.

mcradar.tableOperator.creatZeCols(mcTable, wls)

Create the KDP column

Parameters

  • mcTable (output from getMcSnowTable()) –

  • wls (wavelenght (iterable) [mm]) –

Returns

  • mcTable with an empty columns ‘sZe*_’ for*

  • storing Ze_H and Ze_V of one particle of a

  • given wavelength

mcradar.tableOperator.getMcSnowTable(mcSnowPath)

Read McSnow output table

Parameters

mcSnowPath (path for the output from McSnow) –

Returns

  • Pandas DataFrame with the columns named after the local

  • variable ‘names’. This DataFrame additionally includes

  • a column for the radii and the density [sRho]. The

  • velocity is negative towards the ground.

mcradar.radarOperator.spectraOperator.getMultFrecSpec(wls, mcTable, velBins, velCenterBins, centerHeight)

Calculation of the multi-frequency spectrograms

Parameters

  • wls (wavelenght (iterable) [mm]) –

  • mcTable (McSnow output returned from calcParticleZe()) –

  • velBins (velocity bins for the calculation of the spectrogram (array) [m/s]) –

  • velCenterBins (center of the velocity bins (array) [m/s]) –

  • centerHeight (center height of each range gate (array) [m]) –

Returns

  • xarray dataset with the multi-frequency spectrograms

  • xarray dims = (range, vel)

mcradar.radarOperator.spectraOperator.getVelIntSpec(mcTable, mcTable_binned, variable)

Calculates the integrated reflectivity for each velocity bin

Parameters

  • mcTable (McSnow output returned from calcParticleZe()) –

  • mcTable_binned (McSnow table output binned for a given velocity bin) –

  • variable (name of column variable wich will be integrated over a velocity bin) –

Returns

mcTableVelIntegrated

Return type

table with the integrated reflectivity for each velocity bin