ジオメトリ属性の計算 (Calculate Geometry Attributes) (データ管理)

サマリー

フィーチャの属性フィールドに、空間特性またはジオメトリック特性および各フィーチャの位置 (長さや面積、X、Y、Z、M 座標など) を示す情報を追加します。

新しい属性フィールドに複数のジオメトリ属性を追加する同類のツールには、[ジオメトリ属性の追加 (Add Geometry Attributes)] ツールがあります。

使用法

    注意:

    このツールを実行すると、入力データが変更されます。詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。

  • 座標系が指定されている場合は、[長さの単位] および [面積単位] パラメーターで違う単位が選択されていない限り、長さと面積の計算はその座標系の単位となります。

  • 入力フィーチャに選択セットがある場合、選択されたフィーチャのみで、追加フィールドの値が計算され、他のすべてのフィーチャでは既存の値が維持されます。

  • このツールは、ポイント、マルチポイント、ポリライン、ポリゴンのフィーチャクラスに対して機能します。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

ジオメトリの計算により更新されるフィールドを持つフィーチャ レイヤー。

Feature Layer
ジオメトリ属性

選択したジオメトリ プロパティが計算されるフィールドを指定します。

既存のフィールドを選択するか、新しいフィールド名を指定できます。 新しいフィールド名を指定する場合は、フィールドに書き込まれる値のタイプによってフィールド タイプが決まります。

  • 個数属性は long integer タイプのフィールドに書き込まれます。
  • 面積、長さ、および X、Y、Z、M 座標属性は double タイプのフィールドに書き込まれます。
  • 度/分/秒 (DMS) や MGRS などの座標表記はテキスト フィールドに書き込まれます。

  • AREA各ポリゴン フィーチャの面積。
  • AREA_GEODESIC各ポリゴン フィーチャの形状保持の測地線面積。
  • CENTROID_X各フィーチャの重心の X 座標。
  • CENTROID_Y各フィーチャの重心の Y 座標。
  • CENTROID_Z各フィーチャの重心の Z 座標。
  • CENTROID_M各フィーチャの重心の M 座標。
  • INSIDE_X各フィーチャ内部またはフィーチャ上の中心点の X 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_Y各フィーチャ内部またはフィーチャ上の中心点の Y 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_Z各フィーチャ内部またはフィーチャ上の中心点の Z 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_M各フィーチャ内部またはフィーチャ上の中心点の M 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • CURVE_COUNT各フィーチャの曲線の数。 曲線には、楕円弧、円弧、ベジェ曲線が含まれます。
  • HOLE_COUNT各ポリゴン フィーチャ内の内部ホールの数。
  • EXTENT_MIN_X各フィーチャの範囲の X 座標の最小値。
  • EXTENT_MIN_Y各フィーチャの範囲の Y 座標の最小値。
  • EXTENT_MIN_Z各フィーチャの範囲の Z 座標の最小値。
  • EXTENT_MAX_X各フィーチャの範囲の X 座標の最大値。
  • EXTENT_MAX_Y各フィーチャの範囲の Y 座標の最大値。
  • EXTENT_MAX_Z各フィーチャの範囲の Z 座標の最大値。
  • LENGTH各ライン フィーチャの長さ。
  • LENGTH_GEODESIC各ライン フィーチャの形状保持の測地線の長さ。
  • LENGTH_3D各ライン フィーチャの 3D 長さ。
  • LINE_BEARING各ライン フィーチャの始点から終点までの方位。 値は 0 ~ 360 です。0 は北、90 は東、180 は南、270 は西を意味します。
  • LINE_START_X各ライン フィーチャの始点の X 座標。
  • LINE_START_Y各ライン フィーチャの始点の Y 座標。
  • LINE_START_Z各ライン フィーチャの始点の Z 座標。
  • LINE_START_M各ライン フィーチャの始点の M 座標。
  • LINE_END_X各ライン フィーチャの終点の X 座標。
  • LINE_END_Y各ライン フィーチャの終点の Y 座標。
  • LINE_END_Z各ライン フィーチャの終点の Z 座標。
  • LINE_END_M各ライン フィーチャの終点の M 座標。
  • PART_COUNT各フィーチャを構成するパート数。
  • PERIMETER_LENGTH各ポリゴン フィーチャの周囲または境界線の長さ。
  • PERIMETER_LENGTH_GEODESIC各ポリゴン フィーチャの周囲または境界線の形状保持の測地線の長さ。
  • POINT_COUNT各フィーチャを構成するポイントまたは頂点の数。
  • POINT_X各ポイント フィーチャの X 座標。
  • POINT_Y各ポイント フィーチャの Y 座標。
  • POINT_Z各ポイント フィーチャの Z 座標。
  • POINT_M各ポイント フィーチャの M 座標。
  • POINT_COORD_NOTATION指定した座標表記として書式設定された各ポイント フィーチャの X、Y 座標。
