密度の計算 (GeoAnalytics Server ツール)

サマリー

各セルの近傍内にあるポイントフィーチャから単位面積ごとの値を計算します。

レガシー:

ArcGIS GeoAnalytics Server エクステンションは ArcGIS Enterprise では非推奨になっています。 GeoAnalytics Server の最終リリースは、ArcGIS Enterprise 11.3 に付属しています。このジオプロセシングツールは、ArcGIS Enterprise 11.3 およびそれ以前のバージョンで使用できます。

時間ステップの仕組みの詳細

図

密度の計算ツールの図

使用法

密度の計算 ツールは、単一入力としてポイントフィーチャを必要とします。
密度は、1 つ以上の count フィールドを使用して計算できます。 count フィールドは、各位置のインシデントの数を指定する数値フィールドです。都市や高速道路などのフィーチャでは、人口または交通レーンの密度をそれぞれ計算するときに count フィールドが使用されます。 count フィールドを指定すると、ポイントの密度に加えて count フィールドの密度も計算されます。
解析のため、入力ポイントはビンに集約されます。データを集約するには、ビンサイズを指定する必要があります。デフォルトでは、出力結果の単位は平方キロメートルです。
入力ポイントは、指定したサイズと形状 (六角形または正方形) のビンに集約されます。六角形に集約している場合、ビンサイズ d は各六角形の高さになり、生成される六角形の幅は、高さの 2 倍を 3 の平方根で除算した値になります。正方形に集約している場合は、ビンのサイズは四角形の高さ (幅と同じ) になります。
ビンサイズより大きな近傍サイズを指定する必要があります。近傍サイズは、対象フィーチャ (ビン) と同じ近傍内の入力フィーチャを検索するために使用されます。
近傍サイズの値が大きいほど、単純化された密度の出力が作成されます。値が小さいほど、詳細を示す出力が作成されます。
近傍内にあるポイントだけが、密度の計算時に考慮されます。特定のセルの近傍内にポイントがない場合、そのセルには値が割り当てられません。
密度の計算には、2 つの重み付けオプションがあります。一様オプションは、近傍内のすべての値を合計し、それらを面積で除算します。 カーネル オプションは、対象フィーチャからの距離によって近傍の値を重み付けし、各ポイントに滑らかなテーパーサーフェスを合わせるカーネル関数を適用します。
ポイントを含むビンの近傍内のエリアのみが返されます。
面積単位の係数単位がポイント間の距離に比べて小さい場合、出力値も非常に小さくなる可能性があります。大きな値を得るには、大きな単位の面積単位の係数 (たとえば、平方メートル ではなく 平方キロメートル) を使用します。
密度の計算 では、エリアレイヤーが投影座標系になくてはなりません。データが投影されておらず、投影座標系を設定していない場合、解析は正積円筒図法 (WKID 54034) で実施されます。
密度値は常に浮動小数値になります。
密度の計算 ツールでは、時間ステップを使用して解析できます。各タイムステップは、タイムステップ外のフィーチャとは切り離して解析されます。時間ステップを使用するには、入力データを時間対応にし、任意の時点を時間で表す必要があります。時間ステップを適用すると、出力フィーチャはフィールドで表した時間間隔になります。
時間ステップを使用して入力フィーチャを解析した場合、各時間ステップは、時間ステップ外部にあるフィーチャとは独立して解析されます。
時間ステップの基準 パラメーターには、日時の値または日付のみの値を指定できますが、時間のみの値を指定することはできません。

出力フィーチャには、次のフィールドが含まれます:


フィールド名	説明
`density`	所定のポリゴンの密度。これは、指定した単位の縮尺係数で返されます。
`density_<fieldname>`	所定のフィールドで重み付けされた密度。これは、1 つ以上のフィールドが指定された場合のみ返されます。
`start_datetime`	時間ステップを指定すると、出力ポリゴンに時間間隔が含まれるようになります。このフィールドは、開始時間を表します。
`end_datetime`	時間ステップを指定すると、出力ポリゴンに時間間隔が含まれるようになります。このフィールドは、終了時間を表します。

