描述
将要素汇总到所计算的字段统计信息、样本要素和范围边界中。
插图
使用方法
此地理处理工具适用于 ArcGIS Enterprise 10.7 或更高版本。
以下是您可使用描述数据集工具执行的操作示例：
- 验证您是否已将时间和几何正确注册到大数据文件共享。
- 了解属性值和汇总字段统计数据。
- 使用样本图层可视化您的大数据。绘制样本，而不是绘制一百万个要素。
- 在针对更长时间和更大规模的处理进行扩展前，使用数据样本运行工作流。
- 通过计算地理范围来确定数据集的位置。
默认情况下，该工具会输出一个表，包含输入图层中每个字段的汇总统计数据。此外，还会将表打印到地理处理窗口，以描述输入图层的所有几何或时间属性。
如果输入图层具有几何，则该工具将打印描述输入图层的以下几何属性的表：
- 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 - 时间值为空或无效的要素数。
- Temporal extent - 输入图层中要素的时间范围。该值包含开始时间和结束时间。
使用采样要素数参数，以指定要采样的要素数量。如果将其留空或选择 0，则不会创建任何样本。该输出子集会具有与输入要素相同的方案、几何和时间设置。子集可用于了解数据集在添加到地图或在属性表中可视化时的显示方式。此外，您可以对子集运行分析，以确定进行大数据分析的最佳输入。
如果指定的样本大小大于输入要素总数，则将返回所有要素。
样本图层并不代表真正随机的地理选择，不应用于了解数据的地理范围或分布。例如，如果您将采样要素数指定为 230 个要素，则结果可以包含以任何顺序排列或位于任何位置的 230 个输入要素。
使用创建范围图层参数，创建用于描述输入数据集范围的边界要素。该输出将包含表示输入要素地理范围的单个面要素。范围图层可用于确定数据存储的位置，或将其用作工作流中其他位置的输入。例如，将其用作使用 GeoAnalytics 裁剪图层工具裁剪要素所形成的面图层。
或者，可使用环境设置来指定要素的输出方式。
例如，可使用范围环境来输出表示感兴趣区域的范围图层，或从定义的研究区域输出样本要素。
此外，可使用输出坐标系环境将输出内容投影到所需的空间参考。
创建范围图层参数仅支持点、线和面要素。将不会为表格要素创建范围图层。
此地理处理工具由 ArcGIS GeoAnalytics Server 作为支持。分析将在 GeoAnalytics Server 上完成，且结果将存储在 ArcGIS Enterprise 的内容中。
当 GeoAnalytics Server 工具运行时，GeoAnalytics Server 上的分析已完成。要获得最佳性能，通过 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，可以将数据用于 GeoAnalytics Server。在分析开始之前，非 GeoAnalytics Server 本地数据将被转移到您的 GeoAnalytics Server。这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。因此，建议您始终共享数据或创建大数据文件共享。
语法
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 （可选） | 指定是否将创建输出范围图层。范围是一个可表示输入要素的空间和时态范围的面。
| Boolean |
data_store （可选） | 指定将用于保存输出的 ArcGIS Data Store。默认为 SPATIOTEMPORAL_DATA_STORE。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。
| String |
派生输出
| 名称 | 说明 | 数据类型 |
| output | 包含汇总统计计算数据的输出图层。 | 记录集 |
| extent_layer | 选择了 create_extent_layer 参数后，工具将输出包含表示数据集范围的单个面的图层。 | 要素集 |
| sample_layer | 将 sample_features 参数指定为大于零的值后，此工具将输出包含数据集中指定数量的样本要素的图层。 | 要素集 |
| output_json | 不使用此参数。该工具的消息中包含 JSON 字符串，其中包含在分析中计算出的所有汇总信息。 | 字符串 |
代码示例
以下 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 工具，最终结果将存储于 WGS84 中的时空数据存储之内。
许可信息
- Basic: 需要 ArcGIS GeoAnalytics Server
- Standard: 需要 ArcGIS GeoAnalytics Server
- Advanced: 需要 ArcGIS GeoAnalytics Server