多次元ラスターの管理 (Manage Multidimensional Raster) (マルチディメンション)

サマリー

変数またはディメンションを追加または削除し、多次元ラスターを編集します。

使用法

• このツールを使用すると、多次元ラスターを編集できます。 このツールは、新しいデータセットは生成しません。多次元ラスターを変更します。 データセットを作成するには、[多次元ラスターのサブセット (Subset Multidimensional Raster)] ツールまたは [ラスターのコピー (Copy Raster)] ツールを使用します。その後、このツールでさらに編集します。

• ターゲットおよび入力ラスターは、CRF (Cloud Raster Format) 形式である必要があります。 現在、その他の形式はこのツールでサポートされていません。 多次元モザイク データセットまたは多次元ラスター レイヤーを .crf ファイルに変換するには、[ラスターのコピー (Copy Raster)] ツールを使用して、出力形式として CRF を選択し、データセットを多次元として処理するように選択します。

• [管理モード] パラメーターは、実行する編集操作のタイプを設定します。 このパラメーターは、次のオプションをサポートしています。

  • [ディメンションの追加] - データセットにディメンションを追加します。 ディメンションの名前、説明、単位を指定する必要があります。 ディメンションを追加したら、ディメンションが同じ別の多次元データセットからスライスを追加できます。

    注意:

    入力 CRF データセットが多次元ラスターでない場合、このツールを使用して多次元ラスターを作成することはできません。 代わりに、[ラスター プロパティを設定 (Set Raster Properties)] ツールを使用して多次元ラスターを作成します。

  • [ディメンションの削除] - データセットからディメンションを削除します。 削除する各ディメンションには、1 つの値のみを含めることができます。
  • [スライスの追加] - 1 つまたは複数の入力多次元ラスターから、ターゲット多次元ラスターのスライスのスタック末尾にスライスを追加します。 多次元ラスターの変数とディメンション名は完全に一致する必要があります。ラスター間で重複するディメンション値は追加できません。 追加されるスライスのディメンション値は、ターゲット多次元ラスターのディメンション値の後に続く必要があります。
  • [スライスの置換] - ターゲット多次元ラスターからスライスを削除し、別の多次元ラスターのスライスに置き換えます。 多次元ラスターの変数とディメンション名は完全に一致する必要があります。重複するスライスのみが置換されます。
  • [変数の追加] - 1 つまたは複数の入力多次元ラスターのすべての変数を、ターゲット多次元ラスターの変数のリスト末尾に追加します。 変数名がターゲット多次元ラスターにすでに存在する場合、その変数は追加されません。 複数の入力多次元ラスターに同じ名前の変数が含まれている場合、最初にリストされている入力ラスターの変数がターゲット多次元ラスターに追加されます。
  • [変数の削除] - ターゲット多次元ラスターから 1 つまたは複数の変数と、対応するスライスを削除します。 多次元ラスターには、少なくとも 1 つの変数を残しておく必要があります。
  • [ディメンション値の切り捨て] - 日付値を切り捨てるか、開始と終了の値を選択することによって (ディメンション値が範囲の場合)、ディメンション値を変更します。

• [切り捨て単位] パラメーターで、使用する日付と時刻の切り捨て単位を指定します。 このパラメーターは、manage_mode パラメーターが TRUNCATE_DIMENSION_VALUES に設定されており、[ディメンション名] パラメーターが [StdTime] に設定されている場合に必須です。

• 日付値を切り捨てる際、[切り捨て単位] パラメーターで [年]、[月]、[日]、[時]、[分]、[秒] のいずれかのオプションを選択できます。 たとえば、時間ディメンションの値が 2013-03-19T12:30:00 の場合、[時] オプションを選択すると、時より後ろの値が切り捨てられ、ディメンション値は 2013-03-19T12:00:00 になります。[月] オプションを選択すると、ディメンション値は 2013-03-01T00:00:00 になります。 このパラメーターは、[ディメンション名] パラメーターの値が時間ベースの場合にのみ適用されます。

