icepyx 2.0.0 版本发布：ICESat-2 数据访问的重大升级

icepyx 2.0.0 版本发布：ICESat-2 数据访问的重大升级

icepyx Python tools for obtaining and working with ICESat-2 data 项目地址: https://gitcode.com/gh_mirrors/ic/icepyx

icepyx 是一个用于访问和处理 NASA ICESat-2 卫星数据的 Python 库。ICESat-2（冰、云和陆地高程卫星-2）是 NASA 的重要地球观测任务，专门用于测量冰盖高程变化、海冰厚度以及全球地形特征。icepyx 库为科研人员提供了便捷的接口来查询、下载和处理这些宝贵的地球观测数据。

重大架构升级：从 EGI 到 Harmony

icepyx 2.0.0 版本标志着该库的一个重要转折点 - 从使用 NASA 的 EGI（Earthdata 网关接口）系统迁移到全新的 Harmony 云服务。这一变化源于 NSIDC（美国国家冰雪数据中心）将其 API 端点从本地 EGI 系统过渡到基于云的 Harmony 服务。

Harmony 是 NASA 新一代的地球科学数据服务框架，旨在提供更高效、更灵活的数据访问体验。与传统的 EGI 系统相比，Harmony 提供了更好的可扩展性和更现代化的 API 设计。

新特性亮点

1. Harmony 子集服务集成

新版本的核心特性是完整支持 NASA 的 Harmony 子集服务。这一集成带来了几个显著优势：

• 订单预览与管理：用户现在可以在提交完整订单前预览数据，也可以在订单处理过程中暂停或恢复下载。这种交互式体验大大提高了数据获取的灵活性。

• 大订单自动处理：Harmony 轨迹子集服务会自动暂停包含超过 300 个数据颗粒（granules）的订单。用户可以选择手动恢复这些订单，或者通过设置 skip_preview=True 参数来绕过预览直接处理。

2. 增强的订单管理类

icepyx 2.0.0 引入了全新的 Order 类，它代表了数据订单的完整生命周期：

• 当用户提交订单后，库会返回一个 Order 类实例
• 这个实例可以帮助用户跟踪订单进度
• 提供了暂停订单和最终下载数据的方法
• 虽然仍可使用传统的 Query 类下载数据，但 Order 类提供了更直观、更符合用户思维的接口

向后兼容性考虑

这是一个主要版本更新，包含了一些破坏性变更，用户需要注意以下变化：

• 数据格式转换：目前 Harmony API 不支持任何 ICESat-2 产品的格式转换，用户只能获取 HDF5 格式的文件
• 变量子集：新的云子集服务暂时不支持变量子集功能，因此子集订单将包含所有变量

技术栈更新

为了保持与现代 Python 生态系统的兼容性，icepyx 2.0.0 做出了以下技术调整：

• 放弃对 Python 3.9 和 3.10 的支持
• 移除了所有与 EGI 相关的已弃用代码
• 清理了 v1.x 版本中标记为弃用的功能

测试与文档改进

开发团队对测试基础设施进行了优化：

• 将单元测试和集成测试分离，各自使用独立的配置
• 修复了因 Harmony API 变更而失败的集成测试

文档方面也进行了全面更新：

• 所有示例笔记本都已更新，反映新的 Harmony API 使用方法
• 新增了关于完整订单和子集订单的详细说明
• 保持了顶层 API 的兼容性，使现有用户代码只需简单升级即可继续工作（除非使用了变量子集或格式转换功能）

总结

icepyx 2.0.0 版本代表了该项目向现代化云服务架构的重要迈进。虽然暂时失去了一些高级功能（如变量子集和格式转换），但新的 Harmony 集成提供了更可靠、更可扩展的基础架构，为未来的功能扩展奠定了坚实基础。对于 ICESat-2 数据用户来说，升级到 2.0.0 版本将获得更稳定的数据访问体验和更直观的订单管理功能。

icepyx Python tools for obtaining and working with ICESat-2 data 项目地址: https://gitcode.com/gh_mirrors/ic/icepyx