跳转到主要内容

大图像转换器。

项目描述

将各种图像转换为最有效的大图像格式。

地理空间文件通过gdal_translate转换为云优化的geotiff。单图像非地理空间文件通过pyvips转换为金字塔tiff文件。多图像tiff文件转换为具有多个金字塔tiff图像的tiff文件,并具有自定义图像描述以存储帧细节。

某些文件可以在大图像的各个瓦片源中直接读取而无需转换,但效率不高(例如,nd2文件中的未压缩数据)。转换这些文件将导致更高效的数据访问。

安装

通过pip使用自定义构建的轮子进行安装

pip install large-image-converter[sources] --find-links https://girder.github.io/large_image_wheels

[sources]额外要求是可选的。指定时,将安装所有默认的大图像瓦片源,以实现额外的元数据提取和格式支持。

要求

如果自定义构建的轮子不适用于您的平台,或者您想使用不同版本的工具,您可以手动安装必备条件。要完全功能,需要以下软件包和库

  • GDAL 3.1.0或更高版本,包括命令行工具和Python库

  • libtiff,包括命令行工具

  • libvips

此外,大图(large_image)的各种瓦片源可以用来读取输入文件,提取和保留元数据,以及读取无法通过libvips或GDAL读取的文件。需要安装这些源的要求。

使用方法

命令行

在最简单的使用中,可以通过以下方式将图像进行转换

large_image_converter <源路径>

输出图像将生成在源图像相同的目录下。

可以通过以下方式获得完整的选项列表

large_image_converter --help

从Python

转换函数包含所有主要功能

from large_image_converter import convert

convert(<source path>)

# See the options
print(convert.__doc__)

从Girder

当安装girder-large-image时,转换器默认安装。它依赖于Girder Worker来实际运行转换。

可以通过项目详情页的用户界面、通过ImageItem模型的createImageItem方法或通过POST item/{itemId}/tiles端点访问转换任务。

局限性和未来开发

有些局限性可能需要额外开发来改进。

  • 对于某些多图像文件,例如无法由现有大图瓦片源读取的OME Tiff文件,特定的通道、z值或时间步不会转换为可直接使用的元数据。

  • 原始文件是否以有损或无损格式存储并不总是确定。如果未知,输出默认为无损,这可能会导致文件过大。

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分发

large_image_converter-1.29.11.tar.gz (25.6 kB 查看哈希值)

上传

构建分发

large_image_converter-1.29.11-py3-none-any.whl (25.5 kB 查看哈希值)

上传 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面