ランダムラスターの作成 (データ管理ツール)

サマリー

定義可能な分布を使用してランダム値のラスターデータセットを作成します。

使用法

出力は、Esri Grid、CRF、IMG、TIFF、または任意のジオデータベースラスターデータセットに保存することができます。
出力ラスター内の各セルに割り当てられる値は、乱数ジェネレーターと選択した分布のタイプから求められます。さまざまな乱数ジェネレーターを使用できます。乱数ジェネレーター環境を確認して、使用する乱数ジェネレーターを決定してください。乱数ジェネレーターは、ジェネレータータイプとシード値に基づいて乱数のストリームを開始します。これらの値は 0 ～ 1 の範囲でランダムに決定されます。各値は、他の値に依存しません。

出力ラスターの値の割り当て (または変換) には、複数の分布タイプを使用できます。一般に、分布はさまざまな結果を生成します。使用する分布は、最終的なラスターの用途によって決定します。ランダムラスターにより自然現象をモデル化する場合は、その現象のプロセスを最も効果的に表現する分布を選択する必要があります。

各分布とそれらの一般的な使用法については、ランダム値を割り当てるための分布をご参照ください。
一様分布、整数分布、正規分布、指数分布の処理時間はその引数に依存しません。ポアソン、ガンマ、二項、幾何、パスカルオプションの処理時間は引数の変更によって大幅に変わることがあります。
値が指定されない場合は、セルサイズパラメーターのデフォルト値が計算されます。この値は範囲のサイズをベースとします。
このツールのダイアログボックスで、出力範囲 パラメーターに表示される値はマップの座標系に存在します。ツールの実行中に、環境設定で指定されている範囲が 出力座標系 に投影されます。

ラベル	説明	データタイプ
出力場所	出力ラスターデータセットが格納されるフォルダーまたはジオデータベース。	Workspace
ラスターデータセット名 (拡張子)	作成するラスターデータセットの名前および形式。ジオデータベースに出力をラスターデータセットとして格納するには、ラスターデータセットの名前にファイル拡張子は付けません。ファイルベースのラスターの場合、次のように適切な拡張子を使用して、作成する形式を指定します。 `.tif`—TIFF ラスター `.img`—ERDAS IMAGINE ラスター `.crf`—CRF ラスター No extension—Esri Grid	String
分布 (オプション)	使用するランダム値の分布方法を指定します。各タイプには、分布を制御する設定が 1 つまたは 2 つあります。一様分布 - 最小と最大の値の間で定義された範囲における一様分布。デフォルト値は、最小が 0.0、最大が 1.0 です。これがデフォルトです。整数 - 最小と最大の値の間で定義された範囲における整数分布。デフォルト値は、最小値が 1、最大値が 10 です。正規分布 - 平均と標準偏差の値が定義された正規分布。デフォルト値は、平均値が 0.0、標準偏差が 1.0 です。指数分布 - 平均の値が定義された指数分布。デフォルト値は 1.0 です。ポアソン分布 - 平均の値が定義されたポアソン分布。デフォルト値は 1.0 です。ガンマ分布 - アルファとベータの値が定義されたガンマ分布。デフォルト値は、アルファが 1.0、ベータが 1.0 です。二項分布 - N と確率の値が定義された二項分布。デフォルト値は、N が 10、確率が 0.5 です。幾何分布 - 確率の値が定義された幾何分布。デフォルト値は 0.5 です。負の二項分布 - r と確率の値が定義されたパスカル分布。デフォルト値は、r が 10.0、確率が 0.5 です。デフォルト値を編集するには、テーブル内の値をクリックして、新しい値を入力します。	String
出力範囲 (オプション)	出力ラスターデータセットの範囲。現在の表示範囲 - 範囲は、アクティブなマップまたはシーンに基づきます。範囲の描画 - 範囲は、マップまたはシーンに描画された四角形に基づきます。レイヤーの範囲 - 範囲は、アクティブなマップレイヤーに基づきます。使用可能なレイヤーを選択するか、すべてのレイヤーのデータの範囲オプションを使用します。各マップレイヤーには、次のオプションがあります。すべてのフィーチャ - レイヤーのすべてのフィーチャの範囲。選択フィーチャ - 選択したフィーチャの範囲を使用します。表示フィーチャ - レイヤーの表示フィーチャの範囲。参照 - 範囲は、既存のデータセットに基づきます。クリップボード - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。範囲をコピー - 範囲の座標と座標系をクリップボードにコピーします。範囲を貼り付け - 範囲と座標系をクリップボードから貼り付けます。クリップボードに座標系が含まれていない場合、マップの座標系が範囲に使用されます。範囲をリセット - 範囲はデフォルト値にリセットされます。座標を手動で入力する場合、アクティブなマップの座標系の座標を数値で指定する必要があります。マップで、入力した座標と異なる表示単位が使用されることがあります。南と西の座標にはマイナス値の記号を使用します。	Extent
セルサイズ (オプション)	出力ラスターデータセットの空間座標精度。	Double
ラスター属性テーブルの構築 (オプション)	選択した分布が整数出力ラスターになる出力ラスターのラスター属性テーブルを、ツールが無条件に構築するかどうかを指定します。このパラメーターは、出力ラスターが浮動小数点の場合には作用しません。オン—整数出力ラスターのラスター属性テーブルが無条件に構築されます。これがデフォルトです。オフ—個別値の数が 65535 以上の場合、整数出力ラスターのラスター属性テーブルは構築されません。個別値の数が 65535 未満の場合、ラスター属性テーブルは構築されます。	Boolean

