Advanced のライセンスで利用可能。
サマリ
定義可能な分布を使用してランダム値のラスター データセットを作成します。
使用法
出力は、Esri Grid、IMG、TIFF、または任意のジオデータベース ラスター データセットに保存することができます。
出力ラスター内の各セルに割り当てられる値は、乱数ジェネレーターと選択した分布のタイプから求められます。利用できる乱数ジェネレーターはいくつかあり、使用する乱数ジェネレーターは [環境設定] の [乱数] で設定します。乱数ジェネレーターは、ジェネレーター タイプとシード値に基づいて乱数のストリームを開始します。これらの数値は、0 ～ 1 の範囲でランダムに決定されます。各値は、他の値に依存しません。
出力ラスターの値の割り当て (または変換) には、複数の分布タイプを使用できます。一般に、分布はさまざまな結果を生成します。選択する分布は、最終的なラスターの用途によって決定します。ランダム ラスターにより一部の自然現象をモデル化する場合は、その現象のプロセスを最も効果的に表現する分布を選択する必要があります。
各分布とそれらの一般的な使用法については、「ランダム値を割り当てるための分布」をご参照ください。
一様分布、整数分布、正規分布、指数分布の処理時間はその引数に依存しないのに対して、ポアソン分布、ガンマ分布、二項分布、幾何分布、パスカル分布の処理時間は引数の変更によって大幅に変わることがあります。
値が指定されない場合は、セル サイズ パラメーターのデフォルト値が計算されます。この値は範囲のサイズをベースとします。
構文
CreateRandomRaster_management (out_path, out_name, {distribution}, {raster_extent}, {cellsize})| パラメータ | 説明 | データ タイプ |
out_path | ラスター データセットを格納するフォルダーまたはジオデータベースを選択します。 | Workspace; Raster Catalog |
out_name | 出力ラスター データセットの名前、および必要であれば拡張子を指定します。 ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 出力をジオデータベースに Esri Grid ラスターまたはラスター データセットとして格納する場合、ラスター データセットの名前にファイル拡張子は付けません。利用可能なファイル ラスター形式でラスター データセットを保存するには、TIFF ラスターの tif または、ERDAS IMAGINE ラスターの .img 拡張子を指定します。 ラスター データセットを TIFF ファイル、またはジオデータベース ラスターに格納するときに、圧縮タイプと圧縮品質を指定できます。 | String |
distribution (オプション) | 使用するランダム値の分布方法を指定します。
| String |
raster_extent (オプション) | 出力ラスター データセット範囲を指定します。 | Extent |
cellsize (オプション) | 出力ラスター データセットの空間座標精度を定義します。 | Double |
コードのサンプル
CreateRandomRaster (ランダム ラスターの作成) の例 (Python ウィンドウ)
次のサンプルでは、定義済みの範囲およびセル サイズで正規分布の値を持つランダム値の出力ラスターを作成しています。
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)
CreateRandomRaster (ランダム ラスターの作成) の例 2 (スタンドアロン スクリプト)
次のサンプルでは、定義済みの範囲およびセル サイズでポアソン分布の値を持つランダム値の出力ラスターを作成しています。
# 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)
環境
ライセンス情報
- ArcGIS for Desktop Basic: 次のものが必要 3D Analyst または Spatial Analyst
- ArcGIS for Desktop Standard: 次のものが必要 3D Analyst または Spatial Analyst
- ArcGIS for Desktop Advanced: ○