フィーチャクラスの範囲を再計算 (Recalculate Feature Class Extent) (データ管理)

サマリー

フィーチャクラス内のフィーチャに基づいて、そのフィーチャクラスの XY、Z、および M 範囲プロパティを再計算します。

1 つのフィーチャクラス内には、すべての座標に基づく空間範囲があります。 この空間範囲を使用すると、フィーチャクラスをマップに追加して、すべてのフィーチャの中心を再設定し、表示することができます。 フィーチャクラスがマップに追加されるごとに、そのフィーチャクラスに含まれるすべてのフィーチャが検証されるのではなく (この処理には長時間を要することがある)、認識されている最新の空間範囲を含む範囲プロパティがフィーチャクラスに割り当てられます。 ただし、フィーチャクラス内のフィーチャを編集した場合に、この範囲プロパティが常に更新されるとは限りません。 つまり、範囲プロパティの値には、各フィーチャの実際の空間範囲が含まれていない場合があります。 [フィーチャクラスの範囲を再計算 (Recalculate Feature Class Extent)] ツールを実行すると、すべてのフィーチャが読み取られ、範囲プロパティが更新されます。

注意:

XY、Z、および M 範囲は、空間参照ドメインと同じではありません。空間参照に含まれる XY、Z、および M ドメインには、フィーチャクラスに格納できる座標値の有効な範囲が定義されています。フィーチャクラスの範囲は、そのフィーチャクラス内にある座標値の実際の範囲を意味します。これらの範囲は、ドメインよりも大きくすることができません。

使用法

  • このツールは、ジオデータベース フィーチャクラスまたはシェープファイル (ポイント、マルチポイント、ライン、ポリゴン) を更新します。

  • エンタープライズ ジオデータベースでは、範囲はフィーチャクラスのスキーマのプロパティとして使用されるため、排他スキーマ ロックを実行する必要があります。

  • このツールでエンタープライズ ジオデータベース フィーチャクラスを入力値として使用する場合は、どのバージョンでも、そのフィーチャクラスに含まれるフィーチャに基づいて範囲が算出されます。 データベースが圧縮された後でこのツールを実行した場合を除いて、範囲の拡張と縮小はできません。

  • [範囲の格納] パラメーターは、データベースまたはエンタープライズ ジオデータベースの未登録の空間テーブルでサポートされます。 このパラメーターがオンの場合、基になるテーブルのシェープ カラム メタデータに新しい範囲が格納されます。 このパラメーターがオフの場合、範囲が再計算されますが、値は格納されません。この設定は、基になるデータが頻繁に更新される場合に便利です。

  • フィーチャクラスを編集する権限がない場合、このツールは正常に実行されません。

  • フィーチャクラスの範囲の再計算を取り消すことはできません。

  • 範囲の値は、arcpy.Describe 関数の extent プロパティによって返されます。

  • 注意:

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

パラメーター

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

更新するシェープファイルまたはジオデータベース フィーチャクラス。

Feature Layer
範囲の格納
(オプション)

登録されていないフィーチャクラスに範囲を格納するかどうかを指定します。 このパラメーターは、入力フィーチャクラスがデータベースまたはエンタープライズ ジオデータベースの未登録の空間テーブルである場合のみ有効になります。

入力フィーチャクラスが頻繁に更新される場合は、再計算された範囲値を格納しないことを選択できます。 範囲の格納を選択した場合、フィーチャクラスがマップに追加されるときに、範囲は再計算されません。

  • オン - 範囲を入力フィーチャクラスに格納します。
  • オフ - 範囲を入力フィーチャクラスに格納しません。 これがデフォルトです。
Boolean

派生した出力

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

更新されたフィーチャクラス。

Feature Class

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})
名前説明データ タイプ
in_features

更新するシェープファイルまたはジオデータベース フィーチャクラス。

Feature Layer
store_extent
(オプション)

登録されていないフィーチャクラスに範囲を格納するかどうかを指定します。 このパラメーターは、入力フィーチャクラスがデータベースまたはエンタープライズ ジオデータベースの未登録の空間テーブルである場合のみサポートされます。

入力フィーチャクラスが頻繁に更新される場合は、再計算された範囲値を格納しないことを選択できます。 範囲の格納を選択した場合、フィーチャクラスがマップに追加されるときに、範囲は再計算されません。

  • STORE_EXTENT範囲を入力フィーチャクラスに格納します。
  • DO_NOT_STORE_EXTENT範囲を入力フィーチャクラスに格納しません。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_features

更新されたフィーチャクラス。

Feature Class

コードのサンプル

RecalculateFeatureClassExtent の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで RecalculateFeatureClassExtent 関数を使用する方法を示しています。 これにより、フィーチャクラスの XY、M、および Z 範囲が再計算されます。

import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.management.RecalculateFeatureClassExtent(feature_class)