xradar

Xradar包含将您的天气雷达数据转换为xarray数据模型所需的所有工具。

• 免费软件：MIT许可证
• 文档：https://docs.openradarscience.org/projects/xradar

关于

在瑞士洛卡诺举行的ERAD2022会议期间的开发者会议上，对openradarscience社区的未来计划和跨包协作进行了深入讨论。

大家一致认为，只有通过联合项目，才能最大限度地发挥对整个社区有益的紧密合作。因此，诞生了一个共同软件项目的想法，其唯一任务是读取和写入雷达数据。数据导入应包括尽可能多的可用数据格式，但数据导出应限制在公认的标准化格式，如ODIM_H5和CfRadial。

作为内存表示，选择了基于xarray的数据模型，该模型内部适应即将到来的标准CfRadial2.1/FM301。FM301由联合专家小组（JET-OWR）强制执行。有关FM301的信息可在WMO CF扩展处获得。

任何以任何方式使用xarray的软件包都将能够直接使用所描述的数据模型，从而快速轻松地导入和导出雷达数据。另一个优点是可以轻松连接到已经存在的开源雷达处理软件。

状态

Xradar被认为对于从wradlib移植的已实现的读者和写入器是稳定的。它将继续处于测试状态，直到标准最终确定，API以及数据模型将进入稳定/生产状态。

特性

• 导入/导出CfRadial1数据
• 导入/导出CfRadial2数据
• 导入/导出ODIM_H5数据
• 导入GAMIC HDF5
• 导入Rainbow5
• 导入Iris/Sigmet
• 导入Furuno SCN/SCNX
• 地理参照（AEQD）
• 角度重索引

历史

0.6.5 (2024-09-20)

修复：现在正确标记了Halo Photonics数据的方位维度（{pull}206）@rcjackson。修复：不要在datamet读取器中应用缩放/偏移量，而是将其留给xarray（{pull}209）@kmuehlbauer。

0.6.4 (2024-08-30)

修复：笔记本现在符合ruff的样式检查（{pull}199）@rcjackson，（{pull}200）@kmuehlbauer。修复：使用dict.get()检索属性键，如果不可用则返回"None"，（{pull}200）@kmuehlbauer

0.6.3 (2024-08-13)

修复：使用rstart在米中使用ODIM_H5/V2_4（{issue}196）@kmuehlbauer，（{pull}197）@kmuehlbauer。

0.6.2 (2024-08-12)

• 修复：在"open_cfradial1_datatree"方法中将'engine'关键字参数传递给fsspec.open，以便在使用url时启用（{issue}194）@aladinor，（{pull}195）@aladinor

0.6.1 (2024-08-07)

• MNT：最小化CI（{pull}192）@kmuehlbauer。
• 修复：正确读取CfRadial1 n_points文件（{issue}188）@aladinor，（{pull}190）@kmuehlbauer。

0.6.0 (2024-08-05)

• 添加：DataMet读取器（{pull}175）@wolfidan。
• 修复：Nexrad level2时间偏移量为1天，跳过读取缺失的高度角，引入新的径向状态5（{issue}180）@ghiggi，（{pull}180）@kmuehlbauer。
• 添加：由@rcjackson提供的Halo Photonics多普勒激光雷达数据读取器

0.5.1 (2024-07-05)

• 添加：将Alfonso添加到引用文档中（{pull}169）@mgrover1。
• 增强：向iris datatree添加全局变量和属性（{pull}166）@aladinor。
• 修复：在导出到odim时，在应用缩放/偏移量之前设置fillvalue ({issue}122)，由 @pavlikp 完成修改， ({pull}173)，由 @kmuehlbauer 完成修改。
• 修复：修复了ruff、CI和numpy2的使用 ({pull}177)，由 @mgrover1 和 @kmuehlbauer 完成。

0.5.0 (2024-03-28)

