Rasterio 1.5.1 的补丁覆盖边界计算、三维数组、重投影和依赖环境。升级应以坐标、维度和运行时依赖为门禁。

可核查事实

  • Rasterio 1.5.1于2026-08-07发布。
  • 该版本修复多个问题并解除affine 3.0.0发布阻塞。
  • GeoJSON bbox在features.bounds()提供transform或north_up=False时不再被使用。
  • sieve()修复3D源的尺寸保护，并使输出维度与read()一致。
  • reproject()修复数组掩膜与np.ma.nomasked比较导致的ValueError。
  • 垂直基准转换需要PROJ transformation grids和PROJ_NETWORK环境变量。
  • Wheels包含GDAL 3.12.4、netCDF 4.10.1、cURL 8.20.0和PROJ 9.8.1。

核心机制

Rasterio 1.5.1于2026-08-07发布。该版本修复多个问题并解除affine 3.0.0发布阻塞。GeoJSON bbox在features.bounds()提供transform或north_up=False时不再被使用，边界计算应使用明确的变换参数验证。

GIS 场景

sieve()修复3D源的尺寸保护，并使输出维度与read()一致。遥感模型输入依赖波段维度，升级后需比对 shape、掩膜和波段次序。reproject()修复数组掩膜与np.ma.nomasked比较导致的ValueError，应覆盖无掩膜与有掩膜路径。

技术路径

  1. 固定代表性 GeoJSON、三维栅格和重投影样本。
  2. 回归 bounds、shape、掩膜和坐标结果。
  3. 锁定 GDAL、PROJ 和 Rasterio wheel 版本。
  4. 验证垂直基准网格与网络设置。

检查清单

  • 边界是否应用预期变换？
  • 三维输出是否保持波段维？
  • 重投影掩膜是否正常？
  • 垂直基准依赖是否就绪？
  • 依赖版本是否可复现？

风险边界

补丁不能覆盖所有 GDAL 和 PROJ 组合。必须在目标平台与真实样本上回归，并保留回滚。

资料依据

本文依据 Rasterio 1.5.1 官方 Release 撰写。

结论

将坐标、维度与依赖锁定纳入验证，才能安全升级 Rasterio。