readByIndex

(To be removed) Read data specified by index from pixelLabelImageDatastore

pixelLabelImageDatastore object and the readByIndex function will be removed in a future release. For more information, see Version History.

Syntax

data = readByIndex(pximds,ind)

[data,info] = readByIndex(pximds,ind)

Description

data = readByIndex(pximds,ind) returns a subset of observations from a pixel label image datastore, pximds. The desired observations are specified by indices, ind.

[data,info] = readByIndex(pximds,ind) also returns information about the observations, including metadata, in info.

Input Arguments

pximds — Pixel label image datastore

pixelLabelImageDatastore

Pixel label image datastore, specified as a pixelLabelImageDatastore object.

ind — Indices

vector of positive integers

Indices of observations, specified as a vector of positive integers.

Output Arguments

data — Observations from datastore

table

Observations from the datastore, returned as a table with length(ind) number of rows.

info — Information about read data

structure array

Information about read data, returned as a structure array. The structure array can contain the following fields.

Field Name	Description
Filename	Filename is a fully resolved path containing the path string, name of the file, and file extension.
FileSize	Total file size, in bytes. For MAT-files, FileSize is the total number of key-value pairs in the file.

Version History

Introduced in R2018a

R2025a: Warns

The pixelLabelImageDatastore object and the readByIndex function issue a warning that it will be removed in a future release. Use the imageDatastore and pixelLabelDatastore objects and the combine function instead of the pixelLabelImageDatastore object. There is no replacement for the readByIndex function.

R2022b: To be removed

The pixelLabelImageDatastore object and the readByIndex function will be removed in a future release.