Trefoil（原名Clover）

因为今天可能是你幸运的一天。

**(注意：由于与pypi上的名称冲突，于2018年4月20日从clover重命名为Trefoil**)

使用NetCDF文件和numpy数组进行地理空间操作。

为什么？

我们需要一个库来整合一系列用于NetCDF和numpy数组的实用脚本和通用地理空间操作。我们发现我们为涉及大量NetCDF气候和模型输出的其他项目创建了大量的专用脚本。尽可能地将通用模式提取出来，并放置在此处。当我们寻找现有工作，我们没有找到完全满足我们需求的东西，具有干净的API，没有对数据模型或CF约定的强断言（我们追求约定，但并非所有数据都符合它们）。

具体来说，我们希望提供

• 将numpy数组渲染为图像的简单快捷的API
• 提供使处理NetCDF数据更简单的实用函数的简单API
• 使常见操作简单易用且可移植的简单命令行界面
• 分析操作以简化使用几何形状与栅格数据的结合
• 分析操作以总结空间和时间-空间数据集的各种维度（超过3个维度会让我们的头很痛！）

我们试图避免重新实现任何在其他地方已经处理得很好的功能。在可能的情况下，我们将功能贡献给其他库（例如，rasterio），我们认为这些功能足够通用，不依赖于trefoil。

它在哪里被使用？

这是我们基于Django的NetCDF地图服务器ncdjango的核心依赖。

我们在Conservation Biology Institute的多个内部项目中使用此功能。

安装

在此项目中使用pipenv来管理依赖项。

pipenv install trefoil

不再直接维护/支持

在Windows上，从Python Windows Packages安装需要编译的版本。然后使用pip安装剩余的版本。

命令行界面

此功能目前正在进行大量开发。
有关更多信息，请参阅CLI文档。

正在进行的工作

这项工作仍在积极开发中，因为我们有时间和需要。所有API都可能在版本1.0发布之前发生变化。

具体来说，我们需要做以下工作：

• 标准化API模式
• 文档
• 测试覆盖率和正确性
• 路线图

贡献者

• Brendan C. Ward
• Nik Stevenson-Molnar

灵感来源于Tim Sheehan和Ken Ferschweiler。

另请参阅

• rasterio：正确执行地理空间I/O和栅格操作。
• OCGIS：在CF兼容气候数据集上执行地理处理。
• scikit-image：Python图像处理
• python-rasterstats：使用几何形状进行栅格汇总统计