データセットの記述 (Describe Dataset) (GeoAnalytics)—ArcGIS Pro

サマリー

フィーチャを集計して、フィールド統計情報、サンプルフィーチャ、範囲境界を算出します。

図

使用法

このジオプロセシングツールは ArcGIS Enterprise 10.7 以降で使用できます。
[データセットの記述 (Describe Dataset)] ツールの機能例を以下に示します。
- ビッグデータファイル共有に時間とジオメトリを正しく登録できていることを確認します。
- 集約されたフィールド統計情報を使用して、属性値を把握します。
- サンプルレイヤーを使用してビッグデータを視覚化します。100 万個のフィーチャを描画する代わりに、サンプルを描画します。
- 長時間および大規模な処理を行うためにスケーリングする前に、サンプルデータを使用してワークフローを実行します。
- 地理的範囲を計算して、データセットの場所を特定します。
デフォルトで、このツールは、入力レイヤー内の各フィールドの統計情報のサマリーを含むテーブルを出力します。また、入力レイヤーのジオメトリプロパティまたは時間プロパティが記述されたテーブルもジオプロセシングウィンドウに出力されます。
入力レイヤーにジオメトリが含まれている場合、このツールは、入力レイヤーの次のジオメトリプロパティが記述されたテーブルを出力します。
- [Geometry type] - 入力レイヤーのジオメトリタイプ。この値は、ポイント、ライン、またはポリゴンのいずれかです。
- [Spatial reference] - 入力レイヤーの空間参照。
- [Count of non-empty features] - 入力レイヤーの空間参照の範囲内の有効なジオメトリが含まれているフィーチャの数。
- [Count of empty features] - 有効なジオメトリが含まれていないフィーチャの数。これらのフィーチャに空のジオメトリが含まれているか、該当するジオメトリが使用している空間参照の範囲外である可能性があります。
- [Spatial extent] - 入力レイヤー内のフィーチャの空間範囲。
入力レイヤーが時間対応の場合、このツールは、入力レイヤーの次の時間プロパティが記述されたテーブルを出力します。
- [Time type] - 入力レイヤーの時間タイプ。この値は即時または間隔のいずれかです。
- [Count of non-empty features] - 有効な時間値が含まれているフィーチャの数。
- [Count of empty features] - NULL 値または無効な時間値が含まれているフィーチャの数。
- [Temporal extent] - 入力レイヤー内のフィーチャの時間範囲。この値は開始時間と終了時間で構成されます。
[サンプルフィーチャ数] パラメーターを使用して、サンプルにフィーチャ数を指定します。このパラメーターを空白のままにするか、0 を選択すると、サンプルは作成されません。出力サブセットには、入力フィーチャと同じスキーマ、ジオメトリ、および時間設定が含まれています。サブセットを使用して、データセットがマップに追加されるか、属性テーブルで視覚化された場合の外観を把握できます。さらに、サブセットに対して解析を実行することで、大規模な分析を行う際の最適な入力を決定することができます。
サンプルサイズを入力フィーチャの合計数より大きい数を指定すると、すべてのフィーチャが返されます。
サンプルレイヤーは、正確にランダムなジオグラフィを表すものではないため、データの地理的範囲や分布を理解するためには使用しないでください。たとえば、[サンプルフィーチャ数] に「230」個のフィーチャを指定した場合、結果には順番や場所が考慮されない 230 個の入力フィーチャが含まれます。
[範囲レイヤーを作成] パラメーターを使用して、入力データセットの範囲を表す境界フィーチャを作成します。出力は、入力フィーチャの地理的範囲を表す単一のポリゴンフィーチャになります。範囲レイヤーを使用して、データが保存されている場所を判定したり、ワークフローの他の箇所でデータを入力として使用したりできます。たとえば、[レイヤーのクリップ (Clip Layer)] GeoAnalytics ツールを使用して、フィーチャをクリップするポリゴンレイヤーとして範囲レイヤーを使用できます。
必要に応じて、環境設定を使用して、フィーチャの出力方法を指定します。
たとえば、[範囲] 環境を使用して、対象地域を表す範囲レイヤー、または定義された分析範囲のサンプルフィーチャを出力します。
さらに、[出力座標系] 環境を使用して、目的の空間参照に出力を投影します。
[範囲レイヤーを作成] パラメーターは、ポイント、ライン、およびポリゴンフィーチャでのみサポートされています。テーブルフィーチャの範囲レイヤーは作成されません。
ジオプロセシングツールは、ArcGIS GeoAnalytics Server を活用しています。解析は GeoAnalytics Server で実行され、結果が ArcGIS Enterprise のコンテンツに保存されます。
GeoAnalytics Server ツールを実行する場合、解析は GeoAnalytics Server で実行されます。最適なパフォーマンスを得るためには、GeoAnalytics Server ポータルでホストされているフィーチャレイヤーかビッグデータファイル共有を通じて、ArcGIS Enterprise にデータを提供する必要があります。 GeoAnalytics Server のローカルにないデータは、解析が開始する前に GeoAnalytics Server に移動されます。つまり、ツールを実行する時間が長くなり、場合によっては ArcGIS Pro から GeoAnalytics Server にデータを移動できないこともあります。エラーの閾値はネットワークの速度や、データのサイズや複雑さに左右されます。データを必ず共有するか、ビッグデータファイル共有を作成することをお勧めします。
データをポータルで共有する方法の詳細
ArcGIS Server Manager を使用してビッグデータファイル共有を作成する方法の詳細

