頻度 (Frequency) (解析)

サマリー

テーブルと一連のフィールドを読み取り、一意のフィールド値と一意のフィールド値ごとの発生数を含む新しいテーブルを作成します。

使用法

  • 出力テーブルには、フィールド Frequency と、指定した頻度フィールドおよび集計フィールドが含まれます。

  • 出力テーブルには、指定した頻度フィールドの一意の各組み合わせについての頻度が含まれます。

  • 集計フィールドが指定されている場合、頻度の計算結果の一意の属性値は、各集計フィールドの数値属性によって集計されます。

  • レイヤーを使用する場合、計算には現在選択されているフィーチャだけが使用されます。

パラメーター

ラベル説明データ タイプ
入力テーブル

頻度統計の計算に使用するフィールドを含むテーブル。

Table View; Raster Layer
出力テーブル

頻度統計を格納する出力テーブル。

Table
頻度フィールド

頻度統計の計算に使用するフィールド。 フィールド値の一意の各組み合わせは、出力テーブルに新しい行として追加されます。

Field
サマリー フィールド
(オプション)

集計して出力テーブルに追加するための属性フィールド。 値は、頻度フィールドの一意の各組み合わせごとに集計されます。 NULL 値はこの計算から除外されます。

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,...]
(オプション)

集計して出力テーブルに追加するための属性フィールド。 値は、頻度フィールドの一意の各組み合わせごとに集計されます。 NULL 値はこの計算から除外されます。

Field

コードのサンプル

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"])
Frequency の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、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"]
 
# Execute Frequency
arcpy.analysis.Frequency(inTable, outTable, frequencyFields, summaryFields)
Frequency の例 3 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、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)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック