フィーチャクラス内のフィーチャに基づいて、そのフィーチャクラスの 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 (オプション) | 登録されていないフィーチャクラスに範囲を格納するかどうかを指定します。 このパラメーターは、入力フィーチャクラスがデータベースまたはエンタープライズ ジオデータベースの未登録の空間テーブルである場合のみサポートされます。 入力フィーチャクラスが頻繁に更新される場合は、再計算された範囲値を格納しないことを選択できます。 範囲の格納を選択した場合、フィーチャクラスがマップに追加されるときに、範囲は再計算されません。
| Boolean |
| 名前 | 説明 | データ タイプ |
| out_features | 更新されたフィーチャクラス。 | Feature Class |
次の Python ウィンドウ スクリプトは、イミディエイト モードで RecalculateFeatureClassExtent 関数を使用する方法を示しています。 これにより、フィーチャクラスの XY、M、および Z 範囲が再計算されます。
import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.management.RecalculateFeatureClassExtent(feature_class)