翻译自 官方文档


什么是PyArt?

  Python ARM Radar Toolkit,简称“Py-ART”,是一个包含了天气雷达算法和程序的Python第三方库。Py-ART一开始被大气辐射测量与气候研究机构(Atmospheric Radiation Measurement (ARM) Climate Research Facility)用来处理来自其降水与云雷达的测量数据,但是现在它已经被设计成可以被其他雷达和气候团队用来检验、处理和分析多种天气雷达数据的库。

引用Py-ART

  如果你在你的工作中使用了Py-ART,请在你的论文中注明它。开发者鼓励在你的论文中引用和注明它,并且引用下面的论文将会为你提供很大的帮助

有关Py-ART的论文请引用 Journal of Open Research Software

Helmus, J.J. & Collis, S.M., (2016). The Python ARM Radar Toolkit (Py-ART), a Library for Working with Weather Radar Data in the Python Programming Language. Journal of Open Research Software. 4(1), p.e25. DOI: http://doi.org/10.5334/jors.119

有关开源雷达软件的论文请引用 BAMS 中的 Maik Heistermann

M. Heistermann, S. Collis, M. J. Dixon, S. Giangrande, J. J. Helmus, B. Kelley, J. Koistinen, D. B. Michelson, M. Peura, T. Pfaff, and D. B. Wolff, 2015: The Emergence of Open-Source Software for the Weather Radar Community. Bull. Amer. Meteor. Soc. 96, 117–128, doi: 10.1175/BAMS-D-13-00240.1.

Py-ART能做什么?

  Py-ART能够读取许多常见天气雷达的档案数据,包括:Sigmet/IRIS, MDV, CF/Radial, UF, 和NEXRAD Level II,也能将雷达数据写成符合CF/Radial规范的NetCDF文件
  Py-ART也包含能够绘制常见的雷达图像(例如PPI图和RHI图)的程序

使用PyArt绘制的PPI图

使用PyArt绘制的RHI图

  库中的算法能够在雷达天线进行调整时对雷达的瞬时数据进行一系列的修正。包括:反射率的修正,退模糊以及correction of the specific (kdp) and differential (phidp) phases
  复杂的画图程序能够利用来自一个或多个雷达的数据精准统一地在笛卡尔坐标系中绘制出雷达场,也能够将这些图像保存进NetCDF文件中

快速学习

  下面是有关Py-ART和开源雷达软件的包含数据以及示例的简易教程

2015 AMS, Open Source Radar Short Course
2015 ARM/ASR Meeting, PyART, the Python ARM Radar Toolkit
2014 ARM/ASM Meeting, Py-ART tutorial
2014 ERAD, Open Source Radar Short Course


安装

  Py-ART能在Python 3.6,3.7以及3.8下工作,在使用之前应先安装以下所依赖的Python库

Numpy
Scipy
matplotlib
netCDF4

在Linux平台上安装

  对于使用Linux的用户,可以使用pip很方便的安装Py-ART

1
sudo pip3 install arm-pyart

在Windows平台上安装

  如果你使用PyCharm,可以在PyCharm的设置中找到管理第三方库的管理器,并且很方便的在其中找到上述第三方库并安装(在此之前你可能需要设置Pypi的源以加快安装速度)
  如果你是命令行的爱好者(不排除有这种用户),打开CMD,并输入如下代码:

1
pip install arm-pyart

  或者使用conda安装

1
conda install -c conda-forge arm_pyart

  在使用某些可选第三方库的时候你还会需要安装可以工作的C/C++编译器。使用 Science Python distributions 可以很简便的安装上述所有依赖的库。Anaconda Compliers 是由Anaconda免费提供的跨平台的(Windows, Linux 和 Mac) ,它将会安装上述所有的库。Anaconda也有自己的编译器,在使用某些可选库例如 CyLP 时会用到,你可以在这个网址中找到编译器的相关信息

https://docs.conda.io/projects/conda-build/en/latest/resources/compiler-tools.html


可选的功能

  以上的Python库都是安装Py-ART之前必须安装的,安装以下的库可以获得额外的功能。

TRMM Radar Software Library(RSL).安装这个库以后,Py-ART能够从多种额外的格式中读取雷达数据(Lassen, McGill, Universal Format and RADTEC)并且能够自动进行多普勒退模糊的计算。RSL应该在安装Py-ART之前安装。如果RSL没有安装在默认路径(/usr/local/trmm/),那么你应该设置环境变量使其指向RSL的安装位置,例如anaconda的安装路径(/usr/anaconda3/envs/pyart_env).

如果您想从HDF5文件中读取数据,你可以安装h5py及其所依赖的库.

一个使用LP相位处理方法的线性求解程序和Python包装器。我们推荐使用CyLP,因为它给出了最快的解决方法,除此之外你也可以使用PyGLPKCVXOPT。取决于使用的包装器,CBCGLPK有时也是必须的。在使用CyLP时,你需要设置 COIN_INSTALL_DIR 路径,加入一条指向coincbc的路径,例如(/usr/anaconda3/envs/pyart_env)

Cartopy.安装这个库你可以在地理地图上绘制表格

xarray.安装这个库你可以在绘制的表格上使用表格数据

Basemap.安装这个库也可以使你在地理地图上绘制表格,但是我们更推荐Cartopy

wradlib.用来计算一个不同的相位场的结构

pytest.用来运行Py-ART的单元测试

gdal.用来将表格对象输出为GeoTIFFs


获得帮助

  Py-ART有一个论坛,在这里你可以提出问题,寻求帮助

请注意,该论坛为Google论坛,大陆无法访问

加入我们

  Py-ART是一个遵循开源协议New BSD的开源软件,其源码已在Github公开。你可以在Issue板块提交需求以及反馈Bug。我们非常欢迎您帮助我们改进,贡献代码。更多详细信息请查看指导手册

本教程遵循GPL开源协议,转载请标明本博客地址:https://syize.gitee.io/