partition

(To be removed) Partition bigimageDatastore

The partition function of the bigimageDatastore object will be removed in a future release. Use the partition function associated with the blockedImageDatastore object instead. For more information, see Version History.

Syntax

outds = partition(bigds,n,index)

Description

outds = partition(bigds,n,index) partitions big image datastore bigds into the number of parts specified by n and returns the partition corresponding to the index index.

Input Arguments

bigds — Big image datastore

bigimageDatastore object

Big image datastore, specified as a bigimageDatastore object.

n — Number of partitions

positive integer

Number of partitions, specified as a positive integer.

Example: 3

Data Types: double

index — Index

positive integer

Index, specified as a positive integer.

Example: 1

Data Types: double

Output Arguments

outds — Output datastore

bigimageDatastore object

Output datastore, returned as a bigimageDatastore object.

Version History

Introduced in R2019b

R2024b: Warns

The partition function issues a warning that it will be removed in a future release.

R2023b: To be removed

The bigimageDatastore object and this function will be removed in a future release. Use the partition function of the blockedImageDatastore object instead.

To update your code, first create a blockedImage object to read your image data, then create a blockedImageDatastore to manage blocks of the data. In the call to the partition function, replace the first input argument with the blockedImage object. You do not need to change the other arguments.

Discouraged Usage	Recommended Replacement
This example partitions a bigimageDatastore object into three parts. bigIm = bigimage("tumor_091R.tif"); bigDS = bigimageDatastore(bigIm); outds = partition(bigDS,3,1);	Here is equivalent code that partitions a blockedImageDatastore object. blockedIm = blockedImage("tumor_091R.tif"); blockedDS = blockedImageDatastore(blockedIm); outds = partition(blockedDS,3,1);

R2021a: partition function is not recommended

Starting in R2021a, the bigimageDatastore object and its object functions, which operate on data from bigimage objects, are no longer recommended. Instead, use the blockedImageDatastore object and its object functions, which operate on data from blockedImage objects. The blockedImage object offers several advantages including extension to N-D processing, a simpler interface, and custom support for reading and writing nonstandard image formats.