gldas-noah陆面模型数据的读取器和转换器。
gldas的Python项目详细描述
来自GLDAS Noah Land Surface Model的数据的读取器和转换器。用python编写。
与pytesmo结合使用效果很好。
引文
如果你在出版物中使用该软件,请使用zenodo doi引用它。 请注意,此徽章链接到最新的软件包版本。
请在https://doi.org/10.5281/zenodo.596427选择您的特定版本以获取该版本的doi。 通常情况下,引用记录的特定版本应该始终使用doi。 这是为了确保其他研究人员能够获得您用于再现性的确切研究成果。
安装
使用conda设置完整的环境可以使用以下命令 命令:
conda create -n gldas python=2.7 # or any other supported python version source activate gldas
# Either install required conda packages manually conda install -c conda-forge numpy netCDF4 pyproj pygrib # Or use the provided environment file to install all dependencies conda env update -f environment.yml
# Install the gldas package and pip-dependencies
pip install gldas
这也将尝试安装pygrib以读取gldas grib文件。如果这个 不工作,请查阅pygrib manual。
注意
据我们所知,读取grib文件在windows上不起作用。可能是 可以编译ecmwf c library,但我们还没有完成。
支持的产品
目前这个包支持GRIB中的GLDAS NOAH数据版本1 格式(读取,创建时间序列)和GLDAS NOAH数据版本2.0和版本2.1,采用NetCDF格式(下载,读取,创建时间序列),空间采样为0.25度。 应该很容易扩展包以支持其他基于gldas的产品。 这将在需要时进行。
下载产品
为了下载gldas noah产品,您必须注册一个帐户 美国宇航局地球数据门户网站。可以找到指令here。
之后,您可以使用命令行程序gldas_download。
mkdir ~/workspace/gldas_data gldas_download ~/workspace/gldas_data
会将0.25度采样的gldas noah版本2.0下载到文件夹中 ~/workspace/gldas_data。有关更多选项,请运行gldas_download -h。
贡献
如果你想贡献,我们很高兴。请提出一个问题来解释丢失的内容或是否发现错误。我们也很乐意接受针对我们的主分支的拉取请求,以获得新功能或错误修复。
开发设置
对于开发,我们还建议使用conda环境。你可以创建一个 通过运行 conda env create -f environment.yml。这将创建一个新的gldas 可以使用source activate gldas激活的环境。
指南
如果您想投稿,请遵循以下步骤:
- 将gldas存储库转移到您的帐户
- 克隆存储库,确保使用git clone --recursive也可以获得测试数据存储库。
- 从gldas主分支创建新的功能分支
- 添加您的功能
- 请在其中一个测试目录中包含您的贡献测试。我们使用py.test,因此一个名为test_my_feature的简单函数就足够了
- 向我们的总分行提交请求
注
此项目是使用PyScaffold 2.5.6建立的。详细信息和用法 有关pyscaffold的信息,请参见http://pyscaffold.readthedocs.org/。