Суммарная статистика (Инструменты Анализа)

Краткая информация

Вычисляет суммарную статистику для полей в таблице.

Иллюстрация

Иллюстрация инструмента Суммарная статистика

Использование

Выходная таблица будет состоять из полей, содержащих результат статистических операций.
С этим инструментом доступны следующие статистические операции: сумма, среднее, максимум, минимум, диапазон, среднеквадратическое отклонение, количество, первое, последнее, медиана, дисперсия, уникальные, объединение и мода.
Если задан параметр Поле комбинаций, статистика будет рассчитана отдельно для каждого уникального набора значений поля. Выходная таблица будет включать одну запись для каждого уникального набора значений поля. Если параметр Поле комбинаций не задан, статистика будет рассчитана для всех входных записей. Выходная таблица будет содержать одну запись.

Выходное поле 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>, где <поле> является именем входного поля, для которого вычисляется статистика. Имя поля сокращается до 10 символов, если выходная таблица является таблицей dBASE.
Используйте типы статистики СУБД для обработки статистики непосредственно в базе данных или сервисе, а не на стороне клиента. Типы статистики СУБД поддерживаются только для входных источников данных базы геоданных, включая многопользовательские базы геоданных, сервисы объектов, облачные хранилища данных, GeoPackage и базы геоданных SQLite.

Типы статистики СУБД не поддерживают вывод dBASE.
Пустые значения не включаются в расчет статистики. Например, среднее 6, 4, и пустого значения равно 5 ((6+4)/2).
При использовании слоев, только выбранные в текущий момент пространственные объекты используются для вычисления статистики.

Подпись	Объяснение	Тип данных
Входная таблица	Входная таблица, содержащая поля, для которых требуется вычислить статистику.	Table View; Raster Layer
Выходная таблица	Выходная таблица, в которую будет записана вычисленная статистика.	Table
Поля статистики	Указывает поле или поля, содержащие значения атрибутов, которые будут использоваться для расчета указанной статистики. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Текстовые поля атрибутов могут быть суммированы с помощью статистики: минимум, максимум, количество, первый, последний, уникальные, конкатенация и режим. Поля атрибутов Дата, Только дата и Сдвиг метки времени можно суммировать только со статистикой: среднее значение, минимум, максимум, количество, первое, последнее, уникальные значения и соединения. Типы статистики СУБД поддерживаются только для входных источников данных базы геоданных, включая многопользовательские базы геоданных, сервисы объектов, облачные хранилища данных и базы геоданных 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}],...]	Указывает поле или поля, содержащие значения атрибутов, которые будут использоваться для расчета указанной статистики. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет. Числовые поля атрибутов могут быть суммированы с помощью любой статистики. Текстовые поля атрибутов могут быть суммированы с помощью статистики: минимум, максимум, количество, первый, последний, уникальные, конкатенация и режим. Поля атрибутов Дата, Только дата и Сдвиг метки времени можно суммировать только со статистикой: среднее значение, минимум, максимум, количество, первое, последнее, уникальные значения и соединения. Типы статистики СУБД поддерживаются только для входных источников данных базы геоданных, включая многопользовательские базы геоданных, сервисы объектов, облачные хранилища данных и базы геоданных 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 (Дополнительный)	Символ или символы, которые будут использоваться для конкатенации значений, когда для параметра `statistics_fields` используется опция `CONCATENATION`. По умолчанию инструмент соединяет значения без разделителей.	String

Пример кода

Пример Statistics (окно 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")

Пример 2 Statistics (автономный скрипт)

Пример вычисления площади полигонов растительности в пределах 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)

Пример 3 Statistics (автономный скрипт)

Следующий автономный скрипт используется для просмотра атрибутивных полей набора данных и построения параметра 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)

Пример 4 Statistics (автономный скрипт)

В следующем скрипте используется 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.

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да