汇总统计数据 (分析工具)

汇总

为表中字段计算汇总统计数据。

插图

汇总统计数据工具图示

用法

输出将由包含统计运算结果的字段组成。
使用此工具可执行以下统计运算：总和、平均值、最小值、最大值、范围、标准差、计数、第一个、最后一个、中值、方差、唯一值、串连和众数。
如果指定案例分组字段参数，则将针对每组唯一的字段值计算统计数据。输出表将针对每组唯一的字段值包含一条记录。如果未指定案例分组字段参数，则将计算所有输入记录的统计数据。输出表将包含单个记录。

输出的 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)。
使用图层时，仅使用当前所选要素计算统计数据。

标注	说明	数据类型
输入表	包含用于计算统计数据的字段的输入表。	Table View; Raster Layer
输出表	输出表用于存储计算的统计数据。	Table
统计字段	指定包含将用于计算指定统计数据的属性值的字段。可以指定多项统计和字段组合。空值将被排除在所有计算之外。可使用任何一种统计来对数值属性字段进行汇总。可以使用最小值、最大值、计数、第一个、最后一个、唯一值、串连和众数统计数据对文本属性字段进行汇总。只能使用平均值、最小值、最大值、计数、第一个、最后一个、唯一值和串连统计数据对日期、仅日期和时间戳偏移属性字段进行汇总。仅以下输入地理数据库数据源支持 DBMS 统计类型：企业级地理数据库、要素服务、云数据仓库和 SQLite 地理数据库值表列： Field—The field containing attribute values used to calculate the specified statistic. Statistic Type—The statistic type. Sum—The values for the specified field will be added together. Mean—The average for the specified field will be calculated. Minimum—The smallest value of the specified field will be identified. Maximum—The largest value of the specified field will be identified. Range—The range of values (maximum minus minimum) for the specified field will be calculated. Standard deviation—The standard deviation of values for the specified field will be calculated. Count—The number of values in the specified field will be identified. First—The specified field value of the first record in the input will be used. Last—The specified field value of the last record in the input will be used. Median—The median of the specified field will be calculated. Variance—The variance of the specified field will be calculated. Unique—The number of unique values of the specified field will be counted. Concatenate—The values for the specified field will be concatenated. Mode—The mode (the most common value) for the specified field will be identified. If more than one value is equally common, the lowest value will be returned. DBMS Sum—The values for the specified field will be added together. DBMS Mean—The average for the specified field will be calculated. DBMS Minimum—The smallest value of the specified field will be identified. DBMS Maximum—The largest value of the specified field will be identified. DBMS Standard deviation—The standard deviation of values for the specified field will be calculated. DBMS Count—The number of values in the specified field will be identified. DBMS Median—The median of the specified field will be calculated. DBMS Variance—The variance of the specified field will be calculated.	Value Table
案例分组字段（可选）	“输入”中将用于为每个唯一属性值（如果指定多个字段，则为属性值组合）单独计算统计数据的一个或多个字段。	Field
串连分隔符（可选）	当串连选项用于统计字段参数时，将用于串连值的一个或多个字符。默认情况下，该工具将连接不带分隔符的值。	String

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 地理数据库值表列： `Field`—The field containing attribute values used to calculate the specified statistic. `Statistic Type`—The statistic type. `SUM`—The values for the specified field will be added together. `MEAN`—The average for the specified field will be calculated. `MIN`—The smallest value of the specified field will be identified. `MAX`—The largest value of the specified field will be identified. `RANGE`—The range of values (maximum minus minimum) for the specified field will be calculated. `STD`—The standard deviation of values for the specified field will be calculated. `COUNT`—The number of values in the specified field will be identified. `FIRST`—The specified field value of the first record in the input will be used. `LAST`—The specified field value of the last record in the input will be used. `MEDIAN`—The median of the specified field will be calculated. `VARIANCE`—The variance of the specified field will be calculated. `UNIQUE`—The number of unique values of the specified field will be counted. `CONCATENATE`—The values for the specified field will be concatenated. `MODE`—The mode (the most common value) for the specified field will be identified. If more than one value is equally common, the lowest value will be returned. `DBMS_SUM`—The values for the specified field will be added together. `DBMS_MEAN`—The average for the specified field will be calculated. `DBMS_MIN`—The smallest value of the specified field will be identified. `DBMS_MAX`—The largest value of the specified field will be identified. `DBMS_STD`—The standard deviation of values for the specified field will be calculated. `DBMS_COUNT`—The number of values in the specified field will be identified. `DBMS_MEDIAN`—The median of the specified field will be calculated. `DBMS_VARIANCE`—The variance of the specified field will be calculated.	Value Table
case_field [case_field,...] （可选）	“输入”中将用于为每个唯一属性值（如果指定多个字段，则为属性值组合）单独计算统计数据的一个或多个字段。	Field
concatenation_separator （可选）	当 `CONCATENATION` 选项用于 `statistics_fields` 参数时，将用于串连值的一个或多个字符。默认情况下，该工具将连接不带分隔符的值。	String

代码示例

Statistics 示例 1（Python 窗口）

以下 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")

Statistics 示例 2（独立脚本）

以下独立脚本汇总了主要道路 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 示例 3（独立脚本）

以下独立脚本循环遍历数据集的属性字段并构造 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)

Statistics 示例 4（独立脚本）

以下脚本使用 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)

环境

输出配置关键字, 当前工作空间, 临时工作空间, 时区

特殊情况

时区: The mean statistic type on a Timestamp offset field will use the timezone offset from this environment.

许可信息

基本: 是
标准: 是
高级: 是

汇总统计数据 (分析工具)

汇总

插图

用法

参数

环境

特殊情况

许可信息

相关主题