派生した出力

ラベル	説明	データタイプ
出力ラスターデータセット	出力ラスターデータセット。	Raster Dataset

arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})

名前	説明	データタイプ
out_path	出力ラスターデータセットが格納されるフォルダーまたはジオデータベース。	Workspace
out_name	作成するラスターデータセットの名前および形式。ジオデータベースに出力をラスターデータセットとして格納するには、ラスターデータセットの名前にファイル拡張子は付けません。ファイルベースのラスターの場合、次のように適切な拡張子を使用して、作成する形式を指定します。 `.tif`—TIFF ラスター `.img`—ERDAS IMAGINE ラスター `.crf`—CRF ラスター No extension—Esri Grid	String
distribution (オプション)	使用するランダム値の分布方法を指定します。各タイプには、分布を制御する設定が 1 つまたは 2 つあります。 `UNIFORM {Minimum}, {Maximum}`—定義された範囲における一様分布。デフォルト値は、`{Minimum}` が 0.0、`{Maximum}` が 1.0 です。どちらの値も、double 型です。 `INTEGER {Minimum}, {Maximum}`—定義された範囲における整数分布。デフォルト値は、`{Minimum}` が 1、`{Maximum}` が 10 です。どちらの値も、long 型です。 `NORMAL {Mean}, {Standard Deviation}`—`{Mean}` と `{Standard Deviation}` の値が定義された正規分布。デフォルト値は、`{Mean}` が 0.0、`{Standard Deviation}` が 1.0 です。どちらの値も、double 型です。 `EXPONENTIAL {Mean}`—`{Mean}` の値が定義された指数分布。デフォルト値は 1.0 です。値は double 型です。 `POISSON {Mean}`—`{Mean}` の値が定義されたポアソン分布。デフォルト値は 1.0 です。値は double 型です。 `GAMMA {Alpha}, {Beta}`—`{Alpha}` と `{Beta}` の値が定義されたガンマ分布。デフォルト値は、`{Alpha}` が 1.0、`{Beta}` が 1.0 です。どちらの値も、double 型です。 `BINOMIAL {N}, {Probability}`—`{N}` と `{Probability}` の値が定義された二項分布。 `{N}` は long 型でデフォルトは 10 です。 `{Probability}` は double 型でデフォルトは 0.5 です。 `GEOMETRIC {Probability}`—`{Probability}` の値が定義された幾何分布。デフォルト値は 0.5 です。値は double 型です。 `NEGATIVE BINOMIAL {r}, {Probability}`—`{r}` と `{Probability}` の値が定義されたパスカル分布。 `{r}` は double 型でデフォルトは 10.0 です。 `{Probability}` は double 型でデフォルトは 0.5 です。	String
raster_extent (オプション)	出力ラスターデータセットの範囲。 `MAXOF` - すべての入力データの最大範囲が使用されます。 `MINOF` - すべての入力データに共通する最小領域が使用されます。 `DISPLAY` - 範囲は、表示範囲と同じになります。レイヤー名 - 指定されたレイヤーの範囲が使用されます。 `Extent` オブジェクト - 指定されたオブジェクトの範囲が使用されます。スぺース区切りの座標文字列 - 指定された文字列の範囲が使用されます。座標値は、x-min、y-min、x-max、y-max という順序で表記されます。	Extent
cellsize (オプション)	出力ラスターデータセットの空間座標精度。	Double
build_rat (オプション)	選択した分布が整数出力ラスターになる出力ラスターのラスター属性テーブルを、ツールが無条件に構築するかどうかを指定します。このパラメーターは、出力ラスターが浮動小数点の場合には作用しません。 `BUILD`—整数出力ラスターのラスター属性テーブルが無条件に構築されます。これがデフォルトです。 `DO_NOT_BUILD`—個別値の数が 65535 以上の場合、整数出力ラスターのラスター属性テーブルは構築されません。個別値の数が 65535 未満の場合、ラスター属性テーブルは構築されます。	Boolean

派生した出力

名前	説明	データタイプ
out_raster_dataset	出力ラスターデータセット。	Raster Dataset

コードのサンプル

CreateRandomRaster の例 1 (Python ウィンドウ)

次のサンプルでは、定義済みの範囲およびセルサイズで正規分布の値を持つランダム値の出力ラスターを作成しています。

import arcpy
arcpy.management.CreateRandomRaster("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

# Run CreateRandomRaster
arcpy.management.CreateRandomRaster(outPath, outFile, distribution,
                                    outExtent, cellSize)

環境

範囲, 出力座標系, ピラミッド

ライセンス情報

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

ランダム ラスターの作成 (データ管理ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

ランダムラスターの作成 (データ管理ツール)