多次元ラスターのサブセット (Subset Multidimensional Raster) (マルチディメンション)

サマリー

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

使用法

  • このツールは、多次元ラスターまたはモザイク データセットから、変数のサブセットを抽出することで、多次元ラスター レイヤーを作成します。たとえば、30 年間の毎月の降水量データを含むモザイク データセットがある場合、各年の 1 月のデータだけを抽出して、その月の降水量の変化を調べることができます。

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

  • このツールは、多次元ラスター データセットをクラウド ラスター形式 (CRF) で生成します。 現在、これ以外の出力形式はサポートされていません。

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

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

  • デフォルトでは、多次元ラスター出力は LZ77 圧縮タイプで圧縮されます。 ただし、圧縮タイプを LERC に変更し、データに応じて最大誤差を調整することをお勧めします。 たとえば、小数点以下 3 桁まで正確な解析結果を生成したい場合は、最大誤差として 0.001 を使用します。 不要な正確度要件が存在すると、処理時間が長くなり、ストレージ サイズが大きくなるため、不要な正確度要件を排除しておくことをお勧めします。

    圧縮タイプを変更するには、環境設定を修正します。

パラメーター

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

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

サポートされている入力には、netCDF、GRIB、HDF または CRF ファイル、多次元モザイク データセット、多次元ラスター レイヤーなどがあります。

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

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

Raster Dataset
変数
(オプション)

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

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

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

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

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

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

Value Table
(オプション)

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

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

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

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

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

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

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

String
移動間隔
(オプション)

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

Double
単位
(オプション)

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

  • 時間[時間] は指定された時間単位です。
  • [日] は指定された時間単位です。
  • [週] は指定された時間単位です。
  • [月] は指定された時間単位です。
  • [年] は指定された時間単位です。
String

arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit})
名前説明データ タイプ
in_multidimensional_raster

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

サポートされている入力には、netCDF、GRIB、HDF または CRF ファイル、多次元モザイク データセット、多次元ラスター レイヤーなどがあります。

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

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

Raster Dataset
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

コードのサンプル

SubsetMultidimensionalRaster (多次元ラスターのサブセット) の例 1 (Python ウィンドウ)

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

# Import system modules
import arcpy

# Execute
arcpy.md.SubsetMultidimensionalRaster(
	"C:\data\Ocean_Data.crf", "C:\data\Ocean_Data_Subset.crf", 
	"salinity", "BY_RANGES", "StdZ -500 -100")
SubsetMultidimensionalRaster (多次元ラスターのサブセット) の例 2 (スタンドアロン スクリプト)

BY_VALUE 方法を使用して多次元ラスターから水温変数を抽出します。

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"

#Execute

arcpy.md.SubsetMultidimensionalRaster(
	in_multidimensional_raster, out_multidimensional_raster, 
	variables, dimension_def, dimension_values)
SubsetMultidimensionalRaster (多次元ラスターのサブセット) の例 3 (スタンドアロン スクリプト)

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

# Import system modules
import arcpy
 
# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster =  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"
 
#Execute
 
arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック