标注 | 说明 | 数据类型 |
输入表 | 包含用于计算统计数据的字段的输入表。 | Table View; Raster Layer |
输出表 | 输出表用于存储计算的统计数据。 | Table |
统计数据字段 | 指定包含将用于计算指定统计数据的属性值的一个或多个字段。 可以指定多项统计和字段组合。 空值将被排除在所有计算之外。 可使用任何一种统计来对数值属性字段进行汇总。 可以使用最小值、最大值、计数、第一个、最后一个、唯一、串连和模式统计数据对文本属性字段进行汇总。 日期、仅日期和时间戳偏移属性字段只能使用平均值、最小值、最大值、计数、第一个、最后一个、唯一和串连统计数据进行汇总。 仅以下输入地理数据库数据源支持 DBMS 统计类型:企业级地理数据库、要素服务、云数据仓库和 SQLite 地理数据库
| Value Table |
案例分组字段 (可选) | “输入”中将用于为每个唯一属性值(如果指定多个字段,则为属性值组合)单独计算统计数据的一个或多个字段。 | Field |
串连分隔符 (可选) | 当串连选项用于统计数据字段参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。 | String |
摘要
为表中字段计算汇总统计数据。
使用情况
输出将由包含统计运算结果的字段组成。
使用此工具可执行以下统计运算:总和、平均值、最小值、最大值、范围、标准差、计数、第一个、最后一个、中值、方差、唯一值、串连和模式。
如果指定案例分组字段参数,则将针对每组唯一的字段值计算统计数据。 输出表将针对每组唯一的字段值包含一条记录。 如果未指定案例分组字段参数,则将计算所有输入记录的统计数据。 输出表将包含单个记录。
输出的 Frequency 字段是唯一的一组字段值所表示的所有输入记录的计数。 如果未指定案例分组字段参数,则其将为所有输入记录的计数。
将使用以下命名约定为每种统计类型创建字段:SUM_<field>、MEAN_<field>、MIN_<field>、MAX_<field>、RANGE_<field>、STD_<field>、COUNT_<field>、FIRST_<field>、LAST_<field>、MEDIAN_<field>、VARIANCE_<field>、UNIQUE_<field>、CONCATENATE_<field>、DBMS_SUM_<field>、DBMS_MEAN_<field>、DBMS_MIN_<field>、DBMS_MAX_<field>、DBMS_STD_<field>、DBMS_COUNT_<field>、DBMS_MEDIAN_<field> 和 DBMS_VARIANCE_<field>(其中 <field> 是计算统计数据的输入字段的名称)。 当输出表是 dBASE 表时,字段名称会被截断为 10 个字符。
可以使用 DBMS 统计类型直接在数据库或服务(而非在客户端)上处理统计数据。 仅以下输入地理数据库数据源支持 DBMS 统计类型:企业级地理数据库、要素服务、云数据仓库、GeoPackage 和 SQLite 地理数据库。
DBMS 统计类型不支持 dBASE 输出。
空值将被排除在所有统计计算之外。 例如,6、4 和空值的平均值为 5 ((6+4)/2)。
使用图层时,仅使用当前所选要素计算统计数据。
参数
arcpy.analysis.Statistics(in_table, out_table, statistics_fields, {case_field}, {concatenation_separator})
名称 | 说明 | 数据类型 |
in_table | 包含用于计算统计数据的字段的输入表。 | Table View; Raster Layer |
out_table | 输出表用于存储计算的统计数据。 | Table |
statistics_fields [[field, {statistic_type}],...] | 指定包含将用于计算指定统计数据的属性值的一个或多个字段。 可以指定多项统计和字段组合。 空值将被排除在所有计算之外。 可使用任何一种统计来对数值属性字段进行汇总。 可以使用最小值、最大值、计数、第一个、最后一个、唯一、串连和模式统计数据对文本属性字段进行汇总。 日期、仅日期和时间戳偏移属性字段只能使用平均值、最小值、最大值、计数、第一个、最后一个、唯一和串连统计数据进行汇总。 仅以下输入地理数据库数据源支持 DBMS 统计类型:企业级地理数据库、要素服务、云数据仓库和 SQLite 地理数据库
| Value Table |
case_field [case_field,...] (可选) | “输入”中将用于为每个唯一属性值(如果指定多个字段,则为属性值组合)单独计算统计数据的一个或多个字段。 | Field |
concatenation_separator (可选) | 当 CONCATENATION 选项用于 statistics_fields 参数时,将用于串连值的一个或多个字符。 默认情况下,该工具将连接不带分隔符的值。 | String |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 Statistics 函数。
import arcpy
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
arcpy.analysis.Statistics("futrds", "C:/output/output.gdb/stats", [["Shape_Length", "SUM"]], "NM")
以下独立脚本汇总了主要道路 150 英尺范围内的植被区域。
# Description: Summarize the vegetation by area within 150 feet of major roads.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inRoads = "majorrds.shp"
outBuffer = "C:/output/output.gdb/buffer_out"
bufferDistance = "250 feet"
inVegetation = "Habitat_Analysis.gdb/vegtype"
outClip = "C:/output/output.gdb/clip_out"
joinField = "HOLLAND95"
joinTable = "c:/data/vegtable.dbf"
joinedField = "HABITAT"
outStatsTable = "C:/output/output.gdb/stats_out"
statsFields = [["Shape_Area", "SUM"]]
# Run Buffer to get a buffer of major roads
arcpy.analysis.Buffer(inRoads, outBuffer, bufferDistance, dissolve_option="ALL")
# Run Clip using the buffer output to get a clipped feature class of
# vegetation
arcpy.analysis.Clip(inVegetation, outBuffer, outClip)
# Run JoinField to add the vegetation type
arcpy.management.JoinField(outClip, joinField, joinTable, joinField, joinedField)
# Run Statistics to get the area of each vegetation type within the
# clipped buffer.
arcpy.analysis.Statistics(outClip, outStatsTable, statsFields, joinedField)
以下独立脚本循环遍历数据集的属性字段并构造 statistics_fields 参数,从而计算各个数值字段的 SUM 统计量。
# Description: Script that runs the Summary Statistics tool to calculate the
# Sum statistic for every numeric field based on a unique case
# field.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/f.gdb"
# Set local variables
intable = "intable"
outtable = "sumstats"
casefield = "Name"
stats = []
# Loop through all fields in the Input Table
for field in arcpy.ListFields(intable):
# Find the fields that have a numeric type
if field.type in ("Double", "Integer", "Single", "SmallInteger"):
# Add the field name and Sum statistic type to the list of fields to
# summarize
stats.append([field.name, "Sum"])
# Correct formatting of stats [["Field1", "Sum"], ["Field2", "Sum"], ...]
# Run Statistics with the stats list
arcpy.analysis.Statistics(intable, outtable, stats, casefield)
以下脚本使用 pandas DataFrame 来访问和显示 Statistics 函数的表格结果。
import arcpy
import pandas
import os
arcpy.env.overwriteOutput = True
in_table = r"d:\data\states.shp"
out_table = r"in_memory\stats_table"
stat_fields = [['POP1990', 'SUM'], ['POP1997', 'SUM']]
stats = arcpy.analysis.Statistics(in_table, out_table, stat_fields,
case_field='SUB_REGION')
# Get a list of field names to display
field_names = [i.name for i in arcpy.ListFields(out_table) if i.type != 'OID']
# Open a cursor to extract results from stats table
cursor = arcpy.da.SearchCursor(out_table, field_names)
# Create a pandas DataFrame to display results
df = pandas.DataFrame(data=[row for row in cursor],
columns=field_names)
print(df)
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是