ランダム ラスターの作成 (Create Random Raster) (データ管理)

Advanced のライセンスで利用可能。

サマリー

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

使用法

  • 出力は、Esri Grid、CRF、IMG、TIFF、または任意のジオデータベース ラスター データセットに保存することができます。

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

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

    各分布とそれらの一般的な使用法については、「ランダム値を割り当てるための分布」をご参照ください。

  • 一様分布、整数分布、正規分布、指数分布の処理時間はその引数に依存しないのに対して、ポアソン分布、ガンマ分布、二項分布、幾何分布、パスカル分布の処理時間は引数の変更によって大幅に変わることがあります。

  • 値が指定されない場合は、セル サイズ パラメーターのデフォルト値が計算されます。この値は範囲のサイズをベースとします。

  • このツールのダイアログ ボックスで、[出力範囲] パラメーターに表示される値はマップの座標系に存在します。ツールの実行中に、環境設定で指定されている範囲が [出力座標系] に投影されます。

パラメーター

ラベル説明データ タイプ
ラスター データセット名 (拡張子)

作成するラスター データセットの名前および形式。

ジオデータベースに出力をラスター データセットとして格納するには、ラスター データセットの名前にファイル拡張子は付けません。

ファイルベースのラスターの場合、次のように適切な拡張子を使用して、作成する形式を指定します。

  • .tif - TIFF ラスター
  • .img - ERDAS IMAGINE ラスター
  • .crf - CRF ラスター
  • 拡張子なし - 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
出力範囲
(オプション)

出力ラスター データセットの範囲。

  • [現在の表示範囲] マップ ビュー - 範囲は、アクティブなマップまたはシーンに基づきます。 このオプションは、アクティブなマップが存在する場合にのみ使用できます。
  • [範囲の描画] 直角化して完了 - 範囲は、マップまたはシーンに描画された四角形に基づきます。 このオプションは、プロジェクト ジオデータベースにフィーチャクラスを作成し、レイヤーをマップに追加します。 フィーチャクラスの座標系はマップと同じです。
    注意:

    このオプションは、[環境] ダイアログ ボックスでは使用できません。 範囲データ タイプを使用するツール パラメーターまたはツール ダイアログ ボックスの [環境] タブからのみ使用できます。

    注意:

    編集タブで編集を有効/無効にする編集オプションがオンの場合、範囲を描画するには [編集] リボン タブで編集を有効化する必要があります。

  • [レイヤーの範囲] Layer - 範囲は、アクティブなマップ レイヤーに基づきます。 ドロップダウン リストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップ レイヤーを組み合わせた範囲を取得します。 このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。

    各マップ レイヤーには、次のオプションがあります。

    • [すべてのフィーチャ] すべて選択 - レイヤーのすべてのフィーチャの範囲。
    • [選択フィーチャ]Area from Selected Features - レイヤーの選択フィーチャの範囲。
    • [表示フィーチャ] Extent Indicator - レイヤーの表示フィーチャの範囲。
      注意:

      [選択フィーチャ] Area from Selected Features[表示フィーチャ] Extent Indicator オプションの範囲は、フィーチャ レイヤーでのみ使用できます。

  • [参照] 参照 - 範囲は、既存のデータに基づきます。
  • [クリップボード] 貼り付け - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。
    • [範囲をコピー] コピー - 範囲の座標と座標系をクリップボードにコピーします。
    • [範囲を貼り付け] 貼り付け - 範囲の座標と、必要に応じて座標系をクリップボードから貼り付けます。 クリップボードの値に座標系が含まれていない場合、マップの座標系が範囲に使用されます。
    注意:

    範囲の座標は、ArcPy Extent オブジェクトと同じ書式と順序 (x-min、y-min、x-max、y-max、空間参照) を使用して、クリップボードからコピーおよびクリップボードから貼り付けられます。

  • [範囲をリセット] リセット - 範囲はデフォルト値にリセットされます。
  • 手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。
    注意:

    マップで、入力された座標と異なる表示単位が使用されることがあります。 基本方向 (N、S、E、W) を使用することはできません。 南と西の座標にはマイナス値の記号を使用します。

Extent
セル サイズ
(オプション)

出力ラスター データセットの空間座標精度。

Double
ラスター属性テーブルの構築
(オプション)

選択した分布が整数出力ラスターになる出力ラスターのラスター属性テーブルを、ツールが無条件に構築するかどうかを指定します。

このパラメーターは、出力ラスターが浮動小数点の場合には作用しません。

  • オン - 整数出力ラスターのラスター属性テーブルが無条件に構築されます。これがデフォルトです。
  • オフ - 個別値の数が 65535 以上の場合、整数出力ラスターのラスター属性テーブルは構築されません。個別値の数が 65535 未満の場合、ラスター属性テーブルは構築されます。
Boolean

派生した出力

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

出力ラスター データセット。

ラスター データセット

arcpy.management.CreateRandomRaster(out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})
名前説明データ タイプ
out_name

作成するラスター データセットの名前および形式。

ジオデータベースに出力をラスター データセットとして格納するには、ラスター データセットの名前にファイル拡張子は付けません。

ファイルベースのラスターの場合、次のように適切な拡張子を使用して、作成する形式を指定します。

  • .tif - TIFF ラスター
  • .img - ERDAS IMAGINE ラスター
  • .crf - CRF ラスター
  • 拡張子なし - 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

出力ラスター データセット。

ラスター データセット

コードのサンプル

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)

関連トピック