• [管理モード] パラメーターの [スライスの追加]、[スライスの置換]、および [変数の追加] オプションを使用するには、すべての入力データが完全に同じ空間参照、空間範囲、セル サイズである必要があります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
ターゲット多次元ラスター	変更される CRF 形式の多次元ラスター。	Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
管理モード (オプション)	ターゲット ラスターに実行する変更のタイプを指定します。 ディメンションの追加—ディメンションが入力多次元ラスターに追加されます。 スライスの追加—入力多次元ラスターのスライスが、ディメンションのスライス末尾に追加されます。 これがデフォルトです。 変数の追加—入力多次元ラスターの変数が追加されます。 スライスの置換—特定のディメンション値で、既存のスライスが別の多次元ラスターのスライスに置き換えられます。 変数の削除—1 つまたは複数の変数が多次元ラスターから削除されます。 ディメンションの削除—スライスが 1 つである多次元ラスターは、次元のないラスターに変換されます。 ディメンション値の切り捨て—日付値を切り捨てるか、開始と終了の値を選択することによって (ディメンション値が範囲の場合)、ディメンション値が変更されます。	String
変数 (オプション)	ターゲット多次元ラスターで変更される変数。 このパラメーターは、実行される操作が既存の変数の変更である場合に必要です。 変数が指定されない場合、ターゲット多次元ラスターの最初の変数が変更されます。	String
入力多次元ラスター (オプション)	ターゲット多次元ラスターに追加されるスライスまたは変数を含む多次元ラスター データセット。 このパラメーターは、[管理モード] パラメーターが [スライスの追加]、[スライスの置換]、または [変数の追加] に設定されている場合に必要です。	Raster Dataset; Raster Layer; Image Service
ディメンション名 (オプション)	ラスター プロパティに追加されるか、ラスター プロパティから削除されるディメンションの名前。 このパラメーターは、[管理モード] パラメーターが [ディメンションの追加] または [ディメンション値の切り捨て] に設定されている場合に必須です。 [管理モード] パラメーターが [ディメンションの削除] に設定されている場合、指定のディメンションには 1 つの値のみを含めることができます。 [ディメンション名] パラメーターの値が指定されておらず、入力に 1 つのスライスのみが含まれている場合、すべてのディメンションが削除されます。	String
ディメンション値 (オプション)	追加されるディメンションの値。 値には、単一値または値の範囲を指定できます。 値の範囲の場合、最小値と最大値をカンマで区切って指定します。 たとえば、新しい高さディメンションの場合、「0,10」と入力すると、最初のスライスに最初の高さの 10 メートルの情報が含まれるディメンションが生成されます。 このパラメーターは、[管理モード] パラメーターが [ディメンションの追加] に設定されている場合に必要です。	String
ディメンションの説明 (オプション)	メタデータのために、ラスター プロパティに追加される新しいディメンションの説明。 このパラメーターは、[管理モード] パラメーターが [ディメンションの追加] に設定されている場合にアクティブになります。	String
ディメンションの単位 (オプション)	メタデータのために、ラスター プロパティに追加される新しいディメンションの単位。 このパラメーターは、[管理モード] パラメーターが [ディメンションの追加] に設定されている場合にアクティブになります。	String
統計の更新 (オプション)	多次元ラスター データセットに対して統計を再計算するかどうかを指定します。 オン - 統計は再計算されます。 これがデフォルトです。 オフ - 統計は再計算されません。	Boolean
転置の更新 (オプション)	多次元ラスター データセットに対して転置を再構築するかどうかを指定します。 オン - 転置は再構築されます。 転置が存在しない場合は、新しい転置が構築されます。 これがデフォルトです。 オフ - 転置は再構築されません。	Boolean
切り捨て単位 (オプション)	使用する日付と時刻の切り捨て単位を指定します。 このパラメーターは、[管理モード] パラメーターが [ディメンション値の切り捨て] に設定されており、[ディメンション名] パラメーターが [StdTime] に設定されている場合に必須です。 秒—切り捨ての時間単位として秒が指定されます。 分—切り捨ての時間単位として分が指定されます。 時—切り捨ての時間単位として時が指定されます。 日—切り捨ての時間単位として日が指定されます。 月—切り捨ての時間単位として月が指定されます。 年—切り捨ての時間単位として年が指定されます。	String
開始/終了のキーワード (オプション)	[管理モード] パラメーターが [ディメンション値の切り捨て] に設定されている場合のディメンション値の切り捨て方法を指定します。 開始—開始値でディメンション値を切り捨てます。 終了—終了値でディメンション値を切り捨てます。 両方—開始値と終了値の両方でディメンション値を切り捨てます。	String

派生した出力

ラベル	説明	データ タイプ
ターゲット多次元ラスター	変更される多次元ラスター。	Raster Layer

Python

arcpy.management.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose}, {truncation_unit}, {startEnd_keyword})

