保存带有不同元数据的TIFF堆栈-Python教程-PHP中文网

保存带有不同元数据的TIFF堆栈

碧海醫心

发布： 2025-09-19 10:51:00

原创

157人浏览过

保存带有不同元数据的tiff堆栈

本文档介绍了如何使用 tifffile 库将显微镜图像的NumPy数组保存为多层TIFF文件，并为每一层添加特定的元数据。重点在于如何正确地为每一张切片设置不同的描述信息，以及如何使用 OME-TIFF 格式存储更丰富的显微镜图像元数据，包括像素大小和Z轴位置等信息。

使用 tifffile 库保存 TIFF 堆栈并添加元数据

在使用显微镜获取图像后，通常需要将多个图像（例如不同高度的切片）保存到一个 TIFF 文件中。tifffile 是一个强大的 Python 库，可以用来读写 TIFF 文件。以下是如何使用 tifffile 将 NumPy 数组保存为多层 TIFF 文件，并为每一层设置不同的元数据。

一个常见的错误是尝试在循环中简单地更新 description 字段，但这会导致所有切片都具有相同的描述。正确的做法是为每个切片创建独立的元数据字典。

import numpy
import tifffile
import json

# 模拟显微镜图像数据
xyz_stack = []
for i in range(5):
    z_slice = {
        'z': i,
        'numpy_array': numpy.random.randint(0, 255, (256, 256), dtype='uint8')
    }
    xyz_stack.append(z_slice)

filename = 'multistack.tif'

with tifffile.TiffWriter(filename, bigtiff=False, imagej=False) as tif_writer:
    for z_slice in xyz_stack:
        metadata = {'x': 10.5, 'y': 7.5}
        metadata["z"] = z_slice['z']
        tif_writer.write(z_slice['numpy_array'], description=json.dumps(metadata))

print(f"TIFF stack saved to {filename}")

登录后复制

这段代码首先模拟了一个包含多个切片的 xyz_stack 列表。然后，它使用 TiffWriter 创建一个 TIFF 文件，并在循环中遍历每个切片。对于每个切片，它创建一个新的元数据字典，并将切片的 Z 坐标添加到字典中。最后，它使用 tif_writer.write() 方法将切片数据写入 TIFF 文件，并将元数据字典转换为 JSON 字符串作为描述信息。

使用 OME-TIFF 格式存储显微镜图像

对于显微镜图像，推荐使用 OME-TIFF 格式，它可以存储更丰富的元数据，例如像素大小、Z 轴位置等。

存了个图

视频图片解析/字幕/剪辑，视频高清保存/图片源图提取

查看详情

以下是如何使用 tifffile 库创建 OME-TIFF 文件：

import numpy
from tifffile import TiffWriter

data = numpy.random.randint(0, 1023, (8, 256, 256), 'uint16')
pixelsize = 0.29  # micrometer
zpositions = [0.0, 1.1, 2.2, 3.3, 4.4, 5.5, 6.6, 7.7]
metadata = {
    'axes': 'ZYX',
    'SignificantBits': 10,
    'PhysicalSizeX': pixelsize,
    'PhysicalSizeXUnit': 'µm',
    'PhysicalSizeY': pixelsize,
    'PhysicalSizeYUnit': 'µm',
    'Plane': {
        'PositionZ': zpositions,
        'PositionZUnit': ['µm'] * data.shape[0],
        'PositionY': [7.5] * data.shape[1],
        'PositionYUnit': ['µm'] * data.shape[1],
        'PositionX': [10.5] * data.shape[2],
        'PositionXUnit': ['µm'] * data.shape[2],
    },
}

with TiffWriter('temp.ome.tif', bigtiff=False, ome=True) as tif:
    tif.write(
        data,
        photometric='minisblack',
        # tile=(128, 128),
        # compression='adobe_deflate',
        resolutionunit='CENTIMETER',
        resolution=(1e4 / pixelsize, 1e4 / pixelsize),
        metadata=metadata,
    )

print("OME-TIFF file saved to temp.ome.tif")

登录后复制

这段代码首先创建了一个随机的 NumPy 数组作为图像数据。然后，它定义了一些元数据，包括像素大小和 Z 轴位置。metadata 字典包含了图像的轴信息、有效位数、物理尺寸以及每个平面的位置信息。最后，它使用 TiffWriter 创建一个 OME-TIFF 文件，并将图像数据和元数据写入文件。注意 ome=True 参数用于指定创建 OME-TIFF 文件。photometric='minisblack' 指定了图像的颜色模式，resolutionunit 和 resolution 指定了图像的分辨率。

注意事项

确保安装了 tifffile 库。可以使用 pip install tifffile 命令安装。
bigtiff=True 允许保存大于 4GB 的 TIFF 文件。
根据实际情况修改元数据，例如像素大小、Z 轴位置等。
OME-TIFF 格式是一种推荐的显微镜图像存储格式，可以存储更丰富的元数据。

总结

本文档介绍了如何使用 tifffile 库将显微镜图像的 NumPy 数组保存为多层 TIFF 文件，并为每一层添加特定的元数据。通过为每个切片创建独立的元数据字典，可以确保每个切片都具有正确的描述信息。此外，还介绍了如何使用 OME-TIFF 格式存储更丰富的显微镜图像元数据。掌握这些技巧可以帮助你更好地管理和分析显微镜图像数据。

以上就是保存带有不同元数据的TIFF堆栈的详细内容，更多请关注php中文网其它相关文章！