フィールド演算 (Calculate Field) ツールの使用

[フィールド演算 (Calculate Field)] ツールは、[データ管理ツール] ツールボックスの [フィールド] ツールセットにあります。これは、属性テーブルのフィールド ショートカット メニューから [フィールド演算 (Calculate Field)] コマンドをクリックしたときに開くツールと同じです。フィールド演算を実行するときには、どのようなタイプのデータを使用しているのか、およびそのデータを将来どのような場面で使用するのかを理解しておくことが重要です。計算式で使用する構文は、データ ソースおよびスクリプト言語によって異なります。

[フィールド演算 (Calaulate Field)] ツールの使用に関する重要なヒントとベスト プラクティスを以下に列挙します。

フィールド演算 (Calculate Field) ツールの使用に関するヒントとベスト プラクティス

フィーチャクラス、フィーチャ レイヤー、またはラスターのフィールドの値を計算します。

式は、VBScript または標準 Python 形式を使用して作成できます。式に使用する文字列の書式スタイルは、環境 (タイプ) に適合している必要があります。

type、extent、centroid、firstPoint、lastPoint、area、length、isMultipart、partCount (たとえば、!shape.area!) などの Geometry オブジェクトのプロパティを使用して、Python 式を作成することができます。

Python 式では、ジオメトリの area プロパティや length プロパティに面積や長さの単位を指定して、値を異なる計測単位 (!shape.length@kilometers! など) に変換できます。データが地理座標系に格納されており、距離単位 (たとえば、マイル) が指定されている場合、長さは測地線アルゴリズムを使用して計算されます。地理データで面積単位を使用すると、グローブ全体で度 (10 進) が一定でないため、正確な結果になりません。

!shape.area@acres!

• 面積計測単位のキーワード:
  • ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | SQUAREMAPUNITS | UNKNOWN
• 長さ計測単位のキーワード:
  • CENTIMETERS | DECIMALDEGREES | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | POINTS | UNKNOWN | YARDS

[フィーチャ レイヤーの作成 (Make Feature Layer)] や [属性検索 (Select Layer By Attribute)] でクエリから作成されたフィーチャなど、一連の選択されているフィーチャに対してこのツールを使用すると、選択されているレコードのみが更新されます。

1 回の操作につき、1 つのフィールドにのみ演算を適用できます。

VBScript の場合、フィールドは常に角括弧 ([ ]) で囲みます。

Python の演算の場合、フィールド名は感嘆符で囲まれている必要があります (!fieldname!)。

テキスト フィールドまたは文字フィールドの文字列の演算を行う場合、ダイアログ ボックスでは、文字列を二重引用符で囲む必要があり (「"string"」)、スクリプトでは、二重引用符で囲まれた文字列をさらに一重引用符で囲む必要があります (「'"string"'」)。

このツールは、文字項目を更新するために使用することもできます。文字列を使用する式は、一重引用符で囲む必要があります (例: [CHARITEM] = 'NEW STRING')。ただし、文字列の一部に一重引用符が使用されている場合は、その文字列を二重引用符で囲みます (例: [CHARITEM] = "TYPE'A'")。

数値を指定するフィールドの演算を行うには、[条件式] パラメーターに数値を入力します。値を引用符で囲む必要はありません。

arcgis.rand() 関数は [フィールド演算 (Calculate Field)] ツールにサポートされていますが、式タイプは Python でなければなりません。arcgis.rand() 関数は ArcGIS ツール用に作成されたものであり、Python Rand() 関数と混同しないようにしてください。

式とコード ブロックは接続されています。コード ブロックの結果が式に渡される必要があるため、コード ブロックが式に関連付けられている必要もあります。

[コード ブロック] パラメーターでは、Python の math モジュールおよび形式を使用できます。追加のモジュールをインポートすることもできます。math モジュールは、数論的関数と表現関数、べき関数と対数関数、三角関数、角度変換関数、双曲線関数、および数学定数を提供します。math モジュールの詳細については、Python のヘルプをご参照ください。

以前のバージョンの ArcGIS で保存された VB の *.cal ファイルをそのまま、または最小限の修正を加えて使用できます。ArcObjects を使用する以前のリリースの VBA コードがある場合は、計算を修正する必要があります。

結合したデータの演算を行う際、結合された列を直接演算することはできません。元のテーブルの列の演算を直接行うことはできます。結合されたデータの演算を行うには、まず、結合されたテーブルまたはレイヤーをマップに追加する必要があります。そうすると、このデータの演算を単体で行うことができるようになります。これらの変更は結合された列に反映されます。

ArcGIS Engine Runtime または ArcGIS Server でフィールド演算を実行する場合、式のタイプは Python でなければなりません。ArcGIS Server に公開されるモデルにツールが組み込まれている場合は、式のタイプとして Python のみを使用します。

フィールド演算 (Calculate Field) ツールを使用したコード ブロックの例

CalculateField (フィールド演算) の例: 重心の演算

CalculateField を使用して、新しいフィールドに重心の値を割り当てます。

# Name: CalculateField_Centroids.py
# Description: Use CalculateField to assign centroid values to new fields
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "parcels"
fieldName1 = "xCentroid"
fieldName2 = "yCentroid"
fieldPrecision = 18
fieldScale = 11
 
# Add fields
arcpy.AddField_management(inFeatures, fieldName1, "DOUBLE", 
                          fieldPrecision, fieldScale)
arcpy.AddField_management(inFeatures, fieldName2, "DOUBLE", 
                          fieldPrecision, fieldScale)
 
# Calculate centroid
arcpy.CalculateField_management(inFeatures, fieldName1, 
                                "!SHAPE.CENTROID.X!",
                                "PYTHON_9.3")
arcpy.CalculateField_management(inFeatures, fieldName2, 
                                "!SHAPE.CENTROID.Y!",
                                "PYTHON_9.3")

CalculateField (フィールド演算) の例: 範囲の演算

CalculateField とコード ブロックを使用して、範囲に基づいて値の演算を行います。

# Name: CalculateField_Ranges.py
# Description: Use CalculateField with a codeblock to calculate values
#  based on ranges
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inTable = "parcels"
fieldName = "areaclass"
expression = "getClass(float(!SHAPE.area!))"
codeblock = """def getClass(area):
    if area <= 1000:
        return 1
    if area > 1000 and area <= 10000:
        return 2
    else:
        return 3"""
 
# Execute AddField
arcpy.AddField_management(inTable, fieldName, "SHORT")
 
# Execute CalculateField 
arcpy.CalculateField_management(inTable, fieldName, expression, "PYTHON_9.3", 
                                codeblock)

CalculateField (フィールド演算) の例: ランダム値の演算

CalculateField を使用して、新しいフィールドにランダム値を割り当てます。

# Name: CalculateField_Random.py
# Description: Use CalculateField to assign random values to a new field
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
  
# Set local variables
inFeatures = "parcels"
fieldName = "RndValue"
expression = "arcgis.rand('Integer 0 10')"
 
# Execute AddField
arcpy.AddField_management(inFeatures, fieldName, "LONG")
 
# Execute CalculateField 
arcpy.CalculateField_management(inFeatures, fieldName, expression, "PYTHON_9.3")