名前	説明	データ タイプ
target_multidimensional_raster	変更される CRF 形式の多次元ラスター。	Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
manage_mode (オプション)	ターゲット ラスターに実行する変更のタイプを指定します。 ADD_DIMENSION—ディメンションが入力多次元ラスターに追加されます。 APPEND_SLICES—入力多次元ラスターのスライスが、ディメンションのスライス末尾に追加されます。 これがデフォルトです。 APPEND_VARIABLES—入力多次元ラスターの変数が追加されます。 REPLACE_SLICES—特定のディメンション値で、既存のスライスが別の多次元ラスターのスライスに置き換えられます。 DELETE_VARIABLES—1 つまたは複数の変数が多次元ラスターから削除されます。 REMOVE_DIMENSION—スライスが 1 つである多次元ラスターは、次元のないラスターに変換されます。 TRUNCATE_DIMENSION_VALUES—日付値を切り捨てるか、開始と終了の値を選択することによって (ディメンション値が範囲の場合)、ディメンション値が変更されます。	String
variables [variables,...] (オプション)	ターゲット多次元ラスターで変更される変数。 このパラメーターは、実行される操作が既存の変数の変更である場合に必要です。 変数が指定されない場合、ターゲット多次元ラスターの最初の変数が変更されます。	String
in_multidimensional_rasters [in_multidimensional_rasters,...] (オプション)	ターゲット多次元ラスターに追加されるスライスまたは変数を含む多次元ラスター データセット。 このパラメーターは、manage_mode パラメーターが APPEND_SLICES、REPLACE_SLICES、または APPEND_VARIABLES に設定されている場合に必須です。	Raster Dataset; Raster Layer; Image Service
dimension_name (オプション)	ラスター プロパティに追加されるか、ラスター プロパティから削除されるディメンションの名前。 このパラメーターは、manage_mode パラメーターが ADD_DIMENSION に設定されている場合に必須です。 manage_mode パラメーターが REMOVE_DIMENSION に設定されている場合、指定のディメンションには 1 つの値のみを含めることができます。 dimension_name パラメーターの値が指定されておらず、入力に 1 つのスライスのみが含まれている場合、すべてのディメンションが削除されます。	String
dimension_value (オプション)	追加されるディメンションの値。 値には、単一値または値の範囲を指定できます。 値の範囲の場合、最小値と最大値をカンマで区切って指定します。 たとえば、新しい高さディメンションの場合、「0,10」と入力すると、最初のスライスに最初の高さの 10 メートルの情報が含まれるディメンションが生成されます。 このパラメーターは、manage_mode パラメーターが ADD_DIMENSION に設定されている場合に必須です。	String
dimension_description (オプション)	メタデータのために、ラスター プロパティに追加される新しいディメンションの説明。 このパラメーターは、manage_mode パラメーターが ADD_DIMENSION に設定されている場合にアクティブになります。	String
dimension_unit (オプション)	メタデータのために、ラスター プロパティに追加される新しいディメンションの単位。 このパラメーターは、manage_mode パラメーターが ADD_DIMENSION に設定されている場合に有効になります。	String
update_statistics (オプション)	多次元ラスター データセットに対して統計を再計算するかどうかを指定します。 UPDATE_STATISTICS—統計を再計算します。 これがデフォルトです。 NO_UPDATE_STATISTICS—統計は再計算されません。	Boolean
update_transpose (オプション)	多次元ラスター データセットに対して転置を再構築するかどうかを指定します。 UPDATE_TRANSPOSE—転置は再構築されます。 転置が存在しない場合は、新しい転置が構築されます。 これがデフォルトです。 NO_UPDATE_TRANSPOSE—転置は再構築されません。	Boolean
truncation_unit (オプション)	使用する日付と時刻の切り捨て単位を指定します。 このパラメーターは、manage_mode パラメーターが TRUNCATE_DIMENSION_VALUES に設定されていて、dimension_name パラメーターが STDTIME に設定されている場合に必須です。 SECOND—切り捨ての時間単位として秒が指定されます。 MINUTE—切り捨ての時間単位として分が指定されます。 HOUR—切り捨ての時間単位として時が指定されます。 DAY—切り捨ての時間単位として日が指定されます。 MONTH—切り捨ての時間単位として月が指定されます。 YEAR—切り捨ての時間単位として年が指定されます。	String
startEnd_keyword (オプション)	manage_mode パラメーターが TRUNCATE_DIMENSION_VALUES に設定されている場合のディメンション値の切り捨て方法を指定します。 START—開始値でディメンション値を切り捨てます。 END—終了値でディメンション値を切り捨てます。 BOTH—開始値と終了値の両方でディメンション値を切り捨てます。	String

派生した出力

名前	説明	データ タイプ
updated_target_multidimensional_raster	変更される多次元ラスター。	Raster Layer

コードのサンプル

ManageMultidimensionalRaster の例 1 (Python ウィンドウ)

この例では、多次元ラスターの末尾にスライスを追加し、統計を更新します。

# Import system modules
import arcpy

# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
	"C:/data/temp1980_1990.crf", "APPEND_SLICES", "Temp", 
	["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"],None,
	None,None, None, "UPDATE_STATISTICS")

ManageMultidimensionalRaster の例 2 (スタンドアロン スクリプト)

この例では、スライスを置換し、変数を追加して、ターゲット多次元ラスターにディメンションを追加します。

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/hycom.crf"
manage_mode_replace = "REPLACE_SLICES"
manage_mode_append = "APPEND_VARIABLES"
manage_mode_newDimension = "ADD_DIMENSION"
variables = "water_temp"
replace_multidimensional_rasters = "C:/new_data/new_hycom1985.crf"
salinity_multidimensional_raster = "C:/data/salinity.crf"
dimension_name = "Depth"
dimension_value = "0,5"
dimension_description = "Depth at 5m increments"
dimension_unit = "meter"

# Replace existing slices with new slices
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_replace, 
	variables, replace_multidimensional_rasters)

# Append salinity variable
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_append,
	'', salinity_multidimensional_raster)

# Add a new dimension, depth, for the water temperature variable
# Depth will be measured in 5 meter increments
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit)

ManageMultidimensionalRaster の例 3 (スタンドアロン スクリプト)

この例では、単一スライスの多次元ラスターからディメンションを削除します。

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/precip.crf"
manage_mode = "REMOVE_DIMENSION"

# Remove dimension to make input data dimensionless
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster,
	manage_mode)

環境

並列処理ファクター