read

(削除予定) bigimageDatastore からのデータの読み取り

ページ内をすべて折りたたむ

bigimageDatastore オブジェクトの関数 read は将来のリリースで削除される予定です。代わりに、blockedImageDatastore オブジェクトに関連付けられた関数 read を使用してください。詳細については、バージョン履歴を参照してください。

構文

data = read(bigds)
[data,info] = read(bigds)

説明

data = read(bigds) は、大きなイメージ データストア bigds からデータのバッチを返します。関数 read の後続の呼び出しでは、直前の呼び出しのエンドポイントから引き続き読み取ります。

[data,info] = read(bigds) は、メタデータを含む抽出データに関する情報も、info に返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

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

bim = bigimage('tumor_091R.tif');

最も細かい解像度レベルで大きなイメージのブロックを管理する bigimageDatastore を作成します。

bimds = bigimageDatastore(bim,1)
bimds = 
  bigimageDatastore with properties:

            ReadSize: 1
          BorderSize: [0 0]
           PadMethod: 0
              Images: [1×1 bigimage]
              Levels: 1
           BlockSize: [1024 1024]
        BlockOffsets: [1024 1024]
    IncompleteBlocks: 'same'
    BlockLocationSet: [1×1 blockLocationSet]

データストアの 'ReadSize' プロパティを 3 に変更します。

bimds.ReadSize = 3;

データストアから 1 バッチ分のイメージ データを読み取ります。

[data,info] = read(bimds);

返されたイメージ データを各イメージの周りに黒い境界があるモンタージュに表示します。このモンタージュは、データストアが大きなイメージのブロックを行優先の順序で読み取ることを示しています。

montage(data,'Size',[1 3],"BorderSize",10)

Figure contains an axes object. The axes object contains an object of type image.

返されたデータに関する情報を表示します。

info
info = struct with fields:
              Level: [1 1 1]
        ImageNumber: [1 1 1]
    BlockStartWorld: [3×2 double]
      BlockEndWorld: [3×2 double]
     DataStartWorld: [3×2 double]
       DataEndWorld: [3×2 double]

返されたデータのブロックそれぞれにおいて左上ピクセルの中心の (x,y) 座標を検査します。

info.BlockStartWorld
ans = 3×2

           1           1
        1025           1
        2049           1

入力引数

すべて折りたたむ

大きなイメージ データストア。bigimageDatastore オブジェクトとして指定します。

  • データストアには、1 つ以上の大きなイメージ Images が含まれていて、各イメージには Channels 個のチャネルがあります。

  • データストアは、指定された解像度レベル Levels で、それぞれの大きなイメージからブロックを読み取ります。

  • データストアは、各バッチで読み取るブロックの数 ReadSize を指定します。

  • データストアは、読み取るブロックの m x n のピクセル サイズ BlockSize を指定します。

出力引数

すべて折りたたむ

出力データ。ReadSize 要素を含む cell 配列として返されます。各 cell には m x n x Channels の数値配列が含まれています。

出力データに関する情報。以下のフィールドを含む struct として返されます。

フィールド名説明
Levelデータの解像度レベル。正の整数の 1 行 ReadSize 列ベクトルとして指定します。
ImageNumberデータを提供する大きなイメージのインデックス。正の整数の 1 行 ReadSize 列ベクトルとして指定します。
BlockStartWorldパディングを除く、データの左上ピクセルの中心の (x,y) 座標。ReadSize 行 2 列の数値ベクトルとして指定します。値はワールド座標の値です。
BlockEndWorldパディングを除く、データの右下ピクセルの中心の (x,y) 座標。ReadSize 行 2 列の数値ベクトルとして指定します。値はワールド座標の値です。
DataStartWorldパディングを含む、データの左上ピクセルの中心の (x,y) 座標。ReadSize 行 2 列の数値ベクトルとして指定します。値はワールド座標の値です。
DataEndWorldパディングを含む、データの右下ピクセルの中心の (x,y) 座標。ReadSize 行 2 列の数値ベクトルとして指定します。値はワールド座標の値です。

バージョン履歴

R2019b で導入

すべて展開する

参考

|

トピック