User Tools

Site Tools


software:improtoo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
software:improtoo [2013/01/17 09:54]
max [How to use]
software:improtoo [2016/04/07 19:52] (current)
Line 1: Line 1:
 ====== IMProToo - Improved Mrr Processing Tool ====== ====== IMProToo - Improved Mrr Processing Tool ======
  
 +The code moved to: [[https://​github.com/​maahn/​IMProToo]]
  
- 
-IMProToo is an improved processing method for Micro Rain radar. It is especially suited for snow observations and provides besides other things effective reflectivity,​ Doppler velocity and spectral width. The method features a noise removal based on recognition of the most significant peak and a dynamic dealiasing routine which allows observations even if the Nyquist velocity range is exceeded. To software requires MRR raw data, it does not work with Metek'​s standard products MRR Averaged Data or Processed Data. 
- 
-Please note that this software was developed for observations at low SNR ratios such as snow, drizzle or light rain. Heavy rain, especially in combination with strong turbulence, might give wrong results. 
- 
-The software can be used under the [[http://​en.wikipedia.org/​wiki/​GNU_General_Public_License|GPL license]] 
- 
-=====How does it work===== 
- 
-The routine is described in //Maahn, M. and Kollias, P.: Improved Micro Rain Radar snow measurements using Doppler spectra post-processing,​ Atmos. Meas. Tech. Discuss., 5, 4771-4808, doi:​10.5194/​amtd-5-4771-2012,​ 2012.// [[http://​www.atmos-meas-tech-discuss.net/​5/​4771/​2012/​amtd-5-4771-2012.html]] 
  
 =====Download===== =====Download=====
  
  
-The software ​is still betaespecially the documentation needs to be enhanced.+OLD versions, see https://​github.com/​maahn/​IMProToo/​releases for most recent release! 
 +  * {{:software:​improtoo:​improtoo_0.99.zip|IMProToo_v0.99.zip}} changed units of slope to dB/(m/s)of eta to mm^6/m^3 (17 January 2013)
   * {{:​software:​improtoo:​improtoo_0.98.zip|IMProToo_v0.98.zip}} fixed calculation of kurtosis and skewness (6 August 2012)    * {{:​software:​improtoo:​improtoo_0.98.zip|IMProToo_v0.98.zip}} fixed calculation of kurtosis and skewness (6 August 2012) 
   * {{:​software:​improtoo:​improtoo_0.97.zip|IMProToo_v0.97.zip}} netcdf bugfixes (18 July 2012)    * {{:​software:​improtoo:​improtoo_0.97.zip|IMProToo_v0.97.zip}} netcdf bugfixes (18 July 2012) 
Line 22: Line 14:
  
  
- 
-===== How to install ===== 
- 
-The software is developed for python 2.7 and should run on any recent Linux system (and most likely also Mac OS X). Windows is currently not supported, but probably only minor changes are necessary. 
- 
-The following python packages are required: 
-  * numpy 
-  * matplotlib (for plotting only) 
-  * [[http://​code.google.com/​p/​netcdf4-python/​|netcdf4-python]] OR python-netcdf (for saving the results only) 
- 
- 
-An installation routine is not provided, Instead, save the included files in your working directory and import the package using "​import IMProToo"​. If you want to save the files in another directory, you have to add this directory to your [[http://​stackoverflow.com/​questions/​3108285/​in-python-script-how-do-i-set-pythonpath|python path]]. If you have root permissions,​ you can also put the files into your python library directory (usually /​usr/​lib/​python). 
- 
-===== How to use ==== 
- 
-To use the toolkit, start python and import it: 
- 
-  import IMProToo 
- 
-read the raw data file (can be gzip-compressed) 
- 
-  rawData = IMProToo.mrrRawData("​mrrRawFile.mrr.gz"​) 
- 
-create the IMProToo object and load rawData 
-  processedSpec = IMProToo.MrrZe(rawData) 
- 
-if needed, average rawData to 60s 
-  processedSpec.averageSpectra(60) 
- 
-all settings (e.g. creator attribute of netCDF file, dealiasing) are available in the '​processedSpec.co'​ dictionary and must be set before calculating Ze etc. See the source code for a description of the settings. 
-  processedSpec.co["​ncCreator"​] = "​M.Maahn,​ IGM University of Cologne"​ 
-  processedSpec.co["​ncDescription"​] = "MRR data from Cologne"​ 
-  processedSpec.co["​dealiaseSpectrum"​] = True    ​ 
-  ​ 
-calculate Ze and other moments 
-  processedSpec.rawToSnow() 
- 
-write all variables to a netCDF file. 
-  processedSpec.writeNetCDF("​IMProToo_netCDF_file.nc",​ncForm="​NETCDF3_CLASSIC"​) 
- 
- 
- 
-===== Questions ===== 
-In case of any questions, please don't hesitate to contact Maximilian Maahn: mmaahn_(AT)_meteo_DOT_uni-koeln_DOT_de 
software/improtoo.1358412867.txt.gz · Last modified: 2016/04/07 19:54 (external edit)