多次元ラスター レイヤーの作成 (Make Multidimension Raster Layer) (マルチディメンション)

サマリー

定義された変数とディメンションに沿ってデータをスライスすることで、多次元ラスター データセットまたは多次元ラスター レイヤーからラスター レイヤーを作成します。

使用法

  • このツールは、変数のサブセットを抽出することで、多次元ラスターまたはモザイク データセットから多次元ラスター レイヤーを作成します。 たとえば、30 年間の月間降水量データを含むモザイク データセットが存在する場合に、毎年 1 月のデータのみを抽出して、1 月の降水量がどのように変化したかを確認できます。

  • サポートされている多次元ラスター データセットには、CRF (Cloud Raster Format)、多次元モザイク データセット、netCDF、GRIB、または HDF 形式ファイルで生成された多次元ラスター レイヤーがあります。

  • このツールは一時レイヤーを生成します。ディスクに保存しなければ、このレイヤーは保持されません。

  • [ディメンション定義] パラメーターでは、間隔、値、または値の範囲を使用してディメンションをスライスできます。 たとえば、毎月 2 メートル間隔で深度 500 メートルまで収集されている 10 年間の海洋塩分データがある場合、次のシナリオごとに異なるディメンション定義オプションを使用できます。

    • 10 年間のそれぞれ 1 月の塩分データを抽出します。 [値を使用] を選択して、[ディメンション][StdTime] に設定し、[値][1 月] に設定します。
    • 塩分データを 0 ~ 150 メートルの深度範囲でスライスします。 [範囲を使用] を選択して、[ディメンション][StdZ] に設定し、[最小値][-150] に設定し、[最大値][0] に設定します。
    • 10 年間の 1 月の最初の 10 日間の塩分データを抽出します。 [繰り返しを使用] を選択して、[ディメンション][StdTime] に設定し、[最初の繰り返しの開始] および [最初の繰り返しの終了] を該当する繰り返し期間の開始時点と終了時点に設定し、[ステップ][1] に設定し、[単位][年] に設定します。

  • 多次元ラスターの 1 つのスライスのデータを含む非多次元レイヤーを作成するには、[ディメンション定義] パラメーターで [値を使用] を選択し、ディメンション値を 1 つ選択して [ディメンションなし] パラメーターをオンにします。

パラメーター

ラベル説明データ タイプ
入力多次元ラスター

入力多次元ラスター データセット。

サポートされている入力は、netCDF、GRIB、HDF、CRF、Zarr ファイル、多次元モザイク データセット、多次元イメージ サービス、OPeNDAP URL、多次元ラスター レイヤーです。

注意:

Zarr ファイルには *.zarr 拡張子を付け、フォルダーには *.zgroup ファイルが必要です。

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
出力多次元ラスター レイヤー

出力多次元ラスター レイヤー。

Raster Layer
変数
(オプション)

出力多次元ラスター レイヤーに含められる変数。 変数を指定しない場合、最初の変数が使用されます。

String
ディメンション定義
(オプション)

ディメンションのスライスに使用する方法を指定します。

  • すべて各ディメンションの全範囲が使用されます。 これがデフォルトです。
  • 範囲を使用範囲または範囲のリストを使用してディメンションをスライスします。
  • 繰り返しを使用指定した間隔サイズでディメンションをスライスします。
  • 値を使用ディメンション値のリストを使用してディメンションをスライスします。
String
範囲
(オプション)

指定したディメンションの範囲または範囲のリスト。

データは、ディメンション名と範囲の最小値および最大値に基づいてスライスされます。 このパラメーターは、[ディメンション定義] パラメーターが [範囲を使用] に設定されている場合に必須です。

Value Table
(オプション)

指定されたディメンションの値のリスト。 このパラメーターは、[ディメンション定義] パラメーターが [値を使用] に設定されている場合に必須です。

Value Table
ディメンション
(オプション)

変数をスライスする際に使用するディメンション。 このパラメーターは、[ディメンション定義] パラメーターが [繰り返しを使用] に設定されている場合に必須です。

String
最初の繰り返しの開始
(オプション)

最初の間隔の始まり。 この間隔はデータセットの反復処理に使用されます。 このパラメーターは、[ディメンション定義] パラメーターが [繰り返しを使用] に設定されている場合に必須です。

String
最初の繰り返しの終了
(オプション)

最初の間隔の終わり。 この間隔はデータセットの反復処理に使用されます。 このパラメーターは、[ディメンション定義] パラメーターが [繰り返しを使用] に設定されている場合に必須です。

String
ステップ
(オプション)

データをスライスする頻度。 このパラメーターは、[ディメンション定義] パラメーターが [繰り返しを使用] に設定されている場合に必須です。

Double
単位
(オプション)

