Частота (Инструменты Анализа)

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

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

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

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

Подпись	Объяснение	Тип данных
Входная таблица	Таблица, содержащая поля, для которых будет рассчитана статистика частоты.	Table View; Raster Layer
Выходная таблица	Выходная таблица, в которую будет записана вычисленная частотная статистика.	Table
Поля частоты	Это поле будет использовано для вычисления статистики частоты. Каждая уникальная комбинация значений полей будет включена в выходную таблицу как новая строка.	Field
Поля для суммирования (Дополнительный)	Числовые атрибутивные поля, которые суммируются и добавляются к выходной таблице. Значения суммируются для каждой уникальной комбинации полей частоты. Пустые значения не включаются в этот расчет.	Field

arcpy.analysis.Frequency(in_table, out_table, frequency_fields, {summary_fields})

Имя	Объяснение	Тип данных
in_table	Таблица, содержащая поля, для которых будет рассчитана статистика частоты.	Table View; Raster Layer
out_table	Выходная таблица, в которую будет записана вычисленная частотная статистика.	Table
frequency_fields [frequency_fields,...]	Это поле будет использовано для вычисления статистики частоты. Каждая уникальная комбинация значений полей будет включена в выходную таблицу как новая строка.	Field
summary_fields [summary_fields,...] (Дополнительный)	Числовые атрибутивные поля, которые суммируются и добавляются к выходной таблице. Значения суммируются для каждой уникальной комбинации полей частоты. Пустые значения не включаются в этот расчет.	Field

Пример кода

Пример 1 Frequency (Окно Python)

В следующем скрипте окна Python показано, как используется функция Frequency в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.analysis.Frequency("taxlots",
                         "C:/output/output.gdb/tax_frequency",
                         ["YEARBUILT", "COUNTY"],
                         ["LANDVAL", "BLDGVAL", "TOTALVAL"])

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

В следующем автономном скрипте показано использование функции Frequency.

# Description: Run Frequency on a table

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"

# Set local variables
inTable = "taxlots"
outTable = "C:/output/output.gdb/tax_frequency"
frequencyFields = ["YEARBUILT", "COUNTY"]
summaryFields = ["LANDVAL", "BLDGVAL", "TOTALVAL"]

# Run Frequency
arcpy.analysis.Frequency(inTable, outTable, frequencyFields, summaryFields)

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

Следующий автономный скрипт демонстрирует, как использовать многие функции скриптов геообработки, включая функцию Frequency.

# Description: Break all multipart features into single part features,
#  and generate a report of which features were separated.

# Import system modules
import arcpy

# Create variables for the input and output feature classes
inFeatureClass = "c:/data/gdb.gdb/vegetation"
outFeatureClass = "c:/data/gdb.gdb/vegetation_singlepart"

try:
    # Create list of all fields in inFeatureClass
    fieldNameList = [field.name for field in arcpy.ListFields(inFeatureClass)]

    # Add a field to the input this will be used as a unique identifier
    arcpy.management.AddField(inFeatureClass, "tmpUID", "double")

    # Determine what the name of the Object ID is
    OIDFieldName = arcpy.Describe(inFeatureClass).OIDFieldName

    # Calculate the tmpUID to the OID
    arcpy.management.CalculateField(inFeatureClass, "tmpUID",
                                    "[" + OIDFieldName + "]")

    # Run the tool to create a new fc with only singlepart features
    arcpy.management.MultipartToSinglepart(inFeatureClass, outFeatureClass)

    # Check if there is a different number of features in the output
    #   than there was in the input
    inCount = int(arcpy.management.GetCount(inFeatureClass)[0])
    outCount = int(arcpy.management.GetCount(outFeatureClass)[0])

    if inCount != outCount:
        # If there is a difference, print out the FID of the input
        #   features which were multipart
        arcpy.analysis.Frequency(outFeatureClass,
                                 outFeatureClass + "_freq", "tmpUID")

        # Use a search cursor to go through the table, and print the tmpUID
        print("Multipart features from {0}".format(inFeatureClass))
        for row in arcpy.da.SearchCursor(outFeatureClass + "_freq",
                                         ["tmpUID"], "FREQUENCY > 1"):
            print(int(row[0]))
    else:
        print("No multipart features were found")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Параметры среды

Выходное ключевое слово конфигурации, Текущая рабочая область, Временная рабочая область

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