このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

bigimageDatastore

(非推奨) 大きなイメージ データのブロックを管理するデータストア

R2019b 以降

bigimageDatastore オブジェクトは推奨されません。代わりに、blockedImageDatastore オブジェクトを使用してください。詳細については、互換性の考慮事項を参照してください。

説明

bigimageDatastore オブジェクトは、1 つ以上の bigimage オブジェクトが属するイメージ ブロックのコレクションを管理します。bigimageDatastore は、関連付けられていないイメージのコレクションを管理する imageDatastore と類似しています。

作成

構文

bigds = bigimageDatastore(images)

bigds = bigimageDatastore(images,levels)

bigds = bigimageDatastore(images,levels,Name,Value)

bigds = bigimageDatastore(images,'BlockLocationSet',blockLocationSet)

bigds = bigimageDatastore(images,'BlockLocationSet',blockLocationSet,Name,Value)

説明

イメージ全体のブロックを読み取るデータストアの作成

bigds = bigimageDatastore(images) は、最も細かい解像度レベルで 1 つ以上の bigimage オブジェクト Images のイメージ ブロックのコレクションを管理するデータストアを作成します。

bigds = bigimageDatastore(images,levels) は、指定した解像度レベル Levels で 1 つ以上の bigimage オブジェクト Images のイメージ ブロックのコレクションを管理するデータストアを作成します。

bigds = bigimageDatastore(images,levels,Name,Value) は、名前と値のペアも使用して、BlockLocationSet 以外のプロパティを 1 つ以上設定します。複数の名前と値のペアを指定できます。各プロパティ名を引用符で囲みます。

例: bigimageDatastore(bigimg,3,'BlockSize',[128 128],'IncompleteBlocks','pad') は、大きなイメージ bigimg から解像度レベル 3 でサイズが 128 行 128 列のブロックを読み取るデータストアを作成し、部分エッジ ブロックをゼロ パディングします。

指定された位置のブロックを読み取るデータストアの作成

bigds = bigimageDatastore(images,'BlockLocationSet',blockLocationSet) は、BlockLocationSet で指定した解像度レベル、ブロック サイズ、ブロック位置を使用して、bigimage オブジェクト Images からブロックを読み取るデータストアを作成します。

bigds = bigimageDatastore(images,'BlockLocationSet',blockLocationSet,Name,Value) は、名前と値のペアも使用して BorderSize、IncompleteBlocks、PadMethod、および ReadSize プロパティを 1 つ以上設定します。複数の名前と値のペアを指定できます。各プロパティ名を引用符で囲みます。

例: bigimageDatastore(bigimg,'BlockLocationSet',bls,'ReadSize',4) は、bls で指定した位置、ブロック サイズ、解像度レベルに従い、大きなイメージ bigimg から一度に 4 つのブロックを読み取るデータストアを作成します。

プロパティ

BlockLocationSet — ブロック位置

blockLocationSet オブジェクト

ブロック位置。blockLocationSet オブジェクトとして指定します。

BlockOffsets — ブロックのオフセット

正の整数の 1 行 2 列のベクトル

ブロックのオフセット。[numrows numcols] 形式の正の整数の 1 行 2 列ベクトルとして指定します。

既定値は BlockSize に等しくなります。read の呼び出し中にブロックを重ねるには、より小さい値を指定します。ブロック間のギャップを追加するには、より大きい値を指定します。

BlockSize — ブロック サイズ

正の整数の 1 行 2 列のベクトル

読み取りデータのブロック サイズ。[numrows numcols] 形式の正の整数の 1 行 2 列ベクトルとして指定します。既定値は、Levels の最初の解像度レベルで Images 内の最初の大きなイメージの BlockSize プロパティに等しくなります。

BorderSize — 境界サイズ

[0 0] (既定値) | 非負の整数の 1 行 2 列のベクトル

境界サイズ。[m n] 形式の非負の整数の 1 行 2 列ベクトルとして指定します。関数は、m 行を各ブロックの上下に追加し、n 列を近傍ブロックからのデータと共に各ブロックの左右に追加します。イメージのエッジにあるブロックでは、データは IncompleteBlocks に従ってパディングされます。既定では、このデータストアはブロックに境界を追加しません。

Images — 大きなイメージ

bigimage オブジェクトの b 要素ベクトル

bigimageDatastore にブロックを提供する大きなイメージ。bigimage オブジェクトの b 要素ベクトルとして指定します。同じ大きなイメージから異なる解像度レベルを読み取るには、このベクトルに同じイメージを複数回指定します。