• 维护：更新GitHub动作，处理DeprecationWarnings ({pull}153)，由 @kmuehlbauer 完成。
• 维护：重构odim.py/gamic.py，添加test_odim.py/test_gamic.py ({pull}154)，由 @kmuehlbauer 完成。
• 维护：使用CODECOV令牌 ({pull}155)，由 @kmuehlbauer 完成。
• 维护：修复notebook覆盖路径 ({pull}157)，由 @kmuehlbauer 完成。
• 新增：添加NEXRAD Level2结构化读取器 ({pull}158)，由 @kmuehlbauer 和 @mgrover1 完成。
• 修复：在固定角度中添加适当的仰角 ({pull}162)，由 @mgrover1 完成。
• 增强：添加查找扫描次数键的实用程序 ({pull}167)，由 @mgrover1 完成。

0.4.3 (2024-02-24)

• 维护：处理black样式更改，更新pre-commit-config.yaml ({pull}152)，由 @kmuehlbauer 完成。
• 修复：在odim范围内使用len(unique)来估计唯一条目 ({pull}151)，由 @martinpaule 完成。

0.4.2 (2023-11-02)

• 修复：修复处理sweep_mode属性 ({pull}143)，由 @mgrover1 完成。
• 修复：在get_crs()中显式检查"False" ({pull}142)，由 @kmuehlbauer 完成。

0.4.1 (2023-10-26)

• 修复：在cfradial1输出中添加历史记录，并修复CfRadial1_Export.ipynb笔记本中的小错误 ({pull}132)，由 @syedhamidali 完成。
• 修复：修复readthedocs构建对python 3.12的支持 ({pull}140)，由 @kmuehlbauer 完成。
• 修复：在backends中调整坐标，在environment.yml中固定python >3.9,<=3.12 ({pull}139)，由 @kmuehlbauer 完成。
• 修复：在计算FURUNO scn文件中的方位角时防止整数溢出 ({issue}137)，由 @giacant 完成， ({pull}138)，由 @kmuehlbauer 完成。

0.4.0 (2023-09-27)

• 增强：添加cfradial1导出器 ({issue}124)，由 @syedhamidali 完成， ({pull}126)，由 @syedhamidali 完成。
• 修复：使用datastore._group而不是variable["sweep_number"] ({issue}121)，由 @aladinor 完成， ({pull}123)，由 @kmuehlbauer 完成。
• 最小化：在添加CRS时使用"crs_wkt"而不是已弃用的"spatial_ref" ({pull}127)，由 @kmuehlbauer 完成。
• 修复：始终从ODIM文件中读取nodata和undetect属性 ({pull}125)，由 @egouden 完成。
• 最小化：在xradar中使用cmweather调色板 ({pull}128)，由 @kmuehlbauer 完成。

0.3.0 (2023-07-11)

• 增强：添加使用AWS s3存储桶上的雷达数据的示例 ({pull}102)，由 @aladinor 完成。
• 修复：正确解码iris-backend中的DB_DBTE8/DB_DBZE8和DB_DBTE16/DB_DBZE16 ({pull}110)，由 @kmuehlbauer 完成。
• 修复：在彩虹字典中将布尔字符串转换为int ({pull}113)，由 @egouden 完成。
• 维护：切换到mamba-org/setup-micromamba，分割CI测试 ({issue}115), ({pull}116)，由 @kmuehlbauer 完成。
• 修复：时间插值 ({pull}117)，由 @kmuehlbauer 完成。
• 修复：在extract_angle_parameters中获取angle_res的健壮检索 ({issue}112), ({pull}118)，由 @kmuehlbauer 完成。
• 修复：在 to_odim() 中增强雷达标识的鲁棒性（{pull}120）由 @kmuehlbauer 提供

0.2.0 (2023-03-24)

