このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
write
(削除予定) 新しいファイルへの bigimage
オブジェクトの内容の書き込み
bigimage
オブジェクトの関数 write
は将来のリリースで削除される予定です。代わりに、blockedImage
オブジェクトに関連付けられた関数 write
を使用してください。詳細については、バージョン履歴を参照してください。
構文
説明
write(
は、大きなイメージ bigimg
,filename
,'TIFFCompression',compression
)bigimg
の書式化されたバージョンを filename
という名前の TIFF ファイルに書き込むための圧縮方式も指定します。この構文は、大きなイメージの空間参照情報を保持しません。
write(___,
は、名前と値のペアの引数を使用して、categorical データを書き込む場合の追加オプションを指定します。Name,Value
)
例
ディスクへの大きなイメージ データの書き込み
CAMELYON16 データセットのイメージ "tumor_091.tif" の変更したバージョンを使用して bigimage
を作成します。元のイメージは、腫瘍組織が含まれるリンパ節の学習イメージです。元のイメージには 8 つの解像度レベルがあり、最も細かいレベルの解像度は 53760 x 61440 です。変更したイメージには、3 つの粗い解像度レベルのみが含まれています。変更したイメージの空間参照は、縦横比が一定に維持され、各レベルで特徴がレジストレーションされるように調整されています。
bim = bigimage("tumor_091R.tif");
最も粗い解像度レベル 3 のマスク イメージを作成します。マスクは、グレースケール値が 100 未満のピクセルの場合に 1
(true
) になります。
mask = apply(bim,3,@(im)im2gray(im)<100);
"maskDir" という名前のディレクトリにマスク イメージを書き込みます。ディレクトリは事前に存在していてはなりません。マスク イメージを書き込む前に、ディレクトリが既に存在するかどうかをチェックし、存在する場合は削除します。
imageDir = "maskDir"; if exist(imageDir,"dir") rmdir maskDir s; end write(mask,imageDir);
マスク ディレクトリ内のデータから新しい bigimage
を作成して、ワークスペースにマスク イメージを再度読み込みます。マスクの空間参照情報は保持されます。
mask1 = bigimage("maskDir");
元のイメージを表示します。
figure bigimageshow(bim);
マスク イメージを表示します。空間参照は元のイメージ bim
と一致します。
figure bigimageshow(mask1);
入力引数
bigimg
— 大きなイメージ
bigimage
オブジェクト
大きなイメージ。bigimage
オブジェクトとして指定します。
filename
— ファイル名
string | 文字ベクトル
書き込まれる大きなイメージ データのファイル名。string または文字ベクトルとして指定します。サポートされているファイル拡張子は '.tif'
と '.tiff'
です。
データ型: string
dirname
— ディレクトリ名
string | 文字ベクトル
書き込まれる大きなイメージ データのディレクトリ名。string または文字ベクトルとして指定します。
データ型: string
compression
— TIFF 圧縮方式
"LZW"
(既定値) | "PackBits"
| "Deflate"
| "JPEG"
| "None"
TIFF 圧縮方式。次のいずれかを指定します。
圧縮方式 | 説明 |
---|---|
"LZW" | Lempel-Ziv-Welch 可逆圧縮 |
"PackBits" | PackBits 可逆圧縮 |
"Deflate" | Adobe DEFLATE 可逆圧縮 |
"JPEG" | JPEG ベース非可逆圧縮 |
"None" | 圧縮しない |
データ型: string
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: write(bigimg,filename,Classes=["sky" "vegetation" "building"],PixelLabelIDs=[1 2 3])
は、3 つのクラスを使用して categorical の bigimage
を書き込みます。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name
を引用符で囲みます。
例: write(bigimg,filename,'Classes',["sky" "vegetation" "building"],'PixelLabelIDs',[1 2 3])
は、3 つのクラスを使用して categorical の bigimage
を書き込みます。
Classes
— クラス名
string 配列 | 文字ベクトルの cell 配列
categorical データのクラス名。string 配列、または文字ベクトルの cell 配列として指定します。既定値は、大きなイメージ bigimg
のClasses プロパティの値です。
クラスに PixelLabelIDs
のピクセル値が複数ある場合、write
は最初のピクセル値を使用して、そのクラスのすべてのインスタンスに書き込みます。
データ型: char
| string
PixelLabelIDs
— ピクセル ラベル ID
d 要素の数値ベクトル | データ型 uint8
の d 行 3 列の数値配列
ピクセル ラベルの値を categorical クラス名にマッピングするためのピクセル ラベル ID。次のいずれかとして指定します。
d 要素の数値ベクトル (d はクラスの数)
データ型
uint8
の d 行 3 列の数値配列。各行には、各クラス名と関連付ける RGB ピクセル値を表す 3 要素ベクトルが含まれます。この形式は、ピクセル ラベル データが RGB イメージとして格納されている場合に使用します。
書き込まれるピクセルのデータ型は、PixelLabelIDs
のデータ型と一致します。既定値は、大きなイメージ bigimg
のPixelLabelIDs プロパティの値です。
クラスに PixelLabelIDs
のピクセル値が複数ある場合、write
は最初のピクセル値を使用して、そのクラスのすべてのインスタンスに書き込みます。
UndefinedID
— <undefined>
categorical クラスのピクセル ラベルの値
0
(既定値) | 数値スカラー | 1 行 3 列の数値ベクトル
<undefined>
categorical クラスと PixelLabelIDs
に存在しないピクセル値のピクセル ラベルの値。数値スカラー、または 1 行 3 列の数値ベクトルとして指定します。この値には、PixelLabelIDs
に含まれる値を指定しないでください。既定値は、大きなイメージ bigimg
のUndefinedID プロパティの値です。
バージョン履歴
R2019b で導入R2023b: write
は削除予定
bigimage
オブジェクトとこの関数は将来のリリースで削除される予定です。代わりに、blockedImage
オブジェクトの関数 write
を使用してください。
コードを更新するには、まず、イメージ データを読み取るための blockedImage
オブジェクトを作成します。次に、以下の手順に従います。
非推奨の使用方法 | 推奨される代替案 |
---|---|
この例では、関数 filename = "tumor_091R.tif"; bigIm = bigimage(filename); newFilename = "tumor_091R_copy.tif"; write(bigIm,newFilename); | 以下は、 filename = "tumor_091R.tif"; blockedIm = blockedImage(filename); newFilename = "tumor_091R_copy.tif"; write(blockedIm,newFilename); |
この例では、TIFF 圧縮を使用してファイルを書き込みます。 write(bigIm,newFilename,"TIFFCompression","None"); | 以下は、 adaptor = images.blocked.TIFF; adaptor.Compression = Tiff.Compression.None; write(blockedIm,newFilename,Adapter=adapter); |
R2021a: 関数 write
は非推奨
bigimage
オブジェクトの関数 write
は推奨されません。代わりに、blockedImage
オブジェクトの関数 write
を使用してください。blockedImage
オブジェクトには、N 次元の処理に拡張できる、インターフェイスがシンプルである、非標準イメージ形式の読み書きをカスタムでサポートしている、といったいくつかの利点があります。
参考
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)