使用する反復単位を指定します。 このパラメーターは、[ディメンション定義] パラメーターが [反復を使用] に設定されており、[ディメンション] パラメーターが [StdTime] に設定されている場合に必須です。

  • 時間指定された時間単位は、時間です。
  • 指定された時間単位は、日です。
  • 指定された時間単位は、週です。
  • 指定された時間単位は、月です。
  • 指定された時間単位は、年です。
String
範囲
(オプション)

レイヤーの範囲 (境界四角形)。 該当するレイヤーに適した [範囲] オプションを選択します。

  • [現在の表示範囲] マップ ビュー - 範囲は、アクティブなマップまたはシーンに基づきます。 このオプションは、アクティブなマップが存在する場合にのみ使用できます。
  • [範囲の描画] Draw Extent - 範囲は、マップまたはシーンに描画された四角形に基づきます。 このオプションは、プロジェクト ジオデータベースにフィーチャクラスを作成し、レイヤーをマップに追加します。 フィーチャクラスの座標系はマップと同じです。
    注意:

    このオプションは、[環境] ダイアログ ボックスでは使用できません。 範囲データ タイプを使用するツール パラメーターまたはツール ダイアログ ボックスの [環境] タブからのみ使用できます。

    注意:

    編集タブで編集を有効/無効にする編集オプションがオンの場合、範囲を描画するには [編集] リボン タブで編集を有効化する必要があります。

  • [レイヤーの範囲] レイヤー - 範囲は、アクティブなマップ レイヤーに基づきます。 ドロップダウン リストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップ レイヤーを組み合わせた範囲を取得します。 このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。

    各マップ レイヤーには、次のオプションがあります。

    • [すべてのフィーチャ] すべて選択 - レイヤーのすべてのフィーチャの範囲。
    • [選択フィーチャ]Area from Selected Features - レイヤーの選択フィーチャの範囲。
    • [表示フィーチャ] Extent Indicator - レイヤーの表示フィーチャの範囲。
      注意:

      [選択フィーチャ] Area from Selected Features[表示フィーチャ] Extent Indicator オプションの範囲は、フィーチャ レイヤーでのみ使用できます。

  • [参照] 参照 - 範囲は、既存のデータに基づきます。
  • [クリップボード] 貼り付け - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。
    • [範囲をコピー] コピー - 範囲の座標と座標系をクリップボードにコピーします。
    • [範囲を貼り付け] 貼り付け - 範囲の座標と、必要に応じて座標系をクリップボードから貼り付けます。 クリップボードの値に座標系が含まれていない場合、マップの座標系が範囲に使用されます。
    注意:

    範囲の座標は、ArcPy Extent オブジェクトと同じ書式と順序 (x-min、y-min、x-max、y-max、空間参照) を使用して、クリップボードからコピーおよびクリップボードから貼り付けられます。

  • [範囲をリセット] リセット - 範囲はデフォルト値にリセットされます。
  • 手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。
    注意:

    マップで、入力された座標と異なる表示単位が使用されることがあります。 基本方向 (N、S、E、W) を使用することはできません。 南と西の座標にはマイナス値の記号を使用します。

Extent
ディメンションなし
(オプション)

レイヤーにディメンション値が含まれるかどうかを指定します。 このパラメーターは、レイヤーの作成に 1 つのスライスが選択されている場合にのみアクティブになります。

  • オン - レイヤーにディメンション値は含まれません。
  • オフ - レイヤーにディメンション値が含まれます。 これがデフォルトです。

Boolean
空間参照
(オプション)

[出力多次元ラスター レイヤー] パラメーター値の座標系。 このパラメーターは、[入力多次元ラスター] パラメーター値が Zarr 形式の場合のみ適用されます。 データに空間参照がない場合はこのパラメーターを使用して空間参照を定義します。

Coordinate System

arcpy.management.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit}, {template}, {dimensionless}, {spatial_reference})
名前説明データ タイプ
in_multidimensional_raster

入力多次元ラスター データセット。

サポートされている入力は、netCDF、GRIB、HDF、CRF、Zarr ファイル、多次元モザイク データセット、多次元イメージ サービス、OPeNDAP URL、多次元ラスター レイヤーです。

注意:

Zarr ファイルには *.zarr 拡張子を付け、フォルダーには *.zgroup ファイルが必要です。

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
out_multidimensional_raster_layer

出力多次元ラスター レイヤー。

Raster Layer
variables
[variables,...]
(オプション)

出力多次元ラスター レイヤーに含められる変数。 変数を指定しない場合、最初の変数が使用されます。

String
dimension_def
(オプション)

