[](https://github.com/pycomlink/pycomlink/actions/workflows/main.yml)
[](https://mybinder.org/v2/gh/pycomlink/pycomlink/master)
[](https://pycomlink.readthedocs.io/en/latest/)
[](https://doi.org/10.5281/zenodo.4810169)
Anaconda Version [](https://anaconda.org/conda-forge/pycomlink) [](https://anaconda.org/conda-forge/pycomlink)
pycomlink
=========
A python toolbox for deriving rainfall information from commercial microwave link (CML) data.
Installation
------------
`pycomlink` is tested with Python 3.9, 3.10 and 3.11. There have been problems with Python 3.8, see https://github.com/pycomlink/pycomlink/pull/120. Many things might work with older version, but there is no support for this.
It can be installed via [`conda-forge`](https://conda-forge.org/):
$ conda install -c conda-forge pycomlink
If you are new to `conda` or if you are unsure, it is recommended to [create a new conda environment, activate it](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands), [add the conda-forge channel](https://conda-forge.org/) and then install.
Installation via `pip` is also possible:
$ pip install pycomlink
At the time of writing, with `pycomlink v0.4.0` which dropped `tensorflow` as dependency, `pip` install works fine. But, if we add new dependencies in the future, we might again run into issues with `pip` install.
To run the example notebooks you will also need the [Jupyter Notebook](https://jupyter.org/)
and `ipython`, both also available via `conda` or `pip`.
If you want to clone the repository for developing purposes follow these steps (installation of Jupyter Notebook included):
$ git clone https://github.com/pycomlink/pycomlink.git
$ cd pycomlink
$ conda env create -f environment_dev.yml
$ conda activate pycomlink-dev
$ cd ..
$ pip install -e pycomlink
Usage
-----
The following jupyter notebooks showcase some use cases of `pycomlink`
* [Basic example CML processing workflow](http://nbviewer.jupyter.org/github/pycomlink/pycomlink/blob/master/notebooks/Basic%20CML%20processing%20workflow.ipynb)
* [Compare interpolation methods](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Compare%20interpolation%20methods.ipynb)
* [Get radar data along CML paths](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Get%20radar%20rainfall%20along%20CML%20paths.ipynb)
* [Nearby-link approach for rain event detection from RAINLINK](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Nearby%20link%20approach%20processing%20example.ipynb)
* [Compare different WAA methods](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Wet%20antenna%20attenuation.ipynb)
* [Detect data gaps stemming from heavy rainfall events that cause a loss of connection along a CML](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Blackout%20gap%20detection%20examples.ipynb)
Note that the links point to static versions of the example notebooks. You can run all these notebook online via mybinder if you click on the "launch binder" buttom at the top.
Features
--------
* Perform all required CML data processing steps to derive rainfall information from raw signal levels:
* data sanity checks
* ~~anomaly detection~~ (removed because using outdated `tensorflow` code)
* wet/dry classification
* baseline calculation
* wet antenna correction
* transformation from attenuation to rain rate
* Generate rainfall maps from the data of a CML network
* Validate you results against gridded rainfall data or rain gauges networks
Documentation
-------------
The documentation is hosted by readthedocs.org: [https://pycomlink.readthedocs.io/en/latest/](https://pycomlink.readthedocs.io/en/latest/)
Raw data
{
"_id": null,
"home_page": "https://github.com/pycomlink/pycomlink",
"name": "pycomlink",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "microwave links precipitation radar cml",
"author": "Christian Chwala",
"author_email": "christian.chwala@kit.edu",
"download_url": "https://files.pythonhosted.org/packages/bf/ff/07166b5573d283c02cec31fd2aabfeb6a263f783639dedd7fc632f951deb/pycomlink-0.4.1.tar.gz",
"platform": null,
"description": "[](https://github.com/pycomlink/pycomlink/actions/workflows/main.yml)\n[](https://mybinder.org/v2/gh/pycomlink/pycomlink/master)\n[](https://pycomlink.readthedocs.io/en/latest/)\n[](https://doi.org/10.5281/zenodo.4810169)\n\nAnaconda Version [](https://anaconda.org/conda-forge/pycomlink) [](https://anaconda.org/conda-forge/pycomlink)\n\npycomlink\n=========\n\nA python toolbox for deriving rainfall information from commercial microwave link (CML) data.\n\nInstallation\n------------\n\n`pycomlink` is tested with Python 3.9, 3.10 and 3.11. There have been problems with Python 3.8, see https://github.com/pycomlink/pycomlink/pull/120. Many things might work with older version, but there is no support for this.\n\nIt can be installed via [`conda-forge`](https://conda-forge.org/):\n\n $ conda install -c conda-forge pycomlink\n\nIf you are new to `conda` or if you are unsure, it is recommended to [create a new conda environment, activate it](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands), [add the conda-forge channel](https://conda-forge.org/) and then install.\n\nInstallation via `pip` is also possible:\n\n $ pip install pycomlink\n\nAt the time of writing, with `pycomlink v0.4.0` which dropped `tensorflow` as dependency, `pip` install works fine. But, if we add new dependencies in the future, we might again run into issues with `pip` install.\n\nTo run the example notebooks you will also need the [Jupyter Notebook](https://jupyter.org/)\nand `ipython`, both also available via `conda` or `pip`.\n\nIf you want to clone the repository for developing purposes follow these steps (installation of Jupyter Notebook included):\n\n $ git clone https://github.com/pycomlink/pycomlink.git\n $ cd pycomlink\n $ conda env create -f environment_dev.yml\n $ conda activate pycomlink-dev\n $ cd ..\n $ pip install -e pycomlink\n\nUsage\n-----\n\nThe following jupyter notebooks showcase some use cases of `pycomlink`\n\n * [Basic example CML processing workflow](http://nbviewer.jupyter.org/github/pycomlink/pycomlink/blob/master/notebooks/Basic%20CML%20processing%20workflow.ipynb)\n * [Compare interpolation methods](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Compare%20interpolation%20methods.ipynb)\n * [Get radar data along CML paths](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Get%20radar%20rainfall%20along%20CML%20paths.ipynb)\n * [Nearby-link approach for rain event detection from RAINLINK](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Nearby%20link%20approach%20processing%20example.ipynb)\n * [Compare different WAA methods](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Wet%20antenna%20attenuation.ipynb)\n * [Detect data gaps stemming from heavy rainfall events that cause a loss of connection along a CML](https://nbviewer.org/github/pycomlink/pycomlink/blob/master/notebooks/Blackout%20gap%20detection%20examples.ipynb)\n\nNote that the links point to static versions of the example notebooks. You can run all these notebook online via mybinder if you click on the \"launch binder\" buttom at the top.\n\nFeatures\n--------\n\n * Perform all required CML data processing steps to derive rainfall information from raw signal levels:\n * data sanity checks\n * ~~anomaly detection~~ (removed because using outdated `tensorflow` code)\n * wet/dry classification\n * baseline calculation\n * wet antenna correction\n * transformation from attenuation to rain rate\n * Generate rainfall maps from the data of a CML network\n * Validate you results against gridded rainfall data or rain gauges networks\n \nDocumentation\n-------------\nThe documentation is hosted by readthedocs.org: [https://pycomlink.readthedocs.io/en/latest/](https://pycomlink.readthedocs.io/en/latest/)\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Python tools for CML (commercial microwave link) data processing",
"version": "0.4.1",
"project_urls": {
"Download": "https://github.com/pycomlink/pycomlink/archive/0.4.1.tar.gz",
"Homepage": "https://github.com/pycomlink/pycomlink"
},
"split_keywords": [
"microwave",
"links",
"precipitation",
"radar",
"cml"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dbc9c0010ea0960ccf4788393419526b5a77ae4e1aef409d4ee25f24e8989143",
"md5": "2f6febd8e131eadf207551b01dbbe5fb",
"sha256": "e46539697006b1cc71f4212eab2046fec77af036710c7b49dba8f7cf744c79ff"
},
"downloads": -1,
"filename": "pycomlink-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f6febd8e131eadf207551b01dbbe5fb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 25539632,
"upload_time": "2024-11-18T17:51:21",
"upload_time_iso_8601": "2024-11-18T17:51:21.096925Z",
"url": "https://files.pythonhosted.org/packages/db/c9/c0010ea0960ccf4788393419526b5a77ae4e1aef409d4ee25f24e8989143/pycomlink-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bfff07166b5573d283c02cec31fd2aabfeb6a263f783639dedd7fc632f951deb",
"md5": "f91ce1f07c0b5022aa6472043468a85c",
"sha256": "615ed1a5482915807119ad3c6af60c2840501fa7f2e7f15d30ae588185059f7f"
},
"downloads": -1,
"filename": "pycomlink-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "f91ce1f07c0b5022aa6472043468a85c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 30158506,
"upload_time": "2024-11-18T17:51:37",
"upload_time_iso_8601": "2024-11-18T17:51:37.618960Z",
"url": "https://files.pythonhosted.org/packages/bf/ff/07166b5573d283c02cec31fd2aabfeb6a263f783639dedd7fc632f951deb/pycomlink-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-18 17:51:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pycomlink",
"github_project": "pycomlink",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "pandas",
"specs": []
},
{
"name": "matplotlib",
"specs": []
},
{
"name": "numba",
"specs": []
},
{
"name": "h5py",
"specs": []
},
{
"name": "xarray",
"specs": []
},
{
"name": "sparse",
"specs": []
},
{
"name": "netcdf4",
"specs": []
},
{
"name": "shapely",
"specs": []
},
{
"name": "pyproj",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "pykrige",
"specs": []
},
{
"name": "scikit-learn",
"specs": []
},
{
"name": "future",
"specs": []
},
{
"name": "bottleneck",
"specs": []
},
{
"name": "poligrain",
"specs": []
}
],
"lcname": "pycomlink"
}
JSON
