.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wrainfo_logo.png
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo
:align: center
==============================================================
WRaINfo - An Open Source Library for Weather Radar Information
==============================================================
is a software for real-time weather radar data processing. It is specifically designed for X-band weather radars of FURUNO.
.. image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/badges/main/pipeline.svg
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/pipelines
.. image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/badges/main/coverage.svg
:target: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/coverage/
.. image:: https://img.shields.io/static/v1?label=Documentation&message=GitLab%20Pages&color=orange
:target: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/
.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7220833.svg
:target: https://doi.org/10.5281/zenodo.7220833
For detailed information, refer to the `documentation <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/>`_.
See also the latest coverage_ report and the pytest_ HTML report.
* **Contact**: Alice Künzel (alicek@gfz-potsdam.de)
* Information on how to **cite the WRaINfo Python package** can be found in the `CITATION <CITATION.rst>`__ file.
* Please **cite also the Wradlib Python package** as follows:
An Open Source Library for Weather Radar Data Processing
Heistermann, M., Jacobi, S., and Pfaff, T.: Technical Note: An open source library for processing weather
radar data (wradlib), Hydrol. Earth Syst. Sci., 17, 863-871, doi:10.5194/hess-17-863-2013, 2013
.. contents:: Table of Contents
:depth: 2
=================
Features overview
=================
The FURUNO raw data can already provide useful visual information about the
spatial distribution of precipitation events. But in order to use the FURUNO
data for quantitatvie studies, the raw data has to be processed in order to account
for typical error sources such as ground clutter, uncertainities in polarimetric
variables and in the z-R relationship as well as attenuation of the radar signal.
Therefore this python package has been developed for processing FURUNO weather radar
data.
Remove ground clutter
---------------------
To remove ground clutter from raw data exists a function from wradlib based on all
polarimetric variables and on a static clutter map, which is generated over a long time period.
Pixel which are identified as clutter were exclude from further processing by set the pixels to NaN.
For processing a clutter map, the package includes a function to read only the values from raw data sequentially to not overload the memory.
Here is an example before and after removing ground clutter using WRaINfo.
.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_comparison_of_raw_reflectivity_and_clutter_corrected_reflectivity.png
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo
:width: 80 %
Attenuation correction
----------------------
Rainfall-induced attenuation is a major source of underestimation for radar-based precipitation estimation at X-band.
After phase processing, the attenuation correction is used with the approach of `Testud et al. (2001) <https://www.sciencedirect.com/science/article/pii/S1464190900001155?via%3Dihub>`__ is used.
Here is an example before and after attenuation correction using WRaINfo.
.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_reflectivity_before_and_after_attenaution_correction.png
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo
:width: 80 %
Precipitation Estimation
------------------------
There are several methods for deriving the amount of precipitation from reflectivity. In general, the z - R conversion is used.
The precipitation amount is determined with an integration interval of seconds based on the scan interval.
.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_reflectivity_attenaution_corrected_and_estimated_precipitation.png
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo
:width: 80 %
Georeferencing and gridding
---------------------------
After clutter and attenuation correction and precipitation estimation, the polar data are georeferenced using the specified EPSG code
and saved as a NetCDF file. Here is an example of a georeferenced dataset.
.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_georeferenced_and_gridded_precipitation_data_with_WRaINfo.png
:target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo
:width: 80 %
============
Installation
============
`Install <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/installation.html>`_ wrainfo
===================
History / Changelog
===================
You can find the protocol of recent changes in the WRaINfo package
`here <HISTORY.rst>`__.
=======
License
=======
The software is available under the `Apache 2.0 <LICENSE/>`_.
============
Contribution
============
`Contributions <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/contributing.html>`__ are always welcome.
=================
Data availability
=================
Preprocessed FURUNO weather radar data (level 2a) for the Neubrandenburg site are made available in the `TERENO Data DiscoveryPortal <https://ddp.tereno.net/ddp/>`__
under the `CC BY-NC 4.0 license <https://creativecommons.org/licenses/by-nc/4.0/>`__.
Please contact us (fernlab@gfz-potsdam.de), if you wish to use the data under another license (e.g. commercially).
========
Credits
========
.. |FERNLOGO| image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/fernlab_logo.png
:width: 10 %
.. list-table::
:class: borderless
* - |FERNLOGO|
- WRaINfo has been developed by `FERN.Lab <https://fernlab.gfz-potsdam.de/>`_, the Helmholtz Innovation Lab "Remote sensing for sustainable use of resources", located at the `Helmholtz Centre Potsdam, GFZ German Research Centre for Geosciences <https://www.gfz-potsdam.de/en/>`_. FERN.Lab is funded by the `Initiative and Networking Fund of the Helmholtz Association <https://www.helmholtz.de/en/about-us/structure-and-governance/initiating-and-networking/>`_.
Development Team:
- Alice Künzel, researcher
*Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*
- Kai Mühlbauer, researcher
*University of Bonn, Institute of Geosciences - Meteorology Section*
- Julia Neelmeijer, supervisor
*Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*
- Daniel Spengler, supervisor
*Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*
This package was created with Cookiecutter_ and the `fernlab/cookiecutter-pypackage`_ project template.
The test data represent raw data of the weather radar FURUNO and files which are created with the WRaINfo package.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`fernlab/cookiecutter-pypackage`: https://github.com/fernlab/cookiecutter-pypackage
.. _coverage: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/coverage/
.. _pytest: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/test_reports/report.html
Raw data
{
"_id": null,
"home_page": "https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo",
"name": "wrainfo",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "wrainfo,weather radar,X-Band,preprocessing,clutter detection,attenuation correction,precipitation estimation",
"author": "FernLab",
"author_email": "fernlab@gfz-potsdam.de",
"download_url": "https://files.pythonhosted.org/packages/61/73/ebf55d937fa4531e85ae96fde1e158a56a5fb5b3b96f551a47dc91ee28ab/wrainfo-0.9.5.tar.gz",
"platform": null,
"description": ".. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wrainfo_logo.png\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo\n :align: center\n\n\n==============================================================\nWRaINfo - An Open Source Library for Weather Radar Information\n==============================================================\n\nis a software for real-time weather radar data processing. It is specifically designed for X-band weather radars of FURUNO.\n\n.. image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/badges/main/pipeline.svg\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/pipelines\n.. image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/badges/main/coverage.svg\n :target: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/coverage/\n.. image:: https://img.shields.io/static/v1?label=Documentation&message=GitLab%20Pages&color=orange\n :target: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7220833.svg\n :target: https://doi.org/10.5281/zenodo.7220833\n\nFor detailed information, refer to the `documentation <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/>`_.\nSee also the latest coverage_ report and the pytest_ HTML report.\n\n* **Contact**: Alice K\u00fcnzel (alicek@gfz-potsdam.de)\n* Information on how to **cite the WRaINfo Python package** can be found in the `CITATION <CITATION.rst>`__ file.\n* Please **cite also the Wradlib Python package** as follows:\n\tAn Open Source Library for Weather Radar Data Processing\n\tHeistermann, M., Jacobi, S., and Pfaff, T.: Technical Note: An open source library for processing weather\n\tradar data (wradlib), Hydrol. Earth Syst. Sci., 17, 863-871, doi:10.5194/hess-17-863-2013, 2013\n\n\n.. contents:: Table of Contents\n :depth: 2\n\n=================\nFeatures overview\n=================\n\nThe FURUNO raw data can already provide useful visual information about the\nspatial distribution of precipitation events. But in order to use the FURUNO\ndata for quantitatvie studies, the raw data has to be processed in order to account\nfor typical error sources such as ground clutter, uncertainities in polarimetric\nvariables and in the z-R relationship as well as attenuation of the radar signal.\nTherefore this python package has been developed for processing FURUNO weather radar\ndata.\n\n\nRemove ground clutter\n---------------------\n\nTo remove ground clutter from raw data exists a function from wradlib based on all\npolarimetric variables and on a static clutter map, which is generated over a long time period.\nPixel which are identified as clutter were exclude from further processing by set the pixels to NaN.\nFor processing a clutter map, the package includes a function to read only the values from raw data sequentially to not overload the memory.\nHere is an example before and after removing ground clutter using WRaINfo.\n\n.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_comparison_of_raw_reflectivity_and_clutter_corrected_reflectivity.png\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo\n\t:width: 80 %\n\n\nAttenuation correction\n----------------------\n\nRainfall-induced attenuation is a major source of underestimation for radar-based precipitation estimation at X-band.\nAfter phase processing, the attenuation correction is used with the approach of `Testud et al. (2001) <https://www.sciencedirect.com/science/article/pii/S1464190900001155?via%3Dihub>`__ is used.\nHere is an example before and after attenuation correction using WRaINfo.\n\n.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_reflectivity_before_and_after_attenaution_correction.png\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo\n :width: 80 %\n\n\nPrecipitation Estimation\n------------------------\n\nThere are several methods for deriving the amount of precipitation from reflectivity. In general, the z - R conversion is used.\nThe precipitation amount is determined with an integration interval of seconds based on the scan interval.\n\n.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_reflectivity_attenaution_corrected_and_estimated_precipitation.png\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo\n :width: 80 %\n\n\nGeoreferencing and gridding\n---------------------------\n\nAfter clutter and attenuation correction and precipitation estimation, the polar data are georeferenced using the specified EPSG code\nand saved as a NetCDF file. Here is an example of a georeferenced dataset.\n\n.. figure:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/wr_furuno_georeferenced_and_gridded_precipitation_data_with_WRaINfo.png\n :target: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo\n :width: 80 %\n\n\n============\nInstallation\n============\n\n`Install <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/installation.html>`_ wrainfo\n\n===================\nHistory / Changelog\n===================\n\nYou can find the protocol of recent changes in the WRaINfo package\n`here <HISTORY.rst>`__.\n\n=======\nLicense\n=======\n\nThe software is available under the `Apache 2.0 <LICENSE/>`_.\n\n============\nContribution\n============\n\n`Contributions <https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/contributing.html>`__ are always welcome.\n\n=================\nData availability\n=================\n\nPreprocessed FURUNO weather radar data (level 2a) for the Neubrandenburg site are made available in the `TERENO Data DiscoveryPortal <https://ddp.tereno.net/ddp/>`__\nunder the `CC BY-NC 4.0 license <https://creativecommons.org/licenses/by-nc/4.0/>`__.\nPlease contact us (fernlab@gfz-potsdam.de), if you wish to use the data under another license (e.g. commercially).\n\n========\nCredits\n========\n\n.. |FERNLOGO| image:: https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/raw/main/docs/images/fernlab_logo.png\n :width: 10 %\n\n.. list-table::\n :class: borderless\n\n * - |FERNLOGO|\n\n - WRaINfo has been developed by `FERN.Lab <https://fernlab.gfz-potsdam.de/>`_, the Helmholtz Innovation Lab \"Remote sensing for sustainable use of resources\", located at the `Helmholtz Centre Potsdam, GFZ German Research Centre for Geosciences <https://www.gfz-potsdam.de/en/>`_. FERN.Lab is funded by the `Initiative and Networking Fund of the Helmholtz Association <https://www.helmholtz.de/en/about-us/structure-and-governance/initiating-and-networking/>`_.\n\n\nDevelopment Team:\n - Alice K\u00fcnzel, researcher\n *Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*\n - Kai M\u00fchlbauer, researcher\n *University of Bonn, Institute of Geosciences - Meteorology Section*\n - Julia Neelmeijer, supervisor\n *Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*\n - Daniel Spengler, supervisor\n *Helmholtz Centre Potsdam German Research Centre for Geosciences GFZ, Section 1.4 - Remote Sensing and Geoinformatics*\n\nThis package was created with Cookiecutter_ and the `fernlab/cookiecutter-pypackage`_ project template.\nThe test data represent raw data of the weather radar FURUNO and files which are created with the WRaINfo package.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`fernlab/cookiecutter-pypackage`: https://github.com/fernlab/cookiecutter-pypackage\n.. _coverage: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/coverage/\n.. _pytest: https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/test_reports/report.html\n",
"bugtrack_url": null,
"license": "Apache Software License 2.0",
"summary": "Is a software to process FURUNO weather radar data.",
"version": "0.9.5",
"project_urls": {
"Change log": "https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo/-/blob/main/HISTORY.rst",
"Documentation": "https://fernlab.git-pages.gfz-potsdam.de/products/furuno/wrainfo/doc/",
"Homepage": "https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo",
"Source code": "https://git.gfz-potsdam.de/fernlab/products/furuno/wrainfo"
},
"split_keywords": [
"wrainfo",
"weather radar",
"x-band",
"preprocessing",
"clutter detection",
"attenuation correction",
"precipitation estimation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6173ebf55d937fa4531e85ae96fde1e158a56a5fb5b3b96f551a47dc91ee28ab",
"md5": "6975be4cec116b45352861ac491ce2b6",
"sha256": "f590e7d1fa602b1a9d4f2ea6e7fc9a1bee4643216b102d792d85291b6db2fb52"
},
"downloads": -1,
"filename": "wrainfo-0.9.5.tar.gz",
"has_sig": false,
"md5_digest": "6975be4cec116b45352861ac491ce2b6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 6504587,
"upload_time": "2023-07-07T07:25:18",
"upload_time_iso_8601": "2023-07-07T07:25:18.953074Z",
"url": "https://files.pythonhosted.org/packages/61/73/ebf55d937fa4531e85ae96fde1e158a56a5fb5b3b96f551a47dc91ee28ab/wrainfo-0.9.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-07 07:25:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "wrainfo"
}
JSON