ディメンションのスライスに使用する方法を指定します。

  • ALL各ディメンションの全範囲が使用されます。 これがデフォルトです。
  • BY_RANGES範囲または範囲のリストを使用してディメンションをスライスします。
  • BY_ITERATION指定した間隔サイズでディメンションをスライスします。
  • BY_VALUEディメンション値のリストを使用してディメンションをスライスします。
String
dimension_ranges
[dimension_ranges,...]
(オプション)

指定したディメンションの範囲または範囲のリスト。

データは、ディメンション名と範囲の最小値および最大値に基づいてスライスされます。 このパラメーターは、dimension_def パラメーターが BY_RANGES に設定されている場合に必須です。

Value Table
dimension_values
[dimension_values,...]
(オプション)

指定されたディメンションの値のリスト。 このパラメーターは、dimension_def パラメーターが BY_VALUE に設定されている場合に必須です。

Value Table
dimension
(オプション)

変数をスライスする際に使用するディメンション。 このパラメーターは、dimension_def パラメーターが BY_ITERATION に設定されている場合に必須です。

String
start_of_first_iteration
(オプション)

最初の間隔の始まり。 この間隔はデータセットの反復処理に使用されます。 このパラメーターは、dimension_def パラメーターが BY_ITERATION に設定されている場合に必須です。

String
end_of_first_iteration
(オプション)

最初の間隔の終わり。 この間隔はデータセットの反復処理に使用されます。 このパラメーターは、dimension_def パラメーターが BY_ITERATION に設定されている場合に必須です。

String
iteration_step
(オプション)

データをスライスする頻度。 このパラメーターは、dimension_def パラメーターが BY_ITERATION に設定されている場合に必須です。

Double
iteration_unit
(オプション)

使用する反復単位を指定します。 このパラメーターは、dimension_def パラメーターが BY_ITERATION に設定されており、dimension パラメーターが StdTime に設定されている場合に必須です。

  • HOURS指定された時間単位は、時間です。
  • DAYS指定された時間単位は、日です。
  • WEEKS指定された時間単位は、週です。
  • MONTHS指定された時間単位は、月です。
  • YEARS指定された時間単位は、年です。
String
template
(オプション)

レイヤーの範囲 (境界四角形)。 該当するレイヤーに適した [範囲] オプションを選択します。

  • MAXOF - すべての入力データの最大範囲が使用されます。
  • MINOF - すべての入力データに共通する最小領域が使用されます。
  • DISPLAY - 範囲は、表示範囲と同じになります。
  • レイヤー名 - 指定したレイヤーの範囲が使用されます。
  • Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。
  • 座標のスペース区切りの文字列 - 指定した文字列の範囲が使用されます。 座標は、x-min、y-min、x-max、y-max の順序で表されます。
Extent
dimensionless
(オプション)

レイヤーにディメンション値が含まれるかどうかを指定します。 このパラメーターは、レイヤーの作成に 1 つのスライスが選択されている場合にのみ有効になります。

  • NO_DIMENSIONSレイヤーにディメンション値は含まれません。
  • DIMENSIONSレイヤーにディメンション値が含まれます。 これがデフォルトです。
Boolean
spatial_reference
(オプション)

out_multidimensional_raster_layer パラメーター値の座標系。 このパラメーターは、in_multidimensional_raster パラメーター値が Zarr 形式の場合のみ適用されます。 データに空間参照がない場合はこのパラメーターを使用して空間参照を定義します。

Coordinate System

コードのサンプル

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

BY_RANGES 方法を使用して多次元ラスターから変数のサブセットを抽出します。

# Import system modules
import arcpy

# Execute
MakeMultidim = MakeMultidimensionalRasterLayer("C:\data\Ocean_Data.crf", "salinity", "BY_RANGES", "StdZ -500 -100", "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414")


# Save Output
MakeMultidim.save("C:\data\Salinity_MultidimLayer.crf")
MakeMultidimensionRasterLayer の例 2 (スタンドアロン スクリプト)

BY_VALUE 方法を使用し、特定の深さ値の多次元ラスターから水温変数を抽出します。

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"

#Execute

arcpy.md.MakeMultidimensionalRasterLayer(
	in_multidimensional_raster, out_multidimensional_raster_layer, variables, 
	dimension_def, dimension_values, template)
MakeMultidimensionRasterLayer の例 3 (スタンドアロン スクリプト)

BY_ITERATION 方法を使用して多次元ラスターから塩分濃度変数を抽出します。

# Import system modules
import arcpy
 
# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer =  r"C:\data\salinity_slice.crf"
variables = "salinity"
dimension_def = "BY_ITERATION"
dimension = "StdTime"
start_of_first_iteration = "2009-01-01"
end_of_first_iteration = "2009-01-10"
iteration_step = "1"
iteration_unit = "YEARS"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"
 
#Execute
 
arcpy.md.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit, template)