統計サマリー (解析ツール)

サマリー

テーブル内のフィールドの統計サマリーを求めます。

図

統計サマリーツールの図

使用法

出力は、統計演算の結果を含むフィールドで構成されます。
このツールで実行できる統計演算は、合計、平均、最小、最大、範囲、標準偏差、個数、最初、最後、中央値、分散、一意の値、連結、および最頻値です。
ケースフィールド パラメーターが指定されている場合、統計は一意のフィールド値別に計算されます。そのため、出力テーブルには、フィールド値のセットごとに 1 レコードが含まれます。 ケースフィールド パラメーターが指定されていない場合、すべての入力レコードについて統計が計算されます。そのため、出力テーブルには 1 レコードが含まれます。

出力の 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 出力をサポートしていません。
すべての統計計算から NULL 値が除外されます。たとえば、6、4、および NULL 値の平均は 5 ((6+4)/2) です。
レイヤーを使用する場合、統計の計算には現在選択されているフィーチャだけが使用されます。

ラベル	説明	データタイプ
入力テーブル	統計の計算に使用するフィールドを含む入力テーブル。	Table View; Raster Layer
出力テーブル	計算された統計を格納する出力テーブル。	Table
統計フィールド	指定した統計を計算するために使用される属性値を含むフィールド (複数可) を指定します。複数の統計とフィールドの組み合わせを指定できます。 NULL 値はすべての計算から除外されます。数値属性フィールドは、任意の統計を使用して集計されます。テキスト属性フィールドは、最小、最大、個数、最初、最後、一意の値、連結、およびモード統計を使用して集計されます。 Date、Date only、Timestamp offset 属性フィールドは、平均、最小、最大、個数、最初、最後、一意の値、連結の統計を使用して計算されます。 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
ケースフィールド (オプション)	一意の属性値 (または、複数フィールドが指定された場合には属性値の組み合わせ) ごとに、統計を個別に計算するために使用される、入力のフィールド (1 つまたは複数)。	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}],...]	指定した統計を計算するために使用される属性値を含むフィールド (複数可) を指定します。複数の統計とフィールドの組み合わせを指定できます。 NULL 値はすべての計算から除外されます。数値属性フィールドは、任意の統計を使用して集計されます。テキスト属性フィールドは、最小、最大、個数、最初、最後、一意の値、連結、およびモード統計を使用して集計されます。 Date、Date only、Timestamp offset 属性フィールドは、平均、最小、最大、個数、最初、最後、一意の値、連結の統計を使用して計算されます。 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,...] (オプション)	一意の属性値 (または、複数フィールドが指定された場合には属性値の組み合わせ) ごとに、統計を個別に計算するために使用される、入力のフィールド (1 つまたは複数)。	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.

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

統計サマリー (解析ツール)

サマリー

図

使用法

パラメーター

環境

特殊なケース

ライセンス情報

関連トピック