定数ラスターの作成 (Spatial Analyst ツール)

サマリー

解析ウィンドウの範囲とセルサイズ内で、定数値のラスターを作成します。

図

定数ラスターの作成の図 — OutRas = CreateConstantRaster(2)

使用法

定数ラスターの作成 ツールは、指定した値を出力ラスターのすべてのセルに割り当てます。
定数値は数値である必要があります。科学表記法を使用できます (0.0003048 に対して 3.048e-4 など)。
出力セルサイズ パラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、セルサイズ環境が指定されていれば、そこから取得されます。パラメーターセルサイズまたは環境セルサイズが指定されていないが、スナップラスター 環境が設定されている場合は、スナップラスターのセルサイズが使用されます。何も指定しない場合、セルサイズは 1 になります。
数値を使用してセルサイズを指定した場合、出力ラスターではそれが直接使用されます。

ラスターデータセットを使用してセルサイズを指定した場合、パラメーターにはセルサイズの値ではなく、ラスターデータセットのパスが表示されます。データセットの空間参照が出力空間参照と同じであれば、そのラスターデータセットのセルサイズが解析で直接使用されます。データセットの空間参照が出力空間参照と異なる場合、指定した セルサイズ投影法 の値に基づいて投影されます。
ツールには入力がないため、出力空間参照は特定の順序で他の設定から取得されます。最初に、出力座標系 環境が指定されている場合は使用され、次にマップビューの座標系が使用されます。どちらの条件も満たされない場合、出力空間参照は [不明] に設定されます。
セルサイズに基づいてデフォルトの出力範囲が計算され、250 行および 250 列のラスターが作成されます。このため、デフォルトのセルサイズが 1 の場合、出力範囲 は (0, 0, 250, 250) になります。 セルサイズ、スナップラスター、および 出力座標系 環境が指定されている場合、範囲の値はそれらに基づいて調整されます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
定数値	出力ラスターのすべてのセルを表示するために使用する定数値。	Double
出力データタイプ (オプション)	出力ラスターデータセットのデータタイプ指定されたデータタイプが浮動小数点である場合、出力ラスターのセルの値は、出力形式にかかわらず、小数点以下 7 桁の定数値精度になります。 Integer—整数ラスターが作成されます。 Float—浮動小数点ラスターが作成されます。	String
出力セルサイズ (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、環境セルサイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。詳細については、使用法セクションをご参照ください。	Analysis Cell Size
出力範囲 (オプション)	出力ラスターデータセットの範囲。環境設定で特定の値が指定されている場合、その値を使用します。設定されていない場合、デフォルトは 0, 0, 250, 250 です。	Envelope; Extent

戻り値

ラベル	説明	データタイプ
出力ラスター	各セルが指定された定数値を持つ出力ラスター。	Raster

CreateConstantRaster(constant_value, {data_type}, {cell_size}, {extent})

名前	説明	データタイプ
constant_value	出力ラスターのすべてのセルを表示するために使用する定数値。	Double
data_type (オプション)	出力ラスターデータセットのデータタイプ指定されたデータタイプが浮動小数点である場合、出力ラスターのセルの値は、出力形式にかかわらず、小数点以下 7 桁の定数値精度になります。 `INTEGER`—整数ラスターが作成されます。 `FLOAT`—浮動小数点ラスターが作成されます。	String
cell_size (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、環境セルサイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。詳細については、使用法セクションをご参照ください。	Analysis Cell Size
extent (オプション)	出力ラスターデータセットの範囲。 `Extent` は Python クラスです。このツールでは `Extent(XMin, YMin, XMax, YMax)` の形式をとります。 `XMin` および `YMin` は、範囲の左下の座標を定義します。`XMax` および `YMax` は、右上の座標を定義します。座標は、出力座標系環境設定と同じマップ単位で指定します。環境設定で特定の値が指定されている場合、その値を使用します。設定されていない場合、デフォルトは 0, 0, 250, 250 です。	Envelope; Extent

戻り値

名前	説明	データタイプ
out_raster	各セルが指定された定数値を持つ出力ラスター。	Raster

コードのサンプル

CreateConstantRaster 例 1 (Python ウィンドウ)

次のサンプルでは、定義済みのセルサイズおよび範囲で特定の値の浮動小数点ラスターを作成しています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outConstRaster = CreateConstantRaster(12.7, "FLOAT", 2, Extent(0, 0, 250, 250))
outConstRaster.save("C:/sapyexamples/output/outconst2")

CreateConstantRaster 例 2 (スタンドアロンスクリプト)

次のサンプルでは、定義済みのセルサイズおよび範囲で特定の値の整数ラスターを作成しています。

# Name: CreateConstantRaster_Ex_02.py
# Description: Creates a raster from a constant value
# Requirements: Spatial Analyst extension

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

# Set local variables
constantValue = 12
cellSize = 2
outExtent = Extent(0, 0, 250, 250)

# Run CreateConstantRaster
outConstRaster = CreateConstantRaster(constantValue, "FLOAT", cellSize,
                                      outExtent)

# Save the output
outConstRaster.save("C:/sapyexamples/output/outconst")

環境

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

ライセンス情報

Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要

定数ラスターの作成 (Spatial Analyst ツール)

サマリー

図

使用法

パラメーター

戻り値

環境

ライセンス情報

関連トピック