ディープ ラーニングを使用したピクセルの変換 (Image Analyst ツール)
サマリー
トレーニング済みのディープ ラーニング モデルを実行して、画像内のピクセルを変換します。
使用法
このツールは、ディープ ラーニング モデル情報を使用して画像内のピクセルを変換するために使用します。 変換の例としては、ピクセル解像度の向上やカラー画像へのグレースケール画像の変換などがあります。
超解像 モデル タイプを使用すると、画像解像度を向上させることができます。
CycleGAN モデル タイプを使用すると、グレースケールから赤、緑、青 (RGB) 色への変換などの画像変換を実行できます。
Pix2Pix モデル タイプを使用すると、SAR から RGB への変換などの画像変換を実行できます。
モデル定義の JSON ファイル (.emd) については、下記のサンプルをご参照ください。
モデル定義の JSON ファイル (*.emd) のサンプル
<!--```json
{
"Framework": "",
"ModelConfiguration":" ",
"ModelFile":"",
"InferenceFunction":"",
"ModelType":"",
"ImageHeight":256,
"ImageWidth":256,
"ExtractBands":[0,1,2],
"CropSizeFixed": 1,
"BlackenAroundFeature": 1,
"Classes": [
{
"Value": 0,
"Name": "Building",
"Color": [255, 0, 0]
}
]
}
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ラスター
|
変換する 1 つまたは複数の入力ラスター画像。
|
Raster Dataset; Raster Layer; Mosaic Layer; Image Service; Map Server; Map Server Layer; Internet Tiled Layer; Folder; Feature Layer; Feature Class
|
|
モデル定義
|
モデル定義 JSON ファイル (*.emd) へのパス。
|
File; String
|
|
引数
(オプション)
|
モデル定義 パラメーターからの情報が、このパラメーターの設定に使用されます。 これらの引数は、モデル アークテクチャによって変わります。 ArcGIS でトレーニングされるモデルのサポート対象モデル引数は次のとおりです。 ArcGIS の事前トレーニング済みモデルとカスタム ディープ ラーニング モデルは、別途ツールがサポートする引数を持つ場合があります。
batch_size—モデル推論の各ステップで処理された画像タイルの数。 これは、お使いのグラフィックス カードのメモリーに応じて異なります。 この引数はすべてのモデル アーキテクチャーで使用できます。
direction—画像が 2 つのドメイン間で変換されます。 オプションは AtoB と BtoA です。 この引数は CycleGAN アーキテクチャーでのみ使用できます。 この引数の詳細については、CycleGAN の機能 をご参照ください。
n_timestep—使用される時間ステップ数。 デフォルトは 200 です。 生成データの質に応じて増減することができます。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
padding—隣接するタイルの予測がブレンドされる画像タイルの境界のピクセル数。 出力を滑らかにすると同時にアーティファクトを減らすには、この値を大きくします。 パディングの最大値には、タイル サイズの値の半分を設定できます。 この引数はすべてのモデル アーキテクチャーで使用できます。
sampling_type—使用されるサンプリングのタイプ。 ddim (ノイズ除去拡散暗黙モデル) と ddpm (ノイズ除去拡散確率論的モデル) の 2 つのサンプリング タイプを使用できます。 デフォルトは ddim で、ddpm に比べて少ない時間ステップで結果が生成されます。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
schedule—使用する学習率スケジュールのタイプ。このオプションは、モデルのトレーニング中にモデルの学習率を調整するときに使用します。 デフォルトのスケジュールは、トレーニングされたモデルと同じです。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
tile_size—予測のために画像が分割される画像タイルの幅と高さ。 この引数は CycleGAN アーキテクチャーでのみ使用できます。
値テーブル列:
|
Value Table
|
|
処理モード
|
モザイク データセットまたはイメージ サービス内のすべてのラスター アイテムを処理する方法を指定します。 入力ラスターがモザイク データセットまたはイメージ サービスである場合、このパラメーターが適用されます。
|
String
|
|
出力フォルダー
(オプション)
|
出力ラスターが格納されるフォルダー。
このパラメーターは、入力ラスターが画像のフォルダー、またはすべてのアイテムが個別に処理されるモザイク データセットである場合に必須です。 デフォルトは、プロジェクト フォルダー内のフォルダーです。
|
Folder
|
|
出力フィーチャ
(オプション)
|
出力ラスターが格納されるフィーチャクラス。
このパラメーターは、入力ラスターが画像のフィーチャクラスの場合は必須です。
フィーチャクラスがすでに存在する場合、既存のフィーチャクラスに結果が追加されます。
|
Feature Class
|
|
添付ファイルの上書き
(オプション)
|
既存の画像添付ファイルを上書きするかどうかを指定します。
このパラメーターは、入力ラスター パラメーターの値が画像添付ファイルを含むフィーチャクラスの場合にのみ有効です。
|
Boolean
|
|
ピクセル空間の使用
(オプション)
|
マップ空間の画像に対して推論を実行するかどうかを指定します。 ピクセル空間とは、表示エリア内のピクセル数によって定義される x,y 座標空間のことです (1024 x 768 など)。
|
Boolean
|
戻り値
|
ラベル
|
説明
|
データ タイプ
|
|
出力ラスター データセット
|
結果を含むラスターまたはモザイク データセットの名前。
|
Raster
|
TranslatePixelsUsingDeepLearning(in_raster, in_model_definition, {arguments}, processing_mode, {out_translated_folder}, {out_featureclass}, {overwrite_attachments}, {use_pixelspace})
|
名前
|
説明
|
データ タイプ
|
|
in_raster
|
変換する 1 つまたは複数の入力ラスター画像。
|
Raster Dataset; Raster Layer; Mosaic Layer; Image Service; Map Server; Map Server Layer; Internet Tiled Layer; Folder; Feature Layer; Feature Class
|
|
in_model_definition
|
モデル定義 JSON ファイル (*.emd) へのパス。
|
File; String
|
|
arguments
[arguments,...]
(オプション)
|
in_model_definition パラメーターの情報は、このパラメーターのデフォルト値を設定するために使用されます。 これらの引数は、モデル アークテクチャによって変わります。 ArcGIS でトレーニングされるモデルのサポート対象モデル引数は次のとおりです。 ArcGIS の事前トレーニング済みモデルとカスタム ディープ ラーニング モデルは、別途ツールがサポートする引数を持つ場合があります。
batch_size—モデル推論の各ステップで処理された画像タイルの数。 これは、お使いのグラフィックス カードのメモリーに応じて異なります。 この引数はすべてのモデル アーキテクチャーで使用できます。
direction—画像が 2 つのドメイン間で変換されます。 オプションは AtoB と BtoA です。 この引数は CycleGAN アーキテクチャーでのみ使用できます。 この引数の詳細については、CycleGAN の機能 をご参照ください。
n_timestep—使用される時間ステップ数。 デフォルトは 200 です。 生成データの質に応じて増減することができます。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
padding—隣接するタイルの予測がブレンドされる画像タイルの境界のピクセル数。 出力を滑らかにすると同時にアーティファクトを減らすには、この値を大きくします。 パディングの最大値には、タイル サイズの値の半分を設定できます。 この引数はすべてのモデル アーキテクチャーで使用できます。
sampling_type—使用されるサンプリングのタイプ。 ddim (ノイズ除去拡散暗黙モデル) と ddpm (ノイズ除去拡散確率論的モデル) の 2 つのサンプリング タイプを使用できます。 デフォルトは ddim で、ddpm に比べて少ない時間ステップで結果が生成されます。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
schedule—使用する学習率スケジュールのタイプ。このオプションは、モデルのトレーニング中にモデルの学習率を調整するときに使用します。 デフォルトのスケジュールは、トレーニングされたモデルと同じです。 この引数は、Super Resolution with SR3 backbone モデル アーキテクチャーでのみサポートされます。
tile_size—予測のために画像が分割される画像タイルの幅と高さ。 この引数は CycleGAN アーキテクチャーでのみ使用できます。
値テーブル列:
Name—関数の引数の名前。
Value—関数の引数の値。
|
Value Table
|
|
processing_mode
|
モザイク データセットまたはイメージ サービス内のすべてのラスター アイテムを処理する方法を指定します。 入力ラスターがモザイク データセットまたはイメージ サービスである場合、このパラメーターが適用されます。
|
String
|
|
out_translated_folder
(オプション)
|
出力ラスターが格納されるフォルダー。
このパラメーターは、入力ラスターが画像のフォルダー、またはすべてのアイテムが個別に処理されるモザイク データセットである場合に必須です。 デフォルトは、プロジェクト フォルダー内のフォルダーです。
|
Folder
|
|
out_featureclass
(オプション)
|
出力ラスターが格納されるフィーチャクラス。
このパラメーターは、入力ラスターが画像のフィーチャクラスの場合は必須です。
フィーチャクラスがすでに存在する場合、既存のフィーチャクラスに結果が追加されます。
|
Feature Class
|
|
overwrite_attachments
(オプション)
|
既存の画像添付ファイルを上書きするかどうかを指定します。
このパラメーターは、in_raster パラメーターの値が画像添付ファイルを含むフィーチャクラスの場合にのみ有効です。
|
Boolean
|
|
use_pixelspace
(オプション)
|
マップ空間の画像に対して推論を実行するかどうかを指定します。 ピクセル空間とは、表示エリア内のピクセル数によって定義される x,y 座標空間のことです (1024 x 768 など)。
|
Boolean
|
戻り値
|
名前
|
説明
|
データ タイプ
|
|
out_raster
|
結果を含むラスターまたはモザイク データセットの名前。
|
Raster
|
コードのサンプル
TranslatePixelsUsingDeepLearning の例 1 (Python ウィンドウ)
この例では、ディープ ラーニング モデルを用いて変換済み画像を出力します。
# Import system modules
import arcpy
from arcpy.ia import *
out_raster = TranslatePixelsUsingDeepLearning(
"c:\\input_image.tif", "c:\\superresolution.emd",
"padding 0; batch_size 16", "PROCESS_AS_MOSAICKED_IMAGE")
out_raster.save("c:\\translated_image.tif")
TranslatePixelsUsingDeepLearning の例 2 (スタンドアロン スクリプト)
この例では、ディープ ラーニング モデルを用いて変換済み画像を出力します。
# Import system modules
import arcpy
from arcpy.ia import *
# Set local variables
in_raster = "c:\\input_raster.tif"
in_model_definition = "c:\\translatepixels.emd"
model_arguments = "padding 0; batch_size 16"
processing_mode = "PROCESS_AS_MOSAICKED_IMAGE"
arcpy.env.processorType = "GPU"
arcpy.env.gpuId = 0
# Run
out_raster = TranslatePixelsUsingDeepLearning(in_raster,
in_model_definition, model_arguments, processing_mode)
out_raster.save("c:\\translated_image.tif")
環境
セル サイズ, 現在のワークスペース, 範囲, 地理座標系変換, GPU ID, マスク, 出力座標系, 並列処理ファクター, プロセッサー タイプ, スクラッチ ワークスペース, スナップ対象ラスター
ライセンス情報
- Basic: Image Analyst が必要
- Standard: Image Analyst が必要
- Advanced: Image Analyst が必要