Value Table
長さの単位
(オプション)

長さの計算に使用する単位を指定します。

  • フィート (米国)長さの単位はフィート (米国)。
  • メートル長さの単位はメートル。
  • キロメートル長さの単位はキロメートル。
  • マイル (米国)長さの単位はマイル (米国)。
  • 海里 (米国)長さの単位は海里 (米国)。
  • ヤード (米国)長さの単位はヤード (米国)。
String
面積単位
(オプション)

面積の計算に使用する単位を指定します。

  • エーカー面積単位はエーカー。
  • ヘクタール面積単位はヘクタール。
  • 平方マイル (米国)面積単位は平方マイル (米国)。
  • 平方キロメートル面積単位は平方キロメートル。
  • 平方メートル面積単位は平方メートル。
  • 平方フィート (米国)面積単位は平方フィート (米国)。
  • 平方ヤード (米国)面積単位は平方ヤード (米国)。
  • 平方海里 (米国)面積単位は平方海里 (米国)。
String
座標系
(オプション)

座標、長さ、および面積を計算する座標系。 デフォルトでは、入力フィーチャの座標系が使用されます。

座標ベースのジオメトリ プロパティの場合、この座標系は座標形式が入力と同じ場合のみ適用されます。同じでない場合は、地理座標系の WGS84 が使用されます。

Coordinate System
座標形式
(オプション)

X、Y 座標が計算される座標形式を指定します。 デフォルトでは、入力フィーチャの空間参照単位と一致する座標形式が使用されます。

