Skip to content

Latest commit

 

History

History
107 lines (62 loc) · 2.85 KB

README.md

File metadata and controls

107 lines (62 loc) · 2.85 KB

disdRo DOI

An R package for reading and handling meteorological particle size and velocity distribution (PSVD), or disdrometric matrix data, from raw data files generated by Thies LPM or Ott Parsivel optical disdrometers.

You can cite this package on your work as: Beguería S., Latorre B. (2017) disdRo: an R package for working with disdrometric data, http://doi.org/10.5281/zenodo.1186384.

Details

Disdrometers are devices used to measure the particle size distribution and velocity of falling hydrometeors. They have multiple uses in automatic meterological networks and in climatology. The Thies LPM and the Ott Parsivel are among the most common commercial disdrometers. This package allows reading and working with raw data files generated by these two disdrometers, within R.

It currently conatains the workhorse functions dsd_read(), dsd_integrate() and dsd_plot(), but other functionalities may be added in the future. Support for other disdrometer types may be also be incorporated, althought there are no fixed plans for that.

Installation

Install the latest stable development version from GitHub:

library(devtools)
install_github('sbegueria/disdRo', build_vignettes=TRUE)

You can of course skip the vignettes to save compilation time.

Using the package

Once installed, you should load the package:

library(disdRo)

Consult the help page of the package:

help(package='disdRo')

You can check the help pages for the individual functions, or the more more comprehensive user guide (vignette). The vignettes can also be accessed directly in your browser via:

browseVignettes('disdRo')

Finally, you can also find the html vignettes on github, on the 'disdRo/vignettes' directory.

Authors

Santiago Beguería (author, creator).

Borja Latorre (author).

Marta Angulo-Martínez (contributor).

References

This software has been used in the following research articles:

Angulo-Martínez M., Beguería S., Latorre B., and Fernández-Raga M., Comparison of precipitation measurements by OTT Parsivel2 and Thies LPM optical disdrometers, Hydrol. Earth Syst. Sci. 22:2811-2837, 2018.

Version history

Version 0.1, July 2017 (current on github).

First release of the disdRo package.

To do list for next version (work in progress)

  • Make the functions more flexible to allow for other telegram configurations

Got problems?

Feel free to write an issue if you have any questions or problems.

Copyright and license

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.