パラメーター

ラベル	説明	データタイプ
入力レイヤー	記述対象のポイント、ライン、ポリゴン、またはテーブルフィーチャ。	Record Set
出力名	出力フィーチャサービスの名前。	String
サンプルフィーチャ数 (オプション)	出力サンプルレイヤーに含まれるフィーチャの数。0 を選択するか、数値を指定しない場合は、サンプルは返されません。デフォルトでは、サンプルレイヤーは返されません。	Long
範囲レイヤーを作成 (オプション)	出力範囲レイヤーが作成されるかどうかを指定します。範囲は、入力フィーチャの空間および時間範囲を示すポリゴンです。オン - 範囲レイヤーが作成されます。オフ - 範囲レイヤーが作成されません。	Boolean
データストア (オプション)	出力の保存先の ArcGIS Data Store を指定します。デフォルトは、[ビッグデータストア] です。ビッグデータストアに格納されたすべての結果は、WGS84 で保存されます。リレーショナルデータストアに格納された結果は、それらの座標系を維持します。ビッグデータストア—出力がビッグデータストアに格納されます。これがデフォルトです。リレーショナルデータストア—出力がリレーショナルデータストアに格納されます。	String

派生した出力

ラベル	説明	データタイプ
出力	集計された統計計算値を含む出力レイヤー。	レコードセット
レイヤーの範囲	create_extent_layer パラメーターが選択されると、ツールは、データセットの範囲を示す単一のポリゴンを含むレイヤーを出力します。	フィーチャセット
サンプルレイヤー	sample_features パラメーターに 0 より大きい値を指定すると、ツールは、データセットの指定された数のサンプルフィーチャを含むレイヤーを出力します。	フィーチャセット
出力 JSON ファイル	このパラメーターは使用されていません。解析で計算されたすべてのサマリー情報を含む JSON 文字列が、ツールのメッセージに含まれます。	String

arcpy.geoanalytics.DescribeDataset(input_layer, output_name, {sample_features}, {create_extent_layer}, {data_store})

名前	説明	データタイプ
input_layer	記述対象のポイント、ライン、ポリゴン、またはテーブルフィーチャ。	Record Set
output_name	出力フィーチャサービスの名前。	String
sample_features (オプション)	出力サンプルレイヤーに含まれるフィーチャの数。0 を選択するか、数値を指定しない場合は、サンプルは返されません。デフォルトでは、サンプルレイヤーは返されません。	Long
create_extent_layer (オプション)	出力範囲レイヤーが作成されるかどうかを指定します。範囲は、入力フィーチャの空間および時間範囲を示すポリゴンです。 CREATE_EXTENT—範囲レイヤーが作成されます。 NO_EXTENT—範囲レイヤーが作成されません。	Boolean
data_store (オプション)	出力の保存先の ArcGIS Data Store を指定します。デフォルトは、SPATIOTEMPORAL_DATA_STORE です。ビッグデータストアに格納されたすべての結果は、WGS84 で保存されます。リレーショナルデータストアに格納された結果は、それらの座標系を維持します。 SPATIOTEMPORAL_DATA_STORE—出力がビッグデータストアに格納されます。これがデフォルトです。 RELATIONAL_DATA_STORE—出力がリレーショナルデータストアに格納されます。	String

派生した出力

名前	説明	データタイプ
output	集計された統計計算値を含む出力レイヤー。	レコードセット
extent_layer	create_extent_layer パラメーターが選択されると、ツールは、データセットの範囲を示す単一のポリゴンを含むレイヤーを出力します。	フィーチャセット
sample_layer	sample_features パラメーターに 0 より大きい値を指定すると、ツールは、データセットの指定された数のサンプルフィーチャを含むレイヤーを出力します。	フィーチャセット
output_json	このパラメーターは使用されていません。解析で計算されたすべてのサマリー情報を含む JSON 文字列が、ツールのメッセージに含まれます。	String

コードのサンプル

DescribeDataset (データセットの記述) の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、DescribeDatasetツールの使用方法を示しています。

このスクリプトでは、ネットワークフィーチャが記述され、2500 フィーチャのサンプルレイヤーが作成されます。

#-------------------------------------------------------------------------------
# Name: DescribeDataset.py
# Description: 
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inputDataset = "https://sampleserver.domain.com/arcgis/rest/services/DataStoreCatalogs/bigDataFileShares_MyBDFS/BigDataCatalogServer/networkDataset"
outputName = "my_network_described"
dataStore = "RELATIONAL"
# Execute Describe Dataset
arcpy.geoanalytics.DescribeDataset(inputDataset, outputName, 2500, "CREATE_EXTENT", dataStore)

環境

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

特殊なケース

出力座標系: 解析で使用される座標系。このパラメーターで指定されない限り、入力の座標系で解析が行われます。 GeoAnalytics Tools の場合、最終結果は WGS84 のビッグデータストアに保存されます。

ライセンス情報

Basic: 次のものが必要 ArcGIS GeoAnalytics Server
Standard: 次のものが必要 ArcGIS GeoAnalytics Server
Advanced: 次のものが必要 ArcGIS GeoAnalytics Server

サマリー

図

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容