フィーチャクラスの範囲を再計算 (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

Python

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)

環境

現在のワークスペース, テンポラリ ワークスペース