概要
変数またはディメンションを追加または削除し、多次元ラスターを編集します。
使用法
このツールを使用すると、多次元ラスターを編集できます。このツールは、新しいデータセットは生成しません。多次元ラスターを変更します。データセットを作成するには、[多次元ラスターのサブセット (Subset Multidimensional Raster)] ツールまたは [ラスターのコピー (Copy Raster)] ツールを使用します。その後、このツールでさらに編集します。
ターゲットおよび入力ラスターは、CRF (Cloud Raster Format) 形式である必要があります。現在、その他の形式はこのツールでサポートされていません。多次元モザイク データセットまたは多次元ラスター レイヤーを *.crf ファイルに変換するには、[ラスターのコピー (Copy Raster)] ツールを使用して、出力形式として CRF を選択し、データセットを多次元として処理するように選択します。
[管理モード] パラメーターは、実行する編集操作のタイプを設定します。次の 6 つのオプションがあります。
- [ディメンションの追加] - データセットにディメンションを追加します。ディメンションの名前、説明、単位を指定する必要があります。ディメンションを追加したら、ディメンションが同じ別の多次元データセットからスライスを追加できます。
ターゲット ラスターが標準の *.crf ラスターである場合、ディメンションを追加すると、ターゲットが多次元ラスターになり、ラスター プロパティに [多次元情報] が追加されます。
- [ディメンションの削除] - データセットからディメンションを削除します。ディメンションが 1 つしかない場合、データセットで使用できるスライスは 1 つのみになります。
- [スライスの追加] - 1 つまたは複数の多次元ラスターから、ターゲット多次元ラスターのスライスのスタック末尾にスライスを追加します。多次元ラスターの変数とディメンション名は完全に一致する必要があります。ラスター間で重複するディメンション値は追加できません。追加されるスライスのディメンション値は、ターゲット多次元ラスターのディメンション値の後に続く必要があります。
- [スライスの置換] - ターゲット多次元ラスターからスライスを削除し、別の多次元ラスターのスライスに置き換えます。多次元ラスターの変数とディメンション名は完全に一致する必要があります。重複するスライスのみが置換されます。
- [変数の追加] - 1 つまたは複数の入力多次元ラスターのすべての変数を、ターゲット多次元ラスターの変数のリスト末尾に追加します。変数名がターゲット多次元ラスターにすでに存在する場合、その変数は追加されません。複数の入力多次元ラスターに同じ名前の変数が含まれている場合、最初にリストされている入力ラスターの変数がターゲット多次元ラスターに追加されます。
- [変数の削除] - ターゲット多次元ラスターから 1 つまたは複数の変数と、対応するスライスを削除します。多次元ラスターには、少なくとも 1 つの変数を残しておく必要があります。
- [ディメンションの追加] - データセットにディメンションを追加します。ディメンションの名前、説明、単位を指定する必要があります。ディメンションを追加したら、ディメンションが同じ別の多次元データセットからスライスを追加できます。
[スライスの追加]、[スライスの置換]、または [変数の追加] を使用するには、入力データが完全に同じ空間参照、空間範囲、セル サイズである必要があります。
構文
ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit})| パラメーター | 説明 | データ タイプ |
target_multidimensional_raster | 変更する多次元ラスター。 | Raster Dataset; Raster Layer |
manage_mode (オプション) | ターゲット ラスターに実行する変更のタイプを指定します。
| String |
variables [variables,...] (オプション) | ターゲット多次元ラスターで変更される変数。このパラメーターは、実行される操作が既存の変数の変更である場合に必要です。 変数が指定されない場合、ターゲット多次元ラスターの最初の変数が変更されます。 | String |
in_multidimensional_rasters [in_multidimensional_rasters,...] (オプション) | ターゲット多次元ラスターに追加されるスライスまたは変数を含む多次元ラスター データセット。このパラメーターは、manage_mode が APPEND_SLICES、REPLACE_SLICES、または APPEND_VARIABLES に設定されている場合に必要です。 | Raster Layer |
dimension_name (オプション) | ラスター プロパティに追加される新しいディメンションの名前。このパラメーターは、manage_mode が ADD_DIMENSION に設定されている場合に必要です。 | 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 |
派生した出力
| 名前 | 説明 | データ タイプ |
| updated_target_multidimensional_raster | 変更される多次元ラスター。 | ラスター レイヤー |
コードのサンプル
この例では、多次元ラスターの末尾にスライスを追加します。
# Import system modules
import arcpy
# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
target = "C:/data/temp1980_1990.crf", manage_mode = "APPEND_SLICES",
variables = "Temp", in_multidimensional_rasters =
["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"])この例では、スライスを置換し、変数を追加して、ターゲット多次元ラスターにディメンションを追加します。
# 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.ManageMutidimensionalRaster(target_multidimensional_raster,manage_mode_replace,
variables, replace_multidimensional_rasters)
# Append salinity variable
arcpy.md.ManageMutidimensionalRaster(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.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
variables, None, dimension_name, dimension_value, dimension_description, dimension_unit)この例では、単一スライスの多次元ラスターからディメンションを削除します。
# 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.ManageMutidimensionalRaster_md(target_multidimensional_raster,
manage_mode)環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい