描述数据集 (GeoAnalytics Server 工具)

汇总

将要素汇总到所计算的字段统计信息、样本要素和范围边界中。

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

插图

“描述数据集”工具图示

用法

此地理处理工具适用于 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 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。建议您始终共享数据或创建大数据文件共享。

了解有关将数据共享至您的门户的详细信息

了解有关通过 Server Manager 创建大数据文件共享的详细信息

标注	说明	数据类型
输入图层	要描述的点、线、面或表格要素。	Record Set
输出名称	输出要素服务的名称。	String
采样要素数（可选）	将包含在输出样本图层中的要素数量。如果选择 0 个要素或不提供数量，则不会返回任何样本。默认情况下，不返回任何样本图层。	Long
创建范围图层（可选）	指定是否将创建输出范围图层。该范围是一个面，用于表示输入要素的空间和时间范围。选中—将创建范围图层。未选中—不会创建范围图层。	Boolean
数据存储（可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。时空大数据存储—输出将存储在时空大数据存储中。这是默认设置。关系数据存储—输出将存储在关系数据存储中。	String

派生输出

标注	说明	数据类型
输出	包含汇总统计数据计算的输出图层。	Record Set
范围图层	选择 `create_extent_layer` 参数后，工具将输出包含表示数据集范围的单个面的图层。	Feature Set
样本图层	当 `sample_features` 参数指定的值大于零时，工具将输出一个图层，其中包含数据集中的指定数目的样本要素。	Feature Set
输出 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。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String

派生输出

名称	说明	数据类型
output	包含汇总统计数据计算的输出图层。	Record Set
extent_layer	选择 `create_extent_layer` 参数后，工具将输出包含表示数据集范围的单个面的图层。	Feature Set
sample_layer	当 `sample_features` 参数指定的值大于零时，工具将输出一个图层，其中包含数据集中的指定数目的样本要素。	Feature Set
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"

# Run Describe Dataset
arcpy.geoanalytics.DescribeDataset(inputDataset, outputName, 2500, "CREATE_EXTENT", 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.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7
标准: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7
高级: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.7

描述数据集 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题