ラベル | 説明 | データ タイプ |
入力多次元ラスター | 入力多次元ラスター データセット。 サポートされている入力は、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 |
範囲 (オプション) | レイヤーの範囲 (境界四角形)。 該当するレイヤーに適した [範囲] オプションを選択します。
| Extent |
ディメンションなし (オプション) | レイヤーにディメンション値が含まれるかどうかを指定します。 このパラメーターは、レイヤーの作成に 1 つのスライスが選択されている場合にのみアクティブになります。
| Boolean |
空間参照 (オプション) | [出力多次元ラスター レイヤー] パラメーター値の座標系。 このパラメーターは、[入力多次元ラスター] パラメーター値が Zarr 形式の場合のみ適用されます。 データに空間参照がない場合はこのパラメーターを使用して空間参照を定義します。 | Coordinate System |
サマリー
定義された変数とディメンションに沿ってデータをスライスすることで、多次元ラスター データセットまたは多次元ラスター レイヤーからラスター レイヤーを作成します。
使用法
このツールは、変数のサブセットを抽出することで、多次元ラスターまたはモザイク データセットから多次元ラスター レイヤーを作成します。 たとえば、30 年間の月間降水量データを含むモザイク データセットが存在する場合に、毎年 1 月のデータのみを抽出して、1 月の降水量がどのように変化したかを確認できます。
サポートされている多次元ラスター データセットとして、クラウド ラスター形式 (CRF)、多次元モザイク データセット、または netCDF、GRIB、HDF ファイルで生成された多次元ラスター レイヤーがあります。
このツールは一時レイヤーを生成します。ディスクに保存しなければ、このレイヤーは保持されません。
[ディメンション定義] パラメーターでは、間隔、値、または値の範囲を使用してディメンションをスライスできます。 たとえば、毎月 2 メートル間隔で深度 500 メートルまで収集されている 10 年間の海洋塩分データがある場合、次のシナリオごとに異なるディメンション定義オプションを使用できます。
- 10 年間のそれぞれ 1 月の塩分データを抽出します。 [値を使用] を選択して、[ディメンション] を [StdTime] に設定し、[値] を [1 月] に設定します。
- 塩分データを 0 ~ 150 メートルの深度範囲でスライスします。 [範囲を使用] を選択して、[ディメンション] を [StdZ] に設定し、[最小値] を -150 に設定し、[最大値] を 0 に設定します。
- 10 年間の 1 月ごとの最初の 10 日間の塩分データを抽出します。 [繰り返しを使用] を選択して、[ディメンション] を [StdTime] に設定し、[最初の繰り返しを開始] および [最初の繰り返しを終了] を該当する繰り返し期間の開始時点と終了時点に設定し、[ステップ] を 1 に設定し、[単位] を [年] に設定します。
多次元ラスターの 1 つのスライスのデータを含む非多次元レイヤーを作成するには、[ディメンション定義] パラメーターで [値を使用] を選択し、ディメンション値を 1 つ選択して [ディメンションなし] パラメーターをオンにします。
パラメーター
arcpy.md.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 (オプション) | ディメンションのスライスに使用する方法を指定します。
| 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] に設定されている場合に必須です。
| String |
template (オプション) | レイヤーの範囲 (境界四角形)。 該当するレイヤーに適した [範囲] オプションを選択します。
| Extent |
dimensionless (オプション) | レイヤーにディメンション値が含まれるかどうかを指定します。 このパラメーターは、レイヤーの作成に 1 つのスライスが選択されている場合にのみ有効になります。
| Boolean |
spatial_reference (オプション) | out_multidimensional_raster_layer パラメーター値の座標系。 このパラメーターは、in_multidimensional_raster パラメーター値が Zarr 形式の場合のみ適用されます。 データに空間参照がない場合はこのパラメーターを使用して空間参照を定義します。 | Coordinate System |
コードのサンプル
BY_RANGES 方法を使用して多次元ラスターから変数のサブセットを抽出します。
# Import system modules
import arcpy
# Execute
arcpy.md.MakeMultidimensionalRasterLayer(
"C:\data\Ocean_Data.crf", "C:\data\Salinity_MultidimLayer.crf",
"salinity", "BY_RANGES", "StdZ -500 -100",
"120.084279939743 0.914964278021376 139.524470909773 21.1231086159414")
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)
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)
環境
特殊なケース
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes