スライス (Spatial Analyst ツール)

サマリー

入力セルの値の範囲を、ゾーン (クラス) に切り直すか再分類します。使用可能なデータ分類方法には、等間隔、等面積 (等量)、自然分類、指定間隔、標準偏差 (平均値中心化)、標準偏差 (区切りとしての平均値)、指定間隔、および等比間隔があります。

使用法

スライス手法 パラメーターでは、次のオプションを利用できます。これらによって異なる特性を持つ出力ゾーンが生成されます。
- 等面積 - それぞれのゾーンにほぼ同じ数のセルが含まれるように、定義した数のゾーンが出力ラスターに生成されます。
- 等間隔 - それぞれのゾーンに等しい値の範囲が含まれるように、定義した数のゾーンが出力ラスターに生成されます。
- 自然分類 および 等比間隔 - それぞれのゾーンにクラスの閾値で決定した数のセルが含まれるように、指定した数のゾーンが出力ラスターに生成されます。
- 標準偏差 (平均値中心化)、標準偏差 (区切りとしての平均値)、指定間隔 - それぞれのゾーンにクラスの閾値で決定した数のセルが含まれるように、間隔サイズ で決定した数のゾーンが出力ラスターに生成されます。
指定したスライス手法に応じて、出力ゾーン数 パラメーター値または 間隔サイズ パラメーター値のいずれかを指定する必要があります。
- スライス手法が 等面積、等間隔、自然分類、または 等比間隔 の場合は、出力ゾーン数 パラメーターが必要です。
- スライス手法が 指定間隔、標準偏差 (平均値中心化)、または 標準偏差 (区切りとしての平均値) の場合は、間隔サイズ パラメーターが必要です。
出力で NoData を値に変更 パラメーターを使用して、NoData の値を出力の整数値に置き換えることができます。 NoData のセルが出力ゾーンと結合しないようにする必要がある場合は、想定される出力ゾーンの範囲外にある整数値を指定します。たとえば、出力ゾーンの範囲が 1 ～ 5 の場合、1 未満の値または 5 より大きい値を指定します。候補となる値には、0、100、-99 などが含まれます。 NoData 値を既存のゾーンにマージするには、そのゾーンの整数値を使用します。このパラメーターが設定されていない場合、入力の NoData セルは出力ラスターで NoData のままになります。
入力ラスターに長方形のセルがある場合、出力ラスターセルが正方形になるよう処理されます。その辺の長さは、長方形の長さと幅の平均値に等しくなります。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
入力ラスター	再分類対象の入力ラスター。	Raster Layer
出力ゾーン数 (オプション)	入力ラスターを再分類するゾーンの数。スライス手法パラメーター値が等面積、等間隔、自然分類、または等比間隔の場合、このパラメーターが必要です。スライス手法パラメーター値が指定間隔、標準偏差 (平均値中心化)、または標準偏差 (区切りとしての平均値) の場合、出力ゾーン数パラメーターは無効になります。出力ゾーン数は間隔サイズパラメーター値によって決定されます。	Long
スライス手法 (オプション)	入力ラスターをゾーンに再分類する方法を指定します。等間隔—入力値の範囲が指定された出力ゾーン数に均等に分割され、クラス閾値が決まります。これがデフォルトです。等面積分類—入力セル数が指定された出力ゾーン数に均等に分割され、クラス閾値が決まります。各ゾーンにはほぼ同数のセルが含まれ、ほぼ同じ面積であることを示します。自然分類—クラス閾値は、クラス内の分散を最小化し、クラス間の分散を最大化する方法で決定されます。通常は、データ値が比較的大きく変化する部分に閾値が設定されます。標準偏差 (平均値中心化)—クラス閾値は、入力ラスターの最小値と最大値に到達するまで、平均値の上下に、標準偏差の単位で指定された間隔サイズ (2、1、または 0.5 など) で配置されます。平均値は閾値として使用されず、2 つのクラス閾値によって中央配置されます。 1 つの閾値は平均値の上の指定された間隔サイズの半分の位置にあり、もう 1 つの閾値は平均値の下に指定された間隔サイズの半分の位置にあります。標準偏差は n-1 分母を使用して計算され、この n は値のピクセル数を示します。標準偏差 (区切りとしての平均値)—平均値がクラス閾値として使用されます。その他のクラス閾値は、入力ラスターの最小値と最大値に到達するまで、平均値の上下に、標準偏差の単位で指定された間隔サイズ (2、1、または 0.5 など) で配置されます。標準偏差は n-1 分母を使用して計算され、この n は値のピクセル数を示します。指定間隔分類—クラス閾値は 0 (ゼロ) と、0 を基準に指定された間隔サイズの倍数に設定されます。これらは、最初と最後のクラスの入力データの最小値と最大値にクリップされます。 0 を含む値範囲では、0 は常にブレークポイントとして含まれます。幾何補正間隔—クラス閾値は、等比級数を持つクラス間隔に基づいて作成されます。これは、現在の値が、前の値をジオメトリック係数の除算したものと等しくなるというパターンになります。この分類法におけるジオメトリック係数を (逆数に) 変更して、クラスの範囲を最適化することができます。このアルゴリズムは、各クラスの要素数の二乗和を最小化することで、これらの幾何学的間隔を作成します。これにより、各クラスにはほぼ同じ数の値が含まれ、間隔ごとの差が一定に保たれます。	String
出力の開始値 (オプション)	出力ラスターデータセットのゾーン (クラス) に使用される開始値です。クラスには整数値が割り当てられ、開始値から 1 ずつ増加します。デフォルトの開始値は 1 です。	Long
出力で NoData を値に変更 (オプション)	出力で NoData を値に置き換えます。このパラメーターが設定されていない場合、NoData セルは出力ラスターで NoData のままになります。	Long
間隔サイズ (オプション)	クラス間の間隔のサイズです。スライス手法パラメーターが指定間隔、標準偏差 (平均値中心化)、または標準偏差 (区切りとしての平均値) に設定されている場合、このパラメーターが必要です。指定間隔を使用する場合、間隔サイズは、クラス閾値の計算に使用するクラスの実際の値範囲を示します。標準偏差 (平均値中心化) または標準偏差 (区切りとしての平均値) を使用する場合、間隔サイズは、クラス閾値の計算に使用する標準偏差の数値を示します。	Double

