Advanced のライセンスで利用可能。
概要
定義可能な分布を使用してランダム値のラスター データセットを作成します。
使用法
出力は、Esri Grid、CRF、IMG、TIFF、または任意のジオデータベース ラスター データセットに保存することができます。
出力ラスター内の各セルに割り当てられる値は、乱数ジェネレーターと選択した分布のタイプから求められます。さまざまな乱数ジェネレーターを使用できます。乱数ジェネレーター環境を確認して、使用する乱数ジェネレーターを決定してください。乱数ジェネレーターは、ジェネレーター タイプとシード値に基づいて乱数のストリームを開始します。これらの値は 0 ～ 1 の範囲でランダムに決定されます。各値は、他の値に依存しません。
出力ラスターの値の割り当て (または変換) には、複数の分布タイプを使用できます。一般に、分布はさまざまな結果を生成します。使用する分布は、最終的なラスターの用途によって決定します。ランダム ラスターにより自然現象をモデル化する場合は、その現象のプロセスを最も効果的に表現する分布を選択する必要があります。
各分布とそれらの一般的な使用法については、「ランダム値を割り当てるための分布」をご参照ください。
一様分布、整数分布、正規分布、指数分布の処理時間はその引数に依存しないのに対して、ポアソン分布、ガンマ分布、二項分布、幾何分布、パスカル分布の処理時間は引数の変更によって大幅に変わることがあります。
値が指定されない場合は、セル サイズ パラメーターのデフォルト値が計算されます。この値は範囲のサイズをベースとします。
このツールのダイアログ ボックスで、[出力範囲] パラメーターに表示される値はマップの座標系に存在します。ツールの実行中に、環境設定で指定されている範囲が [出力座標系] に投影されます。
構文
arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})| パラメーター | 説明 | データ タイプ |
out_path | 出力ラスター データセットが格納されるフォルダーまたはジオデータベース。 | Workspace |
out_name | 作成するラスター データセットの名前および形式。 ジオデータベースに出力をラスター データセットとして格納するには、ラスター データセットの名前にファイル拡張子は付けません。 ファイルベースのラスターの場合、次のように適切な拡張子を使用して、作成する形式を指定します。
| String |
distribution (オプション) | 使用するランダム値の分布方法を指定します。 各タイプには、分布を制御する設定が 1 つまたは 2 つあります。
| String |
raster_extent (オプション) | 出力ラスター データセットの範囲。
| Extent |
cellsize (オプション) | 出力ラスター データセットの空間座標精度。 | Double |
build_rat (オプション) | 選択した分布が整数出力ラスターになる出力ラスターのラスター属性テーブルを、ツールが無条件に構築するかどうかを指定します。 このパラメーターは、出力ラスターが浮動小数点の場合には作用しません。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_raster_dataset | 出力ラスター データセット。 | ラスター データセット |
コードのサンプル
次のサンプルでは、定義済みの範囲およびセル サイズで正規分布の値を持つランダム値の出力ラスターを作成しています。
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)次のサンプルでは、定義済みの範囲およびセル サイズでポアソン分布の値を持つランダム値の出力ラスターを作成しています。
# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a random raster dataset based on a
# user-specified distribution and extent.
# Requirements: None
# Import system modules
import arcpy
# Set local variables
outPath = "c:/output"
outFile = "randrast02"
distribution = "POISSON 6.4"
outExtent = "250 250 750 750"
cellSize = 25
# Execute CreateRandomRaster
arcpy.CreateRandomRaster_management(outPath, outFile, distribution,
outExtent, cellSize)ライセンス情報
- Basic: 次のものが必要 3D Analyst または Spatial Analyst
- Standard: 次のものが必要 3D Analyst または Spatial Analyst
- Advanced: はい