使用PIL的Image.save()保存大尺寸TIFF文件时遇参数越界错误求助

问题场景 #

尝试从NumPy数组生成并保存TIFF文件，处理超大数据集时，尺寸稍小的大图片可正常保存，但更大的图片保存失败，报错信息：

***error: argument out of range ***

原代码：

image_array = np.vstack(band1,band2,band3)
image=Image.fromarray(image_array,mode='RGB')
file_name='img2.tiff'
image.save(file_name,format='TIFF')

解决方案 #

• 修正通道合并方式：np.vstack会将三个波段垂直堆叠，得到的数组形状是(h*3, w)，但RGB模式要求数组形状为(h, w, 3)，应该改用np.dstack合并通道：

  image_array = np.dstack((band1, band2, band3))
  

• 启用BigTIFF格式：默认TIFF有4GB大小限制，超大文件需要指定BigTIFF格式，保存时添加参数：

  image.save(file_name, format='TIFF', bigtiff=True)
  

• 统一数组数据类型：确保数组数据类型为PIL支持的类型（如uint8），如果是浮点型或超出0-255范围的数值，先转换类型：

  image_array = image_array.astype(np.uint8)
  

• 内存优化（极端情况）：如果图片尺寸过大导致内存不足，可分块处理图片，或使用libtiff库直接操作TIFF文件，绕过PIL的内存限制。

内容的提问来源于stack exchange，提问作者Harry Dhindsa