io

Module: io

实用程序以各种格式读取和写入图像。

以下插件可用：

call_plugin

skimage.io.call_plugin(kind, *args, **kwargs)[资源]

找到合适的'kind'插件并执行它。

concatenate_images

skimage.io.concatenate_images(ic)[资源]

将图像集合中的所有图像连接到一个数组中。

扩展内容

ImageCollection.concatenate, MultiImage.concatenate

find_available_plugins

skimage.io.find_available_plugins(loaded=False)[资源]

列出可用的插件。

imread

skimage.io.imread(fname, as_grey=False, plugin=None, flatten=None, **plugin_args)[source]

从文件加载图像。

| 其他参数：|

| | plugin_args：关键字传递给给定的插件。flatten：bool向后兼容关键字，取代as_grey。plugin_args：关键字传递给给定的插件。|

imread_collection

skimage.io.imread_collection(load_pattern, conserve_memory=True, plugin=None, **plugin_args)[source]

加载一组图像。

| 其他参数：|

| | plugin_args：关键字传递给给定的插件。|

imread_collection_wrapper

skimage.io.imread_collection_wrapper(imread)[source]

imsave

skimage.io.imsave(fname, arr, plugin=None, **plugin_args)[资源]

将图像保存到文件。

| 其他参数：|

| | plugin_args：关键字传递给给定的插件。|

imshow

skimage.io.imshow(arr, plugin=None, **plugin_args)[资源]

显示图像。

| 其他参数：|

| | plugin_args：关键字传递给给定的插件。|

imshow_collection

skimage.io.imshow_collection(ic, plugin=None, **plugin_args)[source]

显示一组图像。

| 其他参数：|

| | plugin_args：关键字传递给给定的插件。|

load_sift

skimage.io.load_sift(f)[资源]

从外部生成的文件中读取SIFT或SURF功能。

此例程从http://people.cs.ubc.ca/~lowe/keypoints/和http://www.vision.ee.ethz.ch/~surf/读取由二进制实用程序生成的SIFT或SURF文件。

此例程不会从图像生成SIFT / SURF功能。这些算法受到专利保护。请改用skimage.feature.CENSURE。

• 行：功能的int行位置

• 列：功能的列位置

• 比例：浮动特征比例

• 方向：浮动功能方向

• 数据：数组特征值

load_surf

skimage.io.load_surf(f)[资源]

从外部生成的文件中读取SIFT或SURF功能。

此例程从http://people.cs.ubc.ca/~lowe/keypoints/和http://www.vision.ee.ethz.ch/~surf/读取由二进制实用程序生成的SIFT或SURF文件。

此例程不会从图像生成SIFT / SURF功能。这些算法受到专利保护。请改用skimage.feature.CENSURE。

• 行：功能的int行位置

• 列：功能的列位置

• 比例：浮动特征比例

• 方向：浮动功能方向

• 数据：数组特征值

plugin_info

skimage.io.plugin_info(plugin)[资源]

返回插件元数据。

plugin_order

skimage.io.plugin_order()[资源]

返回当前首选的插件订单。

pop

skimage.io.pop()[source]

从共享图像堆栈中弹出图像。

push

skimage.io.push(img)[source]

将图像推入共享图像堆栈。

reset_plugins

skimage.io.reset_plugins()[资源]

show

skimage.io.show()[资源]

显示待处理图像。

启动当前gui插件的事件循环，并显示所有待处理的图像，通过排队imshow。imshow从非交互式脚本使用时，这是必需的。

调用show将阻止代码的执行，直到所有窗口关闭。

例子

>>> import skimage.io as io

>>> for i in range(4):
...     ax_im = io.imshow(np.random.rand(50, 50))
>>> io.show() 

use_plugin

skimage.io.use_plugin(name, kind=None)[资源]

设置指定操作的默认插件。如果该插件尚未加载，该插件将被加载。

扩展内容

available_plugins 可用插件列表

例子

要使用Matplotlib作为默认图像阅读器，您可以编写：

>>> from skimage import io
>>> io.use_plugin('matplotlib', 'imread')

查看可用插件运行列表io.available_plugins。请注意，这列出了已定义的插件，但如果您的系统没有安装所需的库，则完整列表可能无法使用。

ImageCollection

class skimage.io.ImageCollection(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs)[资源]

基本： object

加载和管理一组图像文件。

请注意，文件总是按字母顺序存储。另请注意，切片将返回一个新的ImageCollection，而不是数据视图。

| 其他参数：|

| | load_func：默认可调用imread。见下面的注释。|

注意

ImageCollection可以修改通过指定的一个组合来加载从任意源图像load_pattern和load_func。对于ImageCollection ic，ic[5]用于load_func(file_pattern[5])加载图像。

想象一下，例如，一个ImageCollection从视频文件中加载每第十帧：

class AVILoader:
    video_file = 'myvideo.avi'

    def __call__(self, frame):
        return video_read(self.video_file, frame)

avi_load = AVILoader()

frames = range(0, 1000, 10) # 0, 10, 20, ...
ic = ImageCollection(frames, load_func=avi_load)

x = ic[5] # calls avi_load(frames[5]) or equivalently avi_load(50)

另一个用途load_func是将所有图像转换为uint8：

def imread_convert(f):
    return imread(f).astype(np.uint8)

ic = ImageCollection('/tmp/*.png', load_func=imread_convert)

对于具有多个图像的文件，图像将被拼合成一个列表并添加到可用图像列表中。在这种情况下，load_func应该接受关键字参数img_num。

例子

>>> import skimage.io as io
>>> from skimage import data_dir

>>> coll = io.ImageCollection(data_dir + '/chess*.png')
>>> len(coll)
2
>>> coll[0].shape
(200, 200)

>>> ic = io.ImageCollection('/tmp/work/*.png:/tmp/other/*.jpg')

属性

__init__(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs)[资源]

加载和管理一组图像。

concatenate()[资源]

将集合中的所有图像连接成一个数组。

扩展内容

concatenate_images

conserve_memoryfilesreload(n=None)[资源]

清除图像缓存。

MultiImage

class skimage.io.MultiImage(filename, conserve_memory=True, dtype=None, **imread_kwargs)[资源]

基本： skimage.io.collection.ImageCollection

一个包含单个多帧图像的类。

注意

如果conserve_memory=True内存占用可以减少，但是性能会受到影响，因为必须更频繁地从文件中读取帧。

最后访问的帧被缓存，所有其他帧必须从文件中读取。

当前的实现使用tifffileTiff文件和PIL。

例子

>>> from skimage import data_dir

>>> img = MultiImage(data_dir + '/multipage.tif') 
>>> len(img) 
2
>>> for frame in img: 
...     print(frame.shape) 
(15, 10)
(15, 10)

__init__(filename, conserve_memory=True, dtype=None, **imread_kwargs)[资源]

加载一个多图像。

filename