# Radar Data
This is a collection of radar data readers
These formats are currently supported
- WDSS-II
- CF-Radial 1.3 / CF-1.6
- CF-Radial 1.4 / CF-1.6
- CF-Radial 1.4 / CF-1.7
- CF-Radial 2.0 (draft)
- NEXRAD Level II
## Installation
```shell
pip install radar-data
```
## Examples
```python
import radar
# Get the absolute path of the .nc file, reader automatically gets -V, -W, etc.
file = os.path.expanduser("~/Downloads/data/PX-20240529-150246-E4.0-Z.nc")
sweep = radar.read(file)
# It also works with providing the original .tar.xz or .txz archive
file = os.path.expanduser("~/Downloads/data/PX-20240529-150246-E4.0.txz")
sweep = radar.read(file)
# NEXRAD LDM data feed, simply supply any of the files, the reader reads sweep_index=0 by default
file = os.path.expanduser("~/Downloads/data/KTLX/861/KTLX-20250503-122438-861-1-S")
sweep = radar.read(file)
# The reader finds others in ~/Downloads/data/KTLX/861/ to get to sweep_index=1
file = os.path.expanduser("~/Downloads/data/KTLX/861/KTLX-20250503-122438-861-7-I")
sweep = radar.read(file, sweep_index=1)
# NEXRAD complete volume
file = os.path.expanduser("~/Downloads/data/KTLX/20250503/KTLX20250503_122438_V06")
sweep = radar.read(file, sweep_index=1)
```
## DataShop
A data server for multi-threaded reading. An example use case would be to abstract the file reading backend to this service so that multiple requests can be pipelined.
```text
usage: datashop [-h] [-c COUNT] [-d DIR] [-H HOST] [-p PORT] [-t TEST] [-v] [--delay] [--version] [source ...]
Datashop
Examples:
datashop -v settings.yaml
datashop -v -H 10.197.14.52 -p 50001 -c 4 -t /mnt/data/PX1000/2024/20241219/_original
positional arguments:
source configuration
options:
-h, --help show this help message and exit
-c COUNT, --count COUNT
count
-d DIR, --dir DIR directory
-H HOST, --host HOST host
-p PORT, --port PORT port
-t TEST, --test TEST test using directory
-v increases verbosity
--delay simulate request delays
--version show program's version number and exit
```
## Unit Tests
To run a set of reading tests through `pytest`:
```shell
pytest -s
```
Raw data
{
"_id": null,
"home_page": null,
"name": "radar-data",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "radar, data, weather",
"author": null,
"author_email": "Boonleng Cheong <boonleng@ou.edu>",
"download_url": "https://files.pythonhosted.org/packages/6d/e3/3bbfe67f5373adda94e98e588570c0692ad18e83e4d75619ffea1d5b89b5/radar_data-1.4.tar.gz",
"platform": null,
"description": "# Radar Data\n\nThis is a collection of radar data readers\n\nThese formats are currently supported\n\n- WDSS-II\n- CF-Radial 1.3 / CF-1.6\n- CF-Radial 1.4 / CF-1.6\n- CF-Radial 1.4 / CF-1.7\n- CF-Radial 2.0 (draft)\n- NEXRAD Level II\n\n## Installation\n\n```shell\npip install radar-data\n```\n\n## Examples\n\n```python\nimport radar\n\n# Get the absolute path of the .nc file, reader automatically gets -V, -W, etc.\nfile = os.path.expanduser(\"~/Downloads/data/PX-20240529-150246-E4.0-Z.nc\")\nsweep = radar.read(file)\n\n# It also works with providing the original .tar.xz or .txz archive\nfile = os.path.expanduser(\"~/Downloads/data/PX-20240529-150246-E4.0.txz\")\nsweep = radar.read(file)\n\n# NEXRAD LDM data feed, simply supply any of the files, the reader reads sweep_index=0 by default\nfile = os.path.expanduser(\"~/Downloads/data/KTLX/861/KTLX-20250503-122438-861-1-S\")\nsweep = radar.read(file)\n\n# The reader finds others in ~/Downloads/data/KTLX/861/ to get to sweep_index=1\nfile = os.path.expanduser(\"~/Downloads/data/KTLX/861/KTLX-20250503-122438-861-7-I\")\nsweep = radar.read(file, sweep_index=1)\n\n# NEXRAD complete volume\nfile = os.path.expanduser(\"~/Downloads/data/KTLX/20250503/KTLX20250503_122438_V06\")\nsweep = radar.read(file, sweep_index=1)\n```\n\n## DataShop\n\nA data server for multi-threaded reading. An example use case would be to abstract the file reading backend to this service so that multiple requests can be pipelined.\n\n```text\nusage: datashop [-h] [-c COUNT] [-d DIR] [-H HOST] [-p PORT] [-t TEST] [-v] [--delay] [--version] [source ...]\n\nDatashop\n\nExamples:\n datashop -v settings.yaml\n datashop -v -H 10.197.14.52 -p 50001 -c 4 -t /mnt/data/PX1000/2024/20241219/_original\n\npositional arguments:\n source configuration\n\noptions:\n -h, --help show this help message and exit\n -c COUNT, --count COUNT\n count\n -d DIR, --dir DIR directory\n -H HOST, --host HOST host\n -p PORT, --port PORT port\n -t TEST, --test TEST test using directory\n -v increases verbosity\n --delay simulate request delays\n --version show program's version number and exit\n```\n\n## Unit Tests\n\nTo run a set of reading tests through `pytest`:\n\n```shell\npytest -s\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Radar Data",
"version": "1.4",
"project_urls": {
"Repository": "https://github.com/ouradar/radar-data"
},
"split_keywords": [
"radar",
" data",
" weather"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6de33bbfe67f5373adda94e98e588570c0692ad18e83e4d75619ffea1d5b89b5",
"md5": "04127b9e71c1fa2b6b5ec39ba60b781d",
"sha256": "3e95470a20f16d77e0f6157171b7aef6a85370d91bb68993519efe60d084cb45"
},
"downloads": -1,
"filename": "radar_data-1.4.tar.gz",
"has_sig": false,
"md5_digest": "04127b9e71c1fa2b6b5ec39ba60b781d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3505889,
"upload_time": "2025-09-05T15:40:01",
"upload_time_iso_8601": "2025-09-05T15:40:01.256425Z",
"url": "https://files.pythonhosted.org/packages/6d/e3/3bbfe67f5373adda94e98e588570c0692ad18e83e4d75619ffea1d5b89b5/radar_data-1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-05 15:40:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ouradar",
"github_project": "radar-data",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "multiprocess",
"specs": []
},
{
"name": "netCDF4",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "setproctitle",
"specs": []
}
],
"lcname": "radar-data"
}
JSON
