Main Content

tiffreadVolume

TIFF ファイルからボリュームまたは時系列イメージ スタックを読み取る

R2020b 以降

    説明

    V = tiffreadVolume(filename) は、filename という名前のマルチページ TIFF ファイルにあるすべてのボリューム データまたは時系列イメージ データを V に読み込みます。V 内では、空間次元および時間次元が先頭にあり、色 (存在する場合) は最後の次元にあります。

    V = tiffreadVolume(filename,'PixelRegion',{rows,columns,slices}) はボリュームまたは時系列 V の一部を読み取ります。{rows,columns,slices} は各次元に沿ったサブサンプリングを指定する cell 配列です。

    すべて折りたたむ

    この例では、TIFF ファイルに保存されているボリューム データを読み取る方法を説明します。

    ファイルからボリューム全体を読み取る

    ボリュームを TIFF ファイルからワークスペースに読み取ります。この例では、ボリュームは 27 個の MRI イメージのスタックです。各イメージのサイズは 128 x 128 ピクセルです。

    V1 = tiffreadVolume('mri.tif');
    whos V1
      Name        Size                 Bytes  Class    Attributes
    
      V1        128x128x27            442368  uint8              
    

    ファイルからボリュームのサブセクションを読み取る

    ボリュームのサブセクションを TIFF ファイルからワークスペースに読み取ります。この例では 'PixelRegion' パラメーターを使用して、ボリュームのどの部分を読み取るかを指定します。サブセクションは {rows, columns, slices} 形式の cell 配列で指定します。この例では、最初のピクセルから読み取りを開始し、行と列の次元で 1 つおきにピクセルを読み取るよう指定します。この例ではスライス 10 から 15 までを読み取ります。

    V2 = tiffreadVolume('mri.tif',...
        'PixelRegion', {[1 2 inf], [1 2 inf], [10 15]});
    whos V2
      Name       Size              Bytes  Class    Attributes
    
      V2        64x64x6            24576  uint8              
    

    入力引数

    すべて折りたたむ

    TIFF ファイルの名前。文字ベクトルまたは string スカラーとして指定します。

    例: "mri.tif"

    データ型: char | string

    サブサンプリングの指示。3 要素 {row,column,slice} を含む cell 配列として指定します。slice の指定はオプションです。指定しない場合、tiffreadVolume はイメージ スタック内のすべてのスライスを読み取ります。

    cell 配列内の各要素は [start stop] または [start stride stop] 形式の数値ベクトルです。start は特定の次元のどこから読み取りを開始するかを指定します。stop は特定の次元のどこで読み取りを停止するかを指定します。次元の最後まで読み取るには、stop に値 inf を指定します。startstop の値は等値を含みます。stride は、特定の次元に沿ってすべてのピクセルを読み取るか、またはピクセルをスキップしてその次元をサブサンプリングするかを指定します。

    たとえば、最初のピクセルから読み取りを開始し、1 つおきにピクセルを読み取り、次元の最後まで読み取りを継続するには、[1 2 inf] と指定します。

    データ型: cell | double | single

    出力引数

    すべて折りたたむ

    ボリュームまたは時系列イメージ スタック。数値配列として返されます。

    ヒント

    この関数は、次の種類の TIFF スタックからのボリューム データおよび時系列データの読み取りをサポートします。

    • 同じサイズおよび種類の個別のイメージ ファイル ディレクトリ (IFD) としてファイルに保存されたイメージ データ。

    • TIFF ImageDepth タグを使用した 1 つのイメージとしてファイルに保存されたイメージ データ。

    • ImageJ によって作成され、4 GB を超えている、BigTIFF 以外の大きなファイルとして保存されたイメージ データ。

    バージョン履歴

    R2020b で導入