IncompleteBlocks — エッジ ブロックを処理する方法

"same" (既定値) | "exclude" | "pad"

BlockSize より小さいエッジ ブロックを処理する方法。次のいずれかの値を指定します。

値	平均
"same"	エッジ ブロックと同じサイズのデータを返します。
"exclude"	read の呼び出しにエッジ ブロックを含めません。
"pad"	PadMethod で指定されたパディング方法を使用して、不完全なブロックを BlockSize と同じサイズにパディングします。

Levels — 解像度レベル

正の整数 | 正の整数の b 要素ベクトル

Images 内のそれぞれの大きなイメージに含まれるブロックの解像度レベル。正の整数のスカラーまたは正の整数の b 要素ベクトルとして指定します。スカラー値を指定した場合、すべての大きなイメージが同じ解像度レベルでデータストアにブロックを提供します。

データ型: double

PadMethod — パディング方法

数値スカラー | string スカラー | "replicate" | "symmetric"

不完全なエッジ ブロックのパディング方法。次のいずれかの値を指定します。既定では、このデータストアは数値ブロックを 0 によってパディングし、categorical ブロックを missing によってパディングします。

値	平均
数値スカラー	定数値の要素によって数値配列をパディングします。
string スカラー	基となる bigimage の Classes プロパティにある指定されたクラスによって categorical 配列をパディングします。
"replicate"	配列の境界の要素を繰り返すことによってパディングします。
"symmetric"	配列自体の鏡像で配列をパディングします。

ReadSize — 返すブロックの数

1 (既定値) | 正の整数

read の各呼び出しで返すブロックの数。正の整数として指定します。

オブジェクト関数

combine	複数のデータストアのデータを統合
countEachLabel	(非推奨) bigimageDatastore オブジェクトの各クラスのピクセル ラベル数のカウント
hasdata	データが読み取り可能かどうかを判別
numpartitions	データストアの区画数
partition	(非推奨) bigimageDatastore の分割
preview	データストア内のデータのサブセットをプレビュー
read	(非推奨) bigimageDatastore からのデータの読み取り
readRelative	(非推奨) 相対的な位置を使用した bigimageDatastore からの近傍ブロックの読み取り
reset	データストアの初期状態へのリセット
shuffle	データストア内のデータのシャッフル
transform	データストアの変換
isPartitionable	データストアが分割可能かどうかを判別
isShuffleable	データストアがシャッフル可能かどうかを判別

例

大きなイメージ データストアの作成とブロック サイズの指定

CAMELYON16 データセットのイメージ "tumor_091.tif" の変更したバージョンを使用して bigimage を作成します。元のイメージは、腫瘍組織が含まれるリンパ節の学習イメージです。元のイメージには 8 つの解像度レベルがあり、最も細かいレベルの解像度は 53760 x 61440 です。変更したイメージには、3 つの粗い解像度レベルのみが含まれています。変更したイメージの空間参照は、縦横比が一定に維持され、各レベルで特徴がレジストレーションされるように調整されています。

bim = bigimage('tumor_091R.tif');

各解像度レベルで bigimage の既定のブロック サイズを表示します。ブロック サイズは [numrows, numcols] 形式の 2 要素ベクトルです。

