跳转到主要内容

用于处理大型、多分辨率图像的Python模块。

项目描述

Build Status codecov.io License doi-badge pypi-badge

用于处理大型、多分辨率图像的Python模块。

Large Image是由Kitware, Inc.的数据与分析小组开发和维护的,用于处理大型地理空间和医学图像。这为我们的一些图像分析平台提供了基础,包括Resonant GeoDataHistomicsUIDigital Slide Archive

亮点

  • 简化瓦片服务

  • 支持多种地理空间和医学图像格式

  • 转换为瓦片优化的(地理)Tiffs(也称为金字塔Tiffs)

  • Python方法用于高效重瓦片或访问图像区域

  • 瓦片重样选项,例如动态应用颜色和波段转换

安装

除了安装基础large-image包外,您还需要至少一个与您的目标文件格式相对应的瓦片源(一个large-image-source-xxx包)。您可以使用以下命令之一从主项目安装所有内容

Pip

在linux、OSX或Windows上安装常用瓦片源

pip install large-image[common]

在linux上安装所有瓦片源

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

当使用与Girder实例一起的大图时,请将Linux上的所有瓦片源和Girder插件安装完毕。

pip install large-image[all] girder-large-image-annotation[tasks] --find-links https://girder.github.io/large_image_wheels

Conda

如果不在Linux上,Conda可以让依赖管理变得稍微容易一些。基本模块、转换模块和两个源模块都在conda-forge上可用。您可以安装以下内容

conda install -c conda-forge large-image
conda install -c conda-forge large-image-source-gdal
conda install -c conda-forge large-image-source-tiff
conda install -c conda-forge large-image-converter

Docker镜像

此存储库的包中包含一个预构建的Docker镜像,该镜像包含读取任何支持的图像格式的所有依赖项。

如果您不希望在系统上安装GDAL等一些较重的依赖项,或者希望为处理大图像创建一个专用和隔离的环境,这将特别有用。

要使用,请拉取镜像并通过挂载存储图像的本地卷来运行它

docker pull ghcr.io/girder/large_image:latest
docker run -v /path/to/images:/opt/images ghcr.io/girder/large_image:latest

模块

大图由几个Python模块组成,旨在协同工作。这些包括

  • large-image:核心模块。

    您可以为该存储库中包含的任何瓦片源指定 extras_require。例如,您可以进行 pip install large-image[tiff]。还有额外的 extras_require 选项

    • sources:存储库中的所有瓦片源,特定源名称(例如,tiff

    • memcached:使用memcached进行瓦片缓存

    • converter:包含转换模块

    • colormaps:使用matplotlib用于样式中的命名调色板

    • tiledoutput:支持以瓦片tiff的形式发出大区域

    • performance:包含可选模块,可以提高性能

    • common:所有瓦片源和上述包,这些包可以直接从pypi安装,无需在Linux、OSX和Windows上安装其他外部库。

    • all:对于所有上述内容

  • large-image-converter:一个实用工具,用于使用pyvips和其他库将图像转换为pyramid tiff文件,这些文件可以被large_image有效地读取。您可以指定 extras_require jp2k 以包括允许输出JPEG2000压缩的模块,sources 以包括所有源,stats 以包括允许计算压缩噪声统计信息的模块,geospatial 以包括支持将地理空间源转换为的模块,或者 all 以包括所有可选的 extras_require。

  • 瓦片源

    • large-image-source-bioformats:一个用于读取Java Bioformats库处理的任何文件的瓦片源。

    • large-image-source-deepzoom:一个用于读取Deepzoom瓦片的瓦片源。

    • large-image-source-dicom:一个用于读取DICOM Whole Slide Images (WSI) 的瓦片源。

    • large-image-source-gdal:一个通过GDAL读取geotiff文件的瓦片源。它处理比mapnik瓦片源更复杂的变换的源数据。

    • large-image-source-mapnik:一个通过Mapnik和GDAL读取geotiff和netcdf文件的瓦片源。它处理比gdal瓦片源更多的矢量问题。

    • large-image-source-multi:一个用于将其他瓦片源组合成一个单独的多帧源的瓦片源。

    • large-image-source-nd2:一个用于读取nd2(NIS Element)图像的瓦片源。

    • large-image-source-ometiff:一个使用tiff库的瓦片源,可以处理大多数符合规范的multi-frame OMETiff文件。

    • large-image-source-openjpeg:一个使用Glymur库读取jp2(JPEG 2000)文件的瓦片源。

    • large-image-source-openslide:使用 OpenSlide 库的瓦片源。它支持 svs、ndpi、Mirax、tiff、vms 等多种文件格式。

    • large-image-source-pil:通过 Python Imaging Library(Pillow)实现的小图像瓦片源。默认最大尺寸为 4096,但最大尺寸可以配置。

    • large-image-source-tiff:用于读取常用压缩格式的金字塔 tiff 文件的瓦片源。

    • large-image-source-tifffile:使用 tifffile 库的瓦片源,可以处理各种类似 tiff 的文件。

    • large-image-source-vips:读取由 libvips 处理的任何文件的瓦片源。也可以用于将 numpy 数组(最多 4 维)写入瓦片图像。

    • large-image-source-zarr:使用 zarr 库的瓦片源,可以处理 OME-Zarr(OME-NGFF)文件以及一些其他 zarr 文件。也可以用于从 numpy 数组写入 N 维瓦片图像。写入的图像可以保存为任何支持的格式。

    • large-image-source-test:生成测试瓦片,包括简单的分形图案。用于测试极端缩放级别非常有用。

    • large-image-source-dummy:不执行任何操作的瓦片源。这是瓦片源的最小实现,用于测试。如果您想创建自定义瓦片源,请从这个实现开始。

作为 Girder 插件,large-image 添加了端点以访问它可以读取的所有图像格式,包括获取元数据和作为瓦片服务器。在 Girder UI 中,large-image 在项目页面显示图像,并在浏览文件夹时在项目列表中显示缩略图。当 large-image 作为瓦片服务器使用时,还有缓存管理来平衡 Girder 的内存使用和响应速度。

大多数瓦片源都可以与 Girder Large Image 一起使用。您可以通过指定 girder 的 extras_require 来安装以下软件包

  • girder-large-image:作为 Girder 3.x 插件的大图像。您可以通过安装 large-image[tasks] 来安装一个 Girder Worker 任务,该任务可以将其他无法读取的图像转换为金字塔 tiff 文件。

  • girder-large-image-annotation:向 Girder 数据库添加模型以支持注释大图像。这些注释可以在图像上显示。注释可以包括多边形、点、图像叠加和其他类型。每个注释都可以有一个标签和元数据。

  • large-image-tasks:通过 Girder Worker 运行转换器的实用程序。您可以通过指定 girder 的 extras_require 来包含与 Girder 远程工作器一起工作的模块或包含与 Girder 远程工作器远程端一起工作的模块。如果没有指定,某些转换任务可以使用 Girder 本地作业运行。

项目详情


发布历史 发布通知 | RSS 源

下载文件

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

源分布

large_image-1.29.11.tar.gz (256.4 kB 查看哈希值)

上传时间

构建分布

large_image-1.29.11-py3-none-any.whl (98.0 kB 查看哈希值)

上传时间 Python 3

由以下支持