度分秒、度分 (10 進) など、いくつかの座標形式は、テキスト フィールドで実行するには計算が必要です。

  • 入力と同様入力フィーチャの空間参照単位が座標形式の設定に使用されます。 これがデフォルトです。
  • 度 (10 進)度 (10進)。
  • 度分秒 (DDD° MM' SSS.ss" <N|S|E|W>)度分秒と、最後に基本方向コンポーネント (DDD° MM' SSS.ss" <N|S|E|W>)。
  • 度分秒 (<N|S|E|W> DDD° MM' SSS.ss")度分秒と、最初に基本方向コンポーネント (<N|S|E|W> DDD° MM' SSS.ss")。
  • 度分秒 (<+|-> DDD° MM' SSS.ss")度分秒と、最初に正または負の方向コンポーネント (<+|-> DDD° MM' SSS.ss")。
  • 度分秒 (<+|-> DDD.MMSSSss)度分秒が 1 つの値に圧縮され、最初に正または負の方向コンポーネント (<+|-> DDD.MMSSSss)。
  • 度分 (10 進) (DDD° MM.mmm' <N|S|E|W>)度分 (10 進) と、最後に基本方向コンポーネント (DDD° MM.mmm' <N|S|E|W>)。
  • 度分 (10 進) (<N|S|E|W> DDD° MM.mmm')度分 (10 進) と、最初に基本方向コンポーネント (<N|S|E|W> DDD° MM.mmm')。
  • 度分 (10 進) (<+|-> DDD° MM.mmm')度分 (10 進) と、最初に正または負の方向コンポーネント (<+|-> DDD° MM.mmm')。
  • GARS (Global Area Reference System)GARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。
  • GEOREF (World Geographic ReferenceSystem)GEOREF (World Geographic Reference System) は、緯度と経度の測地系に基づきますが、より単純で柔軟な表記を使用します。
  • MGRS (Military Grid Reference System)Military Grid Reference System。
  • USNG (United States National Grid)United States National Grid。
  • UTM (ユニバーサル横メルカトル)ユニバーサル横メルカトル図法。
  • UTM (スペースなし)ユニバーサル横メルカトル図法 (スペースなし)。
String

派生した出力

ラベル説明データ タイプ
更新されたフィーチャ

更新された入力フィーチャ。

Feature Layer

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})
名前説明データ タイプ
in_features

ジオメトリの計算により更新されるフィールドを持つフィーチャ レイヤー。

Feature Layer
geometry_property
[[Field, Property],...]

選択したジオメトリ プロパティが計算されるフィールドを指定します。

既存のフィールドを選択するか、新しいフィールド名を指定できます。 新しいフィールド名を指定する場合は、フィールドに書き込まれる値のタイプによってフィールド タイプが決まります。

  • 個数属性は long integer タイプのフィールドに書き込まれます。
  • 面積、長さ、および X、Y、Z、M 座標属性は double タイプのフィールドに書き込まれます。
  • 度/分/秒 (DMS) や MGRS などの座標表記はテキスト フィールドに書き込まれます。

  • AREA各ポリゴン フィーチャの面積。
  • AREA_GEODESIC各ポリゴン フィーチャの形状保持の測地線面積。
  • CENTROID_X各フィーチャの重心の X 座標。
  • CENTROID_Y各フィーチャの重心の Y 座標。
  • CENTROID_Z各フィーチャの重心の Z 座標。
  • CENTROID_M各フィーチャの重心の M 座標。
  • INSIDE_X各フィーチャ内部またはフィーチャ上の中心点の X 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_Y各フィーチャ内部またはフィーチャ上の中心点の Y 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_Z各フィーチャ内部またはフィーチャ上の中心点の Z 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • INSIDE_M各フィーチャ内部またはフィーチャ上の中心点の M 座標。 重心がフィーチャ内部にある場合、この点は重心と同じです。内部にない場合は、内部ラベル ポイントです。
  • CURVE_COUNT各フィーチャの曲線の数。 曲線には、楕円弧、円弧、ベジェ曲線が含まれます。
  • HOLE_COUNT各ポリゴン フィーチャ内の内部ホールの数。
  • EXTENT_MIN_X各フィーチャの範囲の X 座標の最小値。
  • EXTENT_MIN_Y各フィーチャの範囲の Y 座標の最小値。
  • EXTENT_MIN_Z各フィーチャの範囲の Z 座標の最小値。
  • EXTENT_MAX_X各フィーチャの範囲の X 座標の最大値。
  • EXTENT_MAX_Y各フィーチャの範囲の Y 座標の最大値。
  • EXTENT_MAX_Z各フィーチャの範囲の Z 座標の最大値。
  • LENGTH各ライン フィーチャの長さ。
  • LENGTH_GEODESIC各ライン フィーチャの形状保持の測地線の長さ。
  • LENGTH_3D各ライン フィーチャの 3D 長さ。
  • LINE_BEARING各ライン フィーチャの始点から終点までの方位。 値は 0 ~ 360 です。0 は北、90 は東、180 は南、270 は西を意味します。
  • LINE_START_X各ライン フィーチャの始点の X 座標。
  • LINE_START_Y各ライン フィーチャの始点の Y 座標。
  • LINE_START_Z各ライン フィーチャの始点の Z 座標。
  • LINE_START_M各ライン フィーチャの始点の M 座標。
  • LINE_END_X各ライン フィーチャの終点の X 座標。
  • LINE_END_Y各ライン フィーチャの終点の Y 座標。
  • LINE_END_Z各ライン フィーチャの終点の Z 座標。
  • LINE_END_M各ライン フィーチャの終点の M 座標。
  • PART_COUNT各フィーチャを構成するパート数。
  • PERIMETER_LENGTH各ポリゴン フィーチャの周囲または境界線の長さ。
  • PERIMETER_LENGTH_GEODESIC各ポリゴン フィーチャの周囲または境界線の形状保持の測地線の長さ。
  • POINT_COUNT各フィーチャを構成するポイントまたは頂点の数。
  • POINT_X各ポイント フィーチャの X 座標。
  • POINT_Y各ポイント フィーチャの Y 座標。
  • POINT_Z各ポイント フィーチャの Z 座標。
  • POINT_M各ポイント フィーチャの M 座標。
  • POINT_COORD_NOTATION指定した座標表記として書式設定された各ポイント フィーチャの X、Y 座標。
Value Table
length_unit
(オプション)

長さの計算に使用する単位を指定します。

  • FEET_US長さの単位はフィート (米国)。
  • METERS長さの単位はメートル。
  • KILOMETERS長さの単位はキロメートル。
  • MILES_US長さの単位はマイル (米国)。
  • NAUTICAL_MILES長さの単位は海里 (米国)。
  • YARDS長さの単位はヤード (米国)。
String
area_unit
(オプション)

面積の計算に使用する単位を指定します。

  • ACRES面積単位はエーカー。
  • HECTARES面積単位はヘクタール。
  • SQUARE_MILES_US面積単位は平方マイル (米国)。
  • SQUARE_KILOMETERS面積単位は平方キロメートル。
  • SQUARE_METERS面積単位は平方メートル。
  • SQUARE_FEET_US面積単位は平方フィート (米国)。
  • SQUARE_YARDS面積単位は平方ヤード (米国)。
  • SQUARE_NAUTICAL_MILES面積単位は平方海里 (米国)。
String
coordinate_system
(オプション)

座標、長さ、および面積を計算する座標系。 デフォルトでは、入力フィーチャの座標系が使用されます。

座標ベースのジオメトリ プロパティの場合、この座標系は座標形式が入力と同じ場合のみ適用されます。同じでない場合は、地理座標系の WGS84 が使用されます。

Coordinate System
coordinate_format
(オプション)

X、Y 座標が計算される座標形式を指定します。 デフォルトでは、入力フィーチャの空間参照単位と一致する座標形式が使用されます。

度分秒、度分 (10 進) など、いくつかの座標形式は、テキスト フィールドで実行するには計算が必要です。

  • SAME_AS_INPUT入力フィーチャの空間参照単位が座標形式の設定に使用されます。 これがデフォルトです。
  • DD度 (10進)。
  • DMS_DIR_LAST度分秒と、最後に基本方向コンポーネント (DDD° MM' SSS.ss" <N|S|E|W>)。
  • DMS_DIR_FIRST度分秒と、最初に基本方向コンポーネント (<N|S|E|W> DDD° MM' SSS.ss")。
  • DMS_POS_NEG度分秒と、最初に正または負の方向コンポーネント (<+|-> DDD° MM' SSS.ss")。
  • DMS_PACKED度分秒が 1 つの値に圧縮され、最初に正または負の方向コンポーネント (<+|-> DDD.MMSSSss)。
  • DDM_DIR_LAST度分 (10 進) と、最後に基本方向コンポーネント (DDD° MM.mmm' <N|S|E|W>)。
  • DDM_DIR_FIRST度分 (10 進) と、最初に基本方向コンポーネント (<N|S|E|W> DDD° MM.mmm')。
  • DDM_POS_NEG度分 (10 進) と、最初に正または負の方向コンポーネント (<+|-> DDD° MM.mmm')。
  • GARSGARS (Global Area Reference System) は、緯度と経度に基づき、世界をセルに分割および細分化します。
  • GEOREFGEOREF (World Geographic Reference System) は、緯度と経度の測地系に基づきますが、より単純で柔軟な表記を使用します。
  • MGRSMilitary Grid Reference System。
  • USNGUnited States National Grid。
  • UTMユニバーサル横メルカトル図法。
  • UTMNSユニバーサル横メルカトル図法 (スペースなし)。
String

派生した出力

名前説明データ タイプ
updated_features

更新された入力フィーチャ。

Feature Layer

コードのサンプル

CalculateGeometryAttributes の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、CalculateGeometryAttributes 関数の使用方法を示しています。

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.CalculateGeometryAttributes_management("roads", [["Length_mi", "LENGTH"], ["Stops", "POINT_COUNT"]], "MILES_US")
CalculateGeometryAttributes example の例 (スタンドアロン スクリプト)

各フィーチャの範囲矩形を取得します。

# Name: ExtentCreation.py

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.env.outputCoordinateSystem = arcpy.Describe("roads").spatialReference

# Set local variables
in_features = "roads"

# Generate the extent coordinates using CalculateGeometry
arcpy.CalculateGeometryAttributes_management(in_features, [["Left", "EXTENT_MIN_X"],
                                                           ["Bottom", "EXTENT_MIN_Y"],
                                                           ["Right", "EXTENT_MAX_X"],
                                                           ["Top", "EXTENT_MAX_Y"]])

ライセンス情報

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

関連トピック