t = table((1:3)',bim.BlockSize,'VariableNames',["Level" "Block Size"]);
disp(t)

    Level     Block Size 
    _____    ____________

      1      1024    1024
      2      1024    1024
      3      1024    1024

関数 bigimageshow を使用して bigimage を表示します。

bigimageshow(bim);

解像度レベル 1 で bigimageDatastore を作成します。既定以外のブロック サイズを指定します。一度に 4 ブロックを読み取るようにデータストアを設定します。

bimds = bigimageDatastore(bim,2,'BlockSize',[512 512],'ReadSize',4)

bimds = 
  bigimageDatastore with properties:

            ReadSize: 4
          BorderSize: [0 0]
           PadMethod: 0
              Images: [1x1 bigimage]
              Levels: 2
           BlockSize: [512 512]
        BlockOffsets: [512 512]
    IncompleteBlocks: 'same'
    BlockLocationSet: [1x1 blockLocationSet]

データストアから 1 バッチ分のデータを読み取ります。3 番目のブロックは部分エッジ ブロックであり、内部ブロックよりもサイズが小さいことに注目してください。返されたイメージ パッチをモンタージュとして表示します。3 番目のブロックの幅は完全なブロックの幅よりも小さいので、モンタージュでは、このブロックに太い境界が表示されます。

blocks = read(bimds)

blocks=4×1 cell array
    {512x512x3 uint8}
    {512x512x3 uint8}
    {512x316x3 uint8}
    {512x512x3 uint8}

montage(blocks,'Size',[1 bimds.ReadSize],'BorderSize',5,'BackgroundColor','k');

データストアから次のバッチのデータを読み取り、返されたイメージ パッチをモンタージュとして表示します。部分ブロックの次元は完全なブロックの次元よりも小さいので、モンタージュでは、部分ブロックに太い境界が表示されます。

blocks = read(bimds)

blocks=4×1 cell array
    {512x512x3 uint8}
    {512x316x3 uint8}
    {226x512x3 uint8}
    {226x512x3 uint8}

montage(blocks,'Size',[1 bimds.ReadSize],'BorderSize',5,'BackgroundColor','k');

データストアから最後のバッチのデータを読み取ります。この読み取り操作は、唯一の残りのパッチを含む部分バッチを返します。パッチを表示します。

blocks = read(bimds)

blocks = 1x1 cell array
    {226x316x3 uint8}

montage(blocks,'Size',[1 bimds.ReadSize],'BorderSize',5,'BackgroundColor','k');

大きなイメージ データストアの作成とマスクの指定

CAMELYON16 データセットのイメージ "tumor_091.tif" の変更したバージョンを使用して bigimage を作成します。元のイメージは、腫瘍組織が含まれるリンパ節の学習イメージです。元のイメージには 8 つの解像度レベルがあり、最も細かいレベルの解像度は 53760 x 61440 です。変更したイメージには、3 つの粗い解像度レベルのみが含まれています。変更したイメージの空間参照は、縦横比が一定に維持され、各レベルで特徴がレジストレーションされるように調整されています。

bim = bigimage('tumor_091R.tif');

関数 bigimageshow を使用して bigimage を表示します。

h = bigimageshow(bim);

最も粗い解像度レベルでマスクを作成し、元の空間参照情報を保持します。

clevel = bim.CoarsestResolutionLevel;
imcoarse = getFullLevel(bim,clevel);
stainMask = ~imbinarize(rgb2gray(imcoarse));
bmask = bigimage(stainMask,'SpatialReferencing',bim.SpatialReferencing(clevel));

関数 selectBlockLocations を使用して、bigimage から読み取るブロックの位置を指定します。ブロック サイズを 256 x 256 ピクセルとして設定します。名前と値のペアの引数 'InclusionThreshold' を指定して、マスクによって定義される ROI 内の少なくとも 75% のブロックを選択します。既定では、selectBlockLocations は大きなイメージの最も細かい解像度レベルからブロックを選択します。

t = 0.75;
blockSize = [256 256];
blockSet = selectBlockLocations(bim,"BlockSize",blockSize, ...
    "Masks",bmask,"InclusionThreshold",t);

blockLocationSet で指定した位置から一度に 4 つのブロックを読み取る bigimageDatastore を作成します。

bimds = bigimageDatastore(bim,"BlockLocationSet",blockSet,"ReadSize",4);

データストアによってどのパッチが読み取られるかをプレビューするには、同じブロック サイズと包含しきい値を使用して元の bigimage の上にマスクを重ねて表示します。オーバーレイは、マスクによって定義される ROI 内に少なくとも 75% が含まれるパッチを緑色で強調表示します。

showmask(h,bmask,'BlockSize',blockSize,'InclusionThreshold',t)

データストアから最初のバッチのデータを読み取り、返されたイメージ パッチをモンタージュとして表示します。これらのパッチの内容はオーバーレイの緑色のブロックに一致します。

blocks = read(bimds);
montage(blocks,'Size',[1 bimds.ReadSize],'BorderSize',5,'BackgroundColor','k');

指定されたブロック位置からの大きなイメージ ブロックの読み取り

CAMELYON16 データセットのイメージ "tumor_091.tif" の変更したバージョンを使用して bigimage を作成します。元のイメージは、腫瘍組織が含まれるリンパ節の学習イメージです。元のイメージには 8 つの解像度レベルがあり、最も細かいレベルの解像度は 53760 x 61440 です。変更したイメージには、3 つの粗い解像度レベルのみが含まれています。変更したイメージの空間参照は、縦横比が一定に維持され、各レベルで特徴がレジストレーションされるように調整されています。

bim = bigimage('tumor_091R.tif');

最も細かい解像度レベルで bigimage 全体を表示します。

bshow = bigimageshow(bim);

最も細かい解像度レベルで 4 つの [x y] ブロック位置を指定します。最初の 2 つのブロックは、垂直方向に重なっています。後の 2 つのブロックは水平に隣接しています。

xyLocations = [ ...
    2800 1300; ...
    2800 1400; ...
    1500 2400; ...
    1800 2400];
blockSize = [300,300];

すべて、同じイメージからのブロックです。すべてのブロックのイメージ番号に 1 を指定します。

imageNumber = [1 1 1 1]';

ブロックの位置を格納する blockLocationSet オブジェクトを作成します。

locationSet = blockLocationSet(imageNumber,xyLocations,blockSize);

blockLocationSet オブジェクトで指定した位置の大きなイメージ bim からブロックを読み取る bigimageDatastore オブジェクトを作成します。

bimds = bigimageDatastore(bim,'BlockLocationSet',locationSet);

データストアから一度に 2 つのブロックを読み取り、モンタージュに表示します。

bimds.ReadSize = 2;
while hasdata(bimds)
    figure
    blocks = read(bimds);
    montage(blocks,'BorderSize',5,'BackgroundColor','b');
end

参照

[1] Bejnordi, Babak Ehteshami, Mitko Veta, Paul Johannes van Diest, Bram van Ginneken, Nico Karssemeijer, Geert Litjens, Jeroen A. W. M. van der Laak, et al. “Diagnostic Assessment of Deep Learning Algorithms for Detection of Lymph Node Metastases in Women With Breast Cancer.” JAMA 318, no. 22 (December 12, 2017): 2199–2210. https://doi.org/10.1001/jama.2017.14585.

バージョン履歴

R2019b で導入

R2021a: bigimageDatastore は非推奨

R2021a 以降、bigimage オブジェクトからデータを読み取る bigimageDatastore オブジェクトは非推奨になりました。代わりに、blockedImage オブジェクトからデータを読み取る blockedImageDatastore オブジェクトを使用してください。blockedImage オブジェクトには、N 次元の処理に拡張できる、インターフェイスがシンプルである、非標準イメージ形式の読み書きをカスタムでサポートしている、といったいくつかの利点があります。

コードの更新

bigimageDatastore オブジェクトのすべてのインスタンスを更新してください。

非推奨の使用方法	推奨される代替案
この例では bigimageDatastore オブジェクトを作成します。 bim = bigimage('tumor_091R.tif'); bimds = bigimageDatastore(bim);	次のコードは等価なコードで、bigimageDatastore オブジェクトが新しい blockedImageDatastore オブジェクトに置き換えられています。 bim = blockedImage('tumor_091R.tif'); bimds = blockedImageDatastore(bim);

blockedImageDatastore オブジェクトは、bigimageDatastore オブジェクトの場合とは異なるプロパティおよび関数をサポートしています。たとえば、blockedImageDatastore オブジェクトは、BlockOffset プロパティと IncompleteBlocks プロパティをサポートしていませんが、その代わりに TotalNumBlocks プロパティをサポートしています。blockedImageDatastore オブジェクトは、関数 readRelative をサポートしていません。

R2020b: bigimageDatastore の Mask および InclusionThreshold のプロパティは非推奨

R2020b 以降、bigimageDatastore の Mask および InclusionThreshold のプロパティは非推奨になりました。代わりに、まず関数 selectBlockLocations の入力引数として、マスクと包含しきい値を指定します。次に、結果のblockLocationSet オブジェクトを、bigimageDatastore への入力として指定します。

bigimageDatastore の代表的な使用法と、selectBlockLocations を使用するためのコードの更新方法を、次の表に示します。

非推奨	推奨
b = bigimageDatastore(bigimg,1,'Masks',m)	bls = selectBlockLocations(bigimg,'Masks',m); b = bigimageDatastore(bigimg,'BlockLocationSet',bls)
b = bigimageDatastore(bigimg,3,'Masks',m,'InclusionThreshold',t)	bls = selectBlockLocations(bigimg,'Levels',3, ... 'Masks',m,'InclusionThreshold',t); b = bigimageDatastore(bigimg,'BlockLocationSet',bls)

参考

blockedImage | selectBlockLocations | blockLocationSet

トピック

• ROI およびマスクからのラベル付きのブロック化されたイメージの作成
• Preprocess Multiresolution Images for Training Classification Network
• 深層学習用のデータストア (Deep Learning Toolbox)

外部の Web サイト

• https://camelyon17.grand-challenge.org/Data/

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい