データの定義—ヘルプ

プロパティセットの操作

ジオプロセシングツールは、ジオデータベースフィーチャクラス、シェープファイル、ラスター、テーブル、トポロジ、ネットワークなど、あらゆる種類のデータを操作します。個々のデータには特定のプロパティが設定されており、スクリプトの流れを制御するために使用されたり、ツールのパラメーターとして使用されたりします。たとえば、[インターセクト (Intersect)] ツールの出力フィーチャタイプは、インターセクトされるデータの形状タイプ (ポイント、ライン、またはポリゴン) によって異なります。[インターセクト (Intersect)] ツールが入力データセットのリストのスクリプトで実行される場合は、正しい出力形状タイプを設定できるように入力データセットの形状タイプを判別できることが必要です。Describe 関数を使用して、入力データセットすべての形状タイプを判別できます。

Describe 関数を使用すれば、データセットのプロパティを判別して処理方法の決定に使用できます。たとえば、次の例に示すスクリプトでは、Describe 関数を使用して入力データの形状タイプ (ポリライン、ポリゴン、ポイントなど) を評価し、適切なジオプロセシングツールを判別しています。

import arcpy

inFC = arcpy.GetParameterAsText(0)
outFC = arcpy.GetParameterAsText(1)

# Describe a feature class
#
desc = arcpy.Describe(inFC)

# Get the shape type (Polygon, Polyline) of the feature class
#
type = desc.shapeType

# If the shapeType is Polygon convert the data to polylines 
#  using the FeatureToLine tool, otherwise just copy the 
#  data using the CopyFeatures tool.
#
if type == "Polygon":
    arcpy.FeatureToLine_management(inFC, outFC)
else:
    arcpy.CopyFeatures_management(inFC, outFC)

Describe 関数は、データタイプ、フィールド、インデックスなどの複数のプロパティを含む Describe オブジェクトを返します。このプロパティは動的です。つまり、Describe 対象のデータタイプに応じて、別々の Describe プロパティが使用可能になります。

Describe プロパティは、一連のプロパティグループに編成されています。個々のデータセットは、これらのうち少なくとも 1 つのグループのプロパティを取得します。たとえば、ジオデータベースフィーチャクラスの Describe を実行する場合は、GDB FeatureClass、FeatureClass、Table、および Dataset の各プロパティグループからのプロパティにアクセスできます。データタイプにかかわらず、すべてのデータは常に汎用の Describe オブジェクトプロパティを取得します。

プロパティセットの操作

一部のプロパティはプロパティセットのメンバーです。たとえば、カバレッジの許容値やワークスペースの接続プロパティは、プロパティセットとして返されます。プロパティセットには名前付きのプロパティがあり、これらのプロパティはプロパティセットから呼び出すことができます。次の例では、カバレッジの許容値 (fuzzy、dangle、ticMatch、edit、nodeSnap、weed、grain、および snap) が標準出力に書き込まれます。

import arcpy

# Describe a coverage feature class
#
desc = arcpy.Describe("D:/St_Johns/covs/freshwater")

# Create a property set of coverage tolerances
#
covTols = desc.tolerances

# Print each coverage tolerance
#
print(covTols.fuzzy)
print(covTols.dangle)
print(covTols.ticMatch)
print(covTols.edit)
print(covTols.nodeSnap)
print(covTols.weed)
print(covTols.grain)
print(covTols.snap)

プロパティセットは一般に、Describe 対象のオブジェクトのプロパティが変化する場合に使用されます。エンタープライズジオデータベースワークスペースの接続プロパティ (サーバー、インスタンス、データベース、ユーザー、およびバージョン) は使用される ArcSDE データベースのタイプによって異なるので、定義済みの値のセットを持たないプロパティセットに適しています。

プロパティ セットの操作

関連トピック

プロパティセットの操作