次のうち 1 つ以上を行うことで、密度の計算 ツールのパフォーマンスを向上できます:
- 対象データのみが解析されるように、範囲環境を設定します。
- 大きいビンを使用した方が小さいビンよりパフォーマンスが高くなります。使用するサイズが不明な場合は、大きいビンを使用して試してみます。
- ビンと同じように、大きい時間ステップの方が、小さい時間ステップよりパフォーマンスが高くなります。
- ビンサイズに対する近傍サイズの比率を減らします。ビンのサイズの 3 倍の近傍サイズは、ビンサイズの 10 倍の近傍サイズよりパフォーマンスが高くなります。
- 解析が実行されている場所に対してローカルなデータを使用します。
このジオプロセシングツールは、ArcGIS GeoAnalytics Server によって駆動されます。解析は GeoAnalytics Server 上で行われ、結果は ArcGIS Enterprise のコンテンツに保存されます。
GeoAnalytics Server ツールを実行するとき、解析は GeoAnalytics Server 上で行われます。最適なパフォーマンスを得るには、ArcGIS Enterprise ポータルでホストされているフィーチャレイヤーか、ビッグデータファイル共有を通じて、データを GeoAnalytics Server から利用可能にします。 GeoAnalytics Server のローカルにないデータは、解析が開始する前に GeoAnalytics Server に移動されます。このため、ツールの実行時間が長くなり、場合によっては ArcGIS Pro から GeoAnalytics Server にデータを移動できないこともあります。エラーの閾値はネットワークの速度や、データのサイズや複雑さに左右されます。データを必ず共有するか、ビッグデータファイル共有を作成することをおすすめします。

データをポータルで共有する方法の詳細

Server Manager を使用してビッグデータファイル共有を作成する方法の詳細
次のツールを使用して、類似の解析を実行することもできます。
- GeoAnalytics Desktop ツールボックスまたは GeoAnalytics Server ツールボックスのポイントの集約
- Spatial Analyst ツールボックスの ポイント密度 ツール
- Spatial Analyst ツールボックスの カーネル密度 ツール
- 標準フィーチャ解析ツールボックスの 密度の計算 ツール

ラベル	説明	データタイプ
入力レイヤー	密度の計算に使用するポイント。	Feature Set
出力名	出力フィーチャサービスの名前。	String
ビンタイプ	解析で使用されるビンの形状を指定します。正方形—ビンの形状は正方形です。これがデフォルトです。六角形—ビンの形状は六角形です。	String
ビンサイズ	入力フィーチャの集約に使用するビンのサイズ。正方形のビンを生成する場合、指定された数値と単位によって、正方形の高さと長さが決まります。六角形の場合、指定された数値と単位によって、平行な 2 辺の距離が決まります。	Linear Unit
加重	密度計算に適用される重み付けを指定します。一様—各ビンが均等に重み付けされた単位面積ごとの値の計算が使用されます。これがデフォルトです。カーネル—ポイントに近いビンほど大きく重み付けするスムージングアルゴリズム (カーネル) が適用される単位面積ごとの値の計算が使用されます。	String
近傍サイズ	密度計算に適用される検索範囲。	Linear Unit
フィールド (オプション)	各フィーチャの母数値を示す 1 つ以上のフィールド。母数フィールドは、連続サーフェスを作成する地形上に分散する個数や数量です。母数フィールドの値は数値である必要があります。デフォルトでは、入力ポイント数の密度が常に計算されます。	Field
面積単位の係数 (オプション)	出力密度値に使用される面積単位を指定します。デフォルトの単位は、出力空間参照の単位に基づきます。国際エーカー—面積単位は国際エーカーです。ヘクタール—面積単位はヘクタールです。平方法定マイル—面積単位は平方法定マイルです。平方キロメートル—面積単位は平方キロメートルです。平方メートル—面積単位は平方メートルです。平方国際フィート—面積単位は平方国際フィートです。平方国際ヤード—面積単位は平方国際ヤードです。平方米国測量マイル—面積単位は平方米国測量マイルです。平方米国測量フィート—面積単位は平方米国測量フィートです。平方米国測量ヤード—面積単位は平方米国測量ヤードです。米国測量エーカー—面積単位は米国測量エーカーです。	String
時間ステップの間隔 (オプション)	時間ステップの期間を指定する値。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。時間ステップは、入力が時間対応である場合にのみ適用できます。	Time Unit
時間ステップの反復 (オプション)	時間ステップの間隔が発生する頻度を指定する値。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。	Time Unit
時間ステップの基準 (オプション)	時間ステップを揃える基準日時を指定。デフォルト値は、1970 年 1 月 1 日 12:00 a.m. です。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。	Date
データストア (オプション)	出力が格納される ArcGIS Data Store を指定します。ビッグデータストアに格納されたすべての結果は、WGS84 で保存されます。リレーショナルデータストアに格納された結果は、それらの座標系を維持します。時空間ビッグデータストア—出力がビッグデータストアに格納されます。これがデフォルトです。リレーショナルデータストア—出力がリレーショナルデータストアに格納されます。	String

派生した出力

ラベル	説明	データタイプ
出力フィーチャクラス	各セルの近傍内にあるポイントフィーチャから求められる単位面積ごとの値。	Feature Set

arcpy.geoanalytics.CalculateDensity(input_layer, output_name, bin_type, bin_size, weight, neighborhood_size, {fields}, {area_unit_scale_factor}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {data_store})