戻り値

ラベル説明データタイプ

ラベル	説明	データタイプ
出力ラスター	出力再分類ラスター。出力は常に整数タイプになります。出力ラスターの属性テーブルには、標準の `ObjectID`、`Value`、`Count` フィールドに加えて、新しく 2 つのフィールドが含まれます。 `Value` フィールドはクラス値を示します。 `ZoneMin` および `ZoneMax` フィールドにはそれぞれ最小値と最大値が記録され、クラスの生成に使用されます。	Raster

出力ラスター

出力再分類ラスター。

出力は常に整数タイプになります。

出力ラスターの属性テーブルには、標準の ObjectID、Value、Count フィールドに加えて、新しく 2 つのフィールドが含まれます。 Value フィールドはクラス値を示します。 ZoneMin および ZoneMax フィールドにはそれぞれ最小値と最大値が記録され、クラスの生成に使用されます。

Raster

Slice(in_raster, {number_zones}, {slice_type}, {base_output_zone}, {nodata_to_value}, {class_interval_size})

名前	説明	データタイプ
in_raster	再分類対象の入力ラスター。	Raster Layer
number_zones (オプション)	入力ラスターを再分類するゾーンの数。このパラメーターは、`slice_type` パラメーター値が `EQUAL_AREA`、`EQUAL_INTERVAL`、`NATURAL_BREAKS`、または `GEOMETRIC_INTERVAL` の場合に必須です。 `slice_type` パラメーター値が `STANDARD_DEVIATION_MEAN_CENTERED`、`STANDARD_DEVIATION_MEAN_BREAK`、または `DEFINED_INTERVAL` の場合、`number_zones` パラメーターはサポートされません。出力ゾーン数は `class_interval_size` パラメーター値によって決定されます。	Long
slice_type (オプション)	入力ラスターをゾーンに再分類する方法を指定します。 `EQUAL_INTERVAL`—入力値の範囲が指定された出力ゾーン数に均等に分割され、クラス閾値が決まります。これがデフォルトです。 `EQUAL_AREA`—入力セル数が指定された出力ゾーン数に均等に分割され、クラス閾値が決まります。各ゾーンにはほぼ同数のセルが含まれ、ほぼ同じ面積であることを示します。 `NATURAL_BREAKS`—クラス閾値は、クラス内の分散を最小化し、クラス間の分散を最大化する方法で決定されます。通常は、データ値が比較的大きく変化する部分に閾値が設定されます。 `STANDARD_DEVIATION_MEAN_CENTERED`—クラス閾値は、入力ラスターの最小値と最大値に到達するまで、平均値の上下に、標準偏差の単位で指定された間隔サイズ (2、1、または 0.5 など) で配置されます。平均値は閾値として使用されず、2 つのクラス閾値によって中央配置されます。 1 つの閾値は平均値の上の指定された間隔サイズの半分の位置にあり、もう 1 つの閾値は平均値の下に指定された間隔サイズの半分の位置にあります。標準偏差は n-1 分母を使用して計算され、この n は値のピクセル数を示します。 `STANDARD_DEVIATION_MEAN_BREAK`—平均値がクラス閾値として使用されます。その他のクラス閾値は、入力ラスターの最小値と最大値に到達するまで、平均値の上下に、標準偏差の単位で指定された間隔サイズ (2、1、または 0.5 など) で配置されます。標準偏差は n-1 分母を使用して計算され、この n は値のピクセル数を示します。 `DEFINED_INTERVAL`—クラス閾値は 0 (ゼロ) と、0 を基準に指定された間隔サイズの倍数に設定されます。これらは、最初と最後のクラスの入力データの最小値と最大値にクリップされます。 0 を含む値範囲では、0 は常にブレークポイントとして含まれます。 `GEOMETRIC_INTERVAL`—クラス閾値は、等比級数を持つクラス間隔に基づいて作成されます。これは、現在の値が、前の値をジオメトリック係数の除算したものと等しくなるというパターンになります。この分類法におけるジオメトリック係数を (逆数に) 変更して、クラスの範囲を最適化することができます。このアルゴリズムは、各クラスの要素数の二乗和を最小化することで、これらの幾何学的間隔を作成します。これにより、各クラスにはほぼ同じ数の値が含まれ、間隔ごとの差が一定に保たれます。	String
base_output_zone (オプション)	出力ラスターデータセットのゾーン (クラス) に使用される開始値です。クラスには整数値が割り当てられ、開始値から 1 ずつ増加します。デフォルトの開始値は 1 です。	Long
nodata_to_value (オプション)	出力で NoData を値に置き換えます。このパラメーターが設定されていない場合、NoData セルは出力ラスターで NoData のままになります。	Long
class_interval_size (オプション)	クラス間の間隔のサイズです。このパラメーターは、`slice_type` パラメーターが `DEFINED_INTERVAL`、`STANDARD_DEVIATION_MEAN_CENTERED`、または `STANDARD_DEVIATION_MEAN_BREAK` に設定されている場合に必須です。 `DEFINED_INTERVAL` を使用する場合、間隔サイズは、クラス閾値の計算に使用するクラスの実際の値範囲を示します。 `STANDARD_DEVIATION_MEAN_CENTERED` または `STANDARD_DEVIATION_MEAN_BREAK` を使用する場合、間隔サイズは、クラス閾値の計算に使用する標準偏差の数値を示します。	Double

戻り値

名前説明データタイプ

名前	説明	データタイプ
out_raster	出力再分類ラスター。出力は常に整数タイプになります。出力ラスターの属性テーブルには、標準の `ObjectID`、`Value`、`Count` フィールドに加えて、新しく 2 つのフィールドが含まれます。 `Value` フィールドはクラス値を示します。 `ZoneMin` および `ZoneMax` フィールドにはそれぞれ最小値と最大値が記録され、クラスの生成に使用されます。	Raster

out_raster

出力再分類ラスター。

出力は常に整数タイプになります。

Raster

コードのサンプル

Slice 例 1 (Python ウィンドウ)

入力ラスターを、データに内在する自然なグループに基づいて 5 つのクラスに再分類します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", 5, "NATURAL_BREAKS")
outslice.save("C:/sapyexamples/output/elev_slice.tif")

Slice 例 2 (Python ウィンドウ)

入力ラスターを、指定間隔を 10 にして再分類します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", "", "DEFINED_INTERVAL", "", "", 10)
outslice.save("C:/sapyexamples/output/elev_slice_02.tif")

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

入力ラスターを、データに内在する自然なグループに基づいて 10 のクラスに再分類し、出力クラスの開始値を -5 に指定します。

# Name: Slice_Ex_03.py
# Description: Slices the input raster into 10 zones(classes) based on natural groupings inherent in the data.
#              Specify the starting value for output classes to be -5.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = -5

# Run Slice
outSlice = Slice(inRaster, numberZones, "NATURAL_BREAKS", baseOutputZone)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_03.tif")

Slice 例 4 (スタンドアロンスクリプト)

入力ラスターを、10 の等面積のクラスに再分類します。出力に -99 の値を含むように NoData セルを割り当てます。

# Name: Slice_Ex_04.py
# Description: Slices the input raster into 10 zones(classes) based on equal area.
#              Assign NoData cells to have a value of -99 in the output.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = 5
nodataToValue = -99
classIntervalSize = "" # or None

# Run Slice
outSlice = Slice(inRaster, numberZones, "EQUAL_AREA", baseOutputZone, nodataToValue, classIntervalSize)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_04.tif")

環境

自動コミット, セルサイズ, セルサイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, 並列処理ファクター, スクラッチワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

Basic: Spatial Analyst または 3D Analyst が必要
Standard: Spatial Analyst または 3D Analyst が必要
Advanced: Spatial Analyst または 3D Analyst が必要

スライス (Spatial Analyst ツール)

サマリー

使用法

パラメーター

戻り値

環境

ライセンス情報

関連トピック