imageageAtastore.

图像数据的数据存储

描述

用A.imageageAtastore.对象管理图像文件的集合,其中每个单独的图像都适合内存,但整个图像集合不一定适合。你可以创建一个imageageAtastore.对象使用imageageAtastore.函数,指定其属性,然后使用对象函数导入和处理数据。

创建

描述

IMDS.= imageageataStore(地点创建一个数据存储IMDS.从指定的图像数据的集合地点

例子

IMDS.= imageageataStore(地点名称,价值指定其他参数和特性为了IMDS.使用一个或多个名称值对参数。

输入参数

展开全部

数据存储中包含的文件或文件夹,指定为路径或adsfileset.目的。

  • 路径 - 将路径指定为字符向量,字符向量,字符串标量或字符串数​​组的单元格数组,其中包含本地或远程的文件或文件夹的位置。

    • 本地文件或文件夹 - 指定地点作为文件或文件夹的本地路径。如果文件不在当前文件夹中,则本地路径必须指定完整或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储区中。指定本地路径时,可以使用通配符(*)。此字符指定数据存储区包括匹配文件夹中的所有匹配文件或所有文件。

    • 远程文件或文件夹 - 指定地点成为文件或文件夹的完整路径,作为表单的统一资源定位器(URL)HDFS:/// path_to_file。有关更多信息,请参阅使用远程数据

  • dsfileset.对象 - 您也可以指定地点作为一个dsfileset.目的。有关更多信息,请参阅matlab.io.datastore.dsfileset.

什么时候地点表示一个文件夹,数据存储区仅包括支持的文件格式并忽略任何其他格式。万博1manbetx要在数据存储区中指定要包含的文件扩展名的自定义列表,请参阅过滤义财产。

imageageAtastore.函数支持有一个文件万博1manbetximformats.格式。

例子:'file1.jpg'

例子:'../dir/data/file1.png'

例子:{'c:\ dir \ data \ file1.tif','c:\ dir \ data \ file2.tif'}

例子:'c:\ dir \ data \ *。jpg'

名称值对参数

指定可选的逗号分离对名称,价值论点。名称是参数名称和价值是相应的价值。名称必须出现在引号内。您可以以任何顺序指定多个名称和值对参数name1,value1,...,namen,valuen

例子:imds = imageageataStore('c:\ dir \ imagedata','fileextensions',{'。jpg','。tif'})

子文件夹包含标志,指定为逗号分隔的配对'insertumbfolders'真的要么错误的。指定真的包括每个文件夹中的所有文件和子文件夹或错误的仅包含每个文件夹中的文件。

如果您未指定'insertumbfolders',然后默认值是错误的

例子:'insertumubfolders',真实

数据类型:逻辑|双倍的

图像文件扩展,指定为逗号分隔对'fileextensions'和字符矢量,字符向量,字符串标量或字符串数​​组的字符矢量。指定的扩展不需要imformats.格式,您可以使用空引号''表示没有扩展的文件。如果您未指定'fileextensions', 然后imageageAtastore.自动包含所有图像imformats.指定路径中的扩展。如果要包含扩展imformats.不识别,然后指定所有扩展。

例子:'fileextensions','。jpg'

例子:'fileextensions',{'。jpg','。png'}

数据类型:char|细胞|细绳

备用文件系统根路径,指定为逗号分隔对组成'alternedfilesystemroots'和字符串矢量或单元格数组。采用'alternedfilesystemroots'在本地计算机上创建数据存储,但需要访问和处理另一台计算机上的数据(可能是不同的操作系统)。此外,当使用并行计算工具箱™和该数据处理数据时马铃薯®并行服务器™,数据存储在本地计算机上,使用不同平台云或群集计算机上可用的数据副本,您必须使用'alternedfilesystemroots'要关联根路径。

  • 要关联一组等同于彼此的根路径,请指定'alternedfilesystemroots'作为串矢量。例如,

    [“z:\ datasets”,“/ mynetwork / datasets”]

  • 要关联多组等同于数据存储的根路径,请指定'alternedfilesystemroots'作为包含多行的单元数组,其中每行代表一组等效根路径。将单元格数组中的每一行指定为字符串向量或字符向量的小区数组。例如:

    • 指定'alternedfilesystemroots'作为串向量的单元阵列。

      {[“z:\ datasets”,“/ mynetwork / datasets”]; ... [y:\ datasets“,”/ mynetwork2 / datasets“,”s:\ datasets“]}

    • 或者,指定'alternedfilesystemroots'作为字符向量的单元阵列的单元阵列。

      {{'z:\ datasets','/ mynetwork / datasets'}; ... {'y:\ datasets','/ mynetwork2 / datasets','s:\ datasets'}}

的价值'alternedfilesystemroots'必须满足这些条件:

  • 包含一个或多个行,其中每行指定一组等效根路径。

  • 每行指定多个根路径,每个根路径必须至少包含两个字符。

  • 根路径是唯一的,不是彼此的子文件夹。

  • 包含至少一个点指向文件位置的根路径条目。

有关更多信息,请参阅设置数据存储,用于处理不同的机器或群集

例子:[“z:\ datasets”,“/ mynetwork / datasets”]

数据类型:细绳|细胞

提供标签数据的源,指定为逗号分隔对'labelsource''没有任何'要么'foldernames'。如果'没有任何'指定,然后是标签财产是空的。如果'foldernames'指定,然后根据文件夹名称分配标签并存储在标签财产。您可以稍后通过访问来修改标签标签property直接。

数据类型:char|细绳

除了这些名称 - 值对之外,还可以指定此页面上的任何属性作为名称值对,除了文件财产。

特性

展开全部

imageageAtastore.属性描述了数据并指定如何从数据存储区读取数据。您可以指定值imageageAtastore.使用名称值对参数创建数据存储对象时属性。要在创建对象后查看或修改属性,请使用点表示法。

例如,您可以创建一个imageageAtastore.对象并指定'readfcn'范围:

imds = imageageatastore('peppers.png''readfcn',@ customReader);
或者,您可以分配'readfcn'@CustomReader.创建后imageageAtastore.
imds = imageageatastore('peppers.png');imds.readfcn = @customreader;

包含在数据存储中的文件,作为字符向量,字符向量,字符串标量或字符串数​​组的单元格数组。每个字符向量或字符串是文件的完整路径。这地点争论在imageageAtastore.数据存储功能定义文件创建数据存储时。

例子:{'c:\ dir \ data \ file1.jpg';'c:\ dir \ data \ file2.jpg'}

数据类型:char|细胞|细绳

此属性是只读的。

用于构造数据存储的文件夹,作为字符向量的单元格数组返回。电池阵列定向为列向量。每个字符向量是包含数据文件的文件夹的路径。这地点争论在imageageAtastore.数据存储功能定义文件夹创建数据存储时。

数据类型:细胞

呼叫中读取的图像文件数量函数,指定为正整数标量。每次呼唤到功能最多读取阅读图片。

数据存储中文件的文件标签,指定为向量,单元格数组或字符串数​​组。阵列中标签的顺序对应于数据存储区中关联文件的顺序。如果您指定'labelsource','foldernames'创建时imageageAtastore.对象,然后文件的标签名称是包含它的文件夹的名称。如果您未指定'labelsource','foldernames', 然后标签是一个空的单元格数组或字符串数​​组。如果你改变了文件创建数据存储后的属性,那么标签不自动更新属性以合并添加的文件。

数据类型:分类|细胞|逻辑|双倍的|单身的|细绳

读取图像数据的功能,指定为函数句柄。该函数必须将图像文件名作为输入拍摄,然后输出相应的图像数据。例如,如果CustomReader.是读取图像数据的指定函数,那么它必须具有类似的签名:

函数data = customReader(文件名)...结束
如果存在多个输出参数,那么imageageAtastore.仅使用第一个参数并忽略其余的。

笔记

使用readfcn.不推荐转换或预处理2-D图像。出于识别的文件格式imformats.,指定readfcn.减缓了表现imageageAtastore.。有关更有效的方式来转换和预处理图像,请参阅深度学习的预处理图像(深度学习工具箱)

例子:@CustomReader.

数据类型:function_handle.

此属性是只读的。

写入的格式列表,作为字符串的行向万博1manbetx量返回。此属性指定使用时可能的输出格式reliteall.从数据存储区写入输出文件。

数据类型:细绳

此属性是只读的。

默认输出格式,作为字符串标量返回。此属性指定使用时的默认格式reliteall.从数据存储区写入输出文件。

数据类型:细绳

对象功能

counteanceLabel. 计算IMAGEDATASTORE标签中的文件
哈迪塔 确定数据是否可用读取
numpartitions 数据存储区分区数量
划分 分区数据存储
预习 在数据存储区中预览数据子集
在数据存储区中读取数据
读物 阅读数据存储中的所有数据
阅读贴图 从数据存储读取指定的图像
reliteall. 将数据存储写入文件
重置 将数据存储重置为初始状态
洗牌 在数据存储区中播放所有数据
spliteachlabel. 按比例拆分imageageataStore标签
子集 创建数据存储或文件集的子集
转变 转换数据存储
结合 将数据与多个数据存储组合
是可分派的 确定数据存储是否已分配
isShufflable. 确定数据存储是否会破坏

例子

全部收缩

创建一个imageageAtastore.与所有人相关的对象.tif.MATLAB®路径及其子文件夹中的文件。使用文件夹名称作为标签名称。

imds = imagedataStore(fullfile(matlabroot,'工具箱''matlab'),......'insertumbfolders',真的,'fileextensions''.tif''labelsource''foldernames'
IMDS = IMAGEDATASTORE具有属性:文件:{'... \ MATLAB \ TOOLBOX \ MATLAB \ DEMOS \ example.tif';'... \ matlab \ toolbox \ matlab \ imagesci \ corn.tif'}标签:[演示;ImagesCi] ReadSize:1 ReadFCN:@ReadDataStoreImage

创建一个imageageAtastore.包含四个图像的对象,并预览第一图像。

imds = imageageatastore({'Street1.jpg''Street2.jpg''peppers.png''玉米。'})
IMDS = IMAGEDATASTORE具有属性:文件:{'... \ MATLAB \ TOOLBOX \ MATLAB \ DEMOS \ Street1.jpg';'... \ matlab \ toolbox \ matlab \ demos \ street2.jpg';'... \ matlab \ toolbox \ matlab \ imagesci \ peppers.png'...和1更多} ReadSize:1标签:{} Readfcn:@readdataStoreImage
imshow(预览(IMDS));

一次只读第二个和第三张图像。

为了i = 2:3 img = ReadImage(IMDS,i);结尾

阅读所有四个图像并查看第三个图像。

imgs = Readall(IMDS);imshow(imgs {3})

限制

  • 使用readfcn.不推荐转换或预处理2-D图像。出于识别的文件格式imformats.,指定readfcn.减缓了表现imageageAtastore.。有关更有效的方式来转换和预处理图像,请参阅深度学习的预处理图像(深度学习工具箱)

在R2015B中介绍