名前	説明	データタイプ
input_layer	密度の計算に使用するポイント。	Feature Set
output_name	出力フィーチャサービスの名前。	String
bin_type	解析で使用されるビンの形状を指定します。 `SQUARE`—ビンの形状は正方形です。これがデフォルトです。 `HEXAGON`—ビンの形状は六角形です。	String
bin_size	入力フィーチャの集約に使用するビンのサイズ。正方形のビンを生成する場合、指定された数値と単位によって、正方形の高さと長さが決まります。六角形の場合、指定された数値と単位によって、平行な 2 辺の距離が決まります。	Linear Unit
weight	密度計算に適用される重み付けを指定します。 `UNIFORM`—各ビンが均等に重み付けされた単位面積ごとの値の計算が使用されます。これがデフォルトです。 `KERNEL`—ポイントに近いビンほど大きく重み付けするスムージングアルゴリズム (カーネル) が適用される単位面積ごとの値の計算が使用されます。	String
neighborhood_size	密度計算に適用される検索範囲。	Linear Unit
fields [fields,...] (オプション)	各フィーチャの母数値を示す 1 つ以上のフィールド。母数フィールドは、連続サーフェスを作成する地形上に分散する個数や数量です。母数フィールドの値は数値である必要があります。デフォルトでは、入力ポイント数の密度が常に計算されます。	Field
area_unit_scale_factor (オプション)	出力密度値に使用される面積単位を指定します。デフォルトの単位は、出力空間参照の単位に基づきます。 `ACRES`—面積単位は国際エーカーです。 `HECTARES`—面積単位はヘクタールです。 `SQUARE_MILES`—面積単位は平方法定マイルです。 `SQUARE_KILOMETERS`—面積単位は平方キロメートルです。 `SQUARE_METERS`—面積単位は平方メートルです。 `SQUARE_FEET`—面積単位は平方フィートです。 `SQUARE_YARDS`—面積単位は平方ヤードです。 `SQUARE_MILES_US`—面積単位は平方米国測量マイルです。 `SQUARE_FEET_US`—面積単位は平方米国測量フィートです。 `SQUARE_YARDS_US`—面積単位は平方米国測量ヤードです。 `ACRES_US`—面積単位は米国測量エーカーです。	String
time_step_interval (オプション)	時間ステップの期間を指定する値。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。時間ステップは、入力が時間対応である場合にのみ適用できます。	Time Unit
time_step_repeat (オプション)	時間ステップの間隔が発生する頻度を指定する値。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。	Time Unit
time_step_reference (オプション)	時間ステップを揃える基準日時を指定。デフォルト値は、1970 年 1 月 1 日 12:00 a.m. です。このパラメーターは、入力ポイントが時間対応であり、特定時点を表す場合にのみ使用できます。	Date
data_store (オプション)	出力が格納される ArcGIS Data Store を指定します。ビッグデータストアに格納されたすべての結果は、WGS84 で保存されます。リレーショナルデータストアに格納された結果は、それらの座標系を維持します。 `SPATIOTEMPORAL_DATA_STORE`—出力がビッグデータストアに格納されます。これがデフォルトです。 `RELATIONAL_DATA_STORE`—出力がリレーショナルデータストアに格納されます。	String

派生した出力

名前	説明	データタイプ
output	各セルの近傍内にあるポイントフィーチャから求められる単位面積ごとの値。	Feature Set

コードのサンプル

CalculateDensity (Python ウィンドウ)

次の Python ウィンドウスクリプトは、CalculateDensity 関数の使用方法を示しています。

# Name: Calculate Density.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
# This example uses a big data file share name "HealthInfo" with dataset
# "Outbreaks" registered on a GeoAnalytics server
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_HealthInfo/BigDataCatalogServer/Outbreaks"

# By default, the count of points will be used in addition to any other fields
# that are specified
fields = "Severity"

# Set the size of bins and neighborhood and the time step size
binSize = "1 Kilometers"
neighborhoodSize = "2 Kilometers"
timeStepInterval = "1 Weeks"

# Specify output info
outFS = "OutbreakDensity"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Calculate Density
arcpy.geoanalytics.CalculateDensity(inFeatures, outFS, 'HEXAGON', binSize,
                                    'UNIFORM', neighborhoodSize, fields,
                                    'SQUARE_KILOMETERS', timeStepInterval, None,
                                    None, dataStore)

環境

出力座標系, 範囲, 現在のワークスペース

特殊なケース

出力座標系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

ライセンス情報

Basic: ArcGIS GeoAnalytics Server が必要
Standard: ArcGIS GeoAnalytics Server が必要
Advanced: ArcGIS GeoAnalytics Server が必要

密度の計算 (GeoAnalytics Server ツール)

サマリー

レガシー:

図

使用法

パラメーター

派生した出力

環境

特殊なケース

ライセンス情報

関連トピック