• 增强：在 ODIM 格式写入器中添加可选的 how 属性切换（{pull}97）由 @egouden 提供
• 修复：在 ODIM 格式写入器中添加必填的源属性关键字参数（{pull}96）由 @egouden 提供
• 修复：如果没有给定 dim0，则检查 dim0，仅在需要时交换 dim（{issue}92），({pull}94）由 @kmuehlbauer 提供
• 修复+增强：在覆盖之前需要数组复制，并在 to_odim 中提供压缩功能（{pull}95）由 @kmuehlbauer 提供

0.1.0 (2023-02-23)

• 添加将多个扫描读入单个对象的示例（{pull}69）由 @mgrover1 提供
• 增强：在地理参照时添加 spatial_ref with pyproj，添加/修改方法/测试（{issue}38），({pull}87）由 @kmuehlbauer 提供
• 更新文档/文档字符串，PULL_REQUEST_TEMPLATE.md（{pull}89）由 @kmuehlbauer 提供
• 最终确定版本 0.1.0，在推送到主分支时添加 testpypi 上传（{pull}91）由 @kmuehlbauer 提供

0.0.13 (2023-02-09)

• 修复：如果增益和偏移量都没有使用，则只跳过设置 cf-属性（{pull}85）由 @kmuehlbauer 提供

0.0.12 (2023-02-09)

• 增强：添加 IRIS DB_VELC 解码和测试（{issue}78），({pull}83）由 @kmuehlbauer 提供
• 修复：furuno 后端不一致（{issue}77），({pull}82）由 @kmuehlbauer 提供
• 修复：ODIM_H5 后端不一致（{issue}80），({pull}81）由 @kmuehlbauer 提供

0.0.11 (2023-02-06)

• 修复 odim 写入器中的 _Undetect/_FillValue（{pull}71）由 @kmuehlbauer 提供
• 从 wradlib 端口传输更多后端测试（{pull}73）由 @kmuehlbauer 提供

0.0.10 (2023-02-01)

• 添加 WRN110 scn 格式到 Furuno 读取器（{pull}65）由 @kmuehlbauer 提供
• 适应新的构建过程，仅 pyproject.toml，使用 ruff 进行代码检查（{pull}67）由 @kmuehlbauer 提供

0.0.9 (2022-12-11)

• 添加 ODIM_H5 导出器（{pull}39）由 @kmuehlbauer 提供
• 从 open-radar-data 获取雷达数据（{pull}44）由 @kmuehlbauer 提供
• 使读取器与 CfRadial2 保持一致，添加 CfRadial2 导出器（{pull}45），({pull}49），({pull}53），({pull}56），({pull}57）和 ({pull}58）由 @kmuehlbauer 提供
• 添加地理参照访问器，更新示例（{pull}60），({pull}61）由 @mgrover1 提供
• 重构并部分重写角度重索引（{issue}55），({pull}62）由 @kmuehlbauer 提供

0.0.8 (2022-09-28)

• 添加 GAMIC HDF5 导入器（{pull}29）由 @kmuehlbauer 提供
• 添加 Furuno SCN/SCNX 导入器（{pull}30）由 @kmuehlbauer 提供
• 添加 Rainbow5 导入器（{pull}32）由 @kmuehlbauer 提供
• 添加 Iris/Sigmet 导入器（{pull}33）由 @kmuehlbauer 提供
• 添加地理参照（AEQD）（{pull}28）由 @mgrover1 提供

0.0.7 (2022-09-21)

• 在 README.md 中添加 zenodo 徽章（{pull}22）由 @mgrover1 提供
• 修复 RTD 上的版本（{pull}23）由 @kmuehlbauer 提供
• 为 Datamodel 添加最小文档（{pull}24）由 @kmuehlbauer 提供

0.0.6 (2022-09-19)

• 改进安装和贡献指南，更新 README.md 添加更多徽章，将版本和发布日期添加到文档，更新安装过程（{pull}19）由 @kmuehlbauer 提供
• 为 CfRadial1 和 ODIM_H5 导入器添加最小文档（{pull}20）由 @kmuehlbauer 提供
• 添加 accessors.py 子模块，添加 accessors 展示 ({pull}21) 由 @kmuehlbauer 提供

0.0.5 (2022-09-14)

• 数据模型，CfRadial1 后端 ({pull}13) 由 @kmuehlbauer 提供
• ODIM_H5 后端 ({pull}14) 由 @kmuehlbauer 提供

0.0.4 (2022-09-01)

设置 CI 工作流程和构建，@mgrover1 和 @kmuehlbauer

0.0.1 (2022-09-01)

• 在 PyPI 上首次发布。