CityEngine ルールからフィーチャを生成 (3D Analyst ツール)

サマリー

ArcGIS CityEngine で作成するルールを使用して、既存の 2D および 3D 入力フィーチャから 3D ジオメトリーを生成します。

使用法

• 入力フィーチャは、ポイント、ポリゴン、またはマルチパッチである必要があります。 CityEngine のルール パッケージ ファイル (.rpk) ファイル内にある @StartRule は、対象の入力フィーチャのタイプ (ポイントの場合は @InPoint アノテーション、ポリゴンの場合は @InPolygon、マルチパッチ フィーチャの場合は @InMesh) を指定する必要があります。 いずれかに @StartRule の注釈が付いていない場合、フィーチャ タイプはポリゴンと見なされます。 予期しないジオメトリー タイプが入力されると、エラーが返されます。

• 入力フィーチャは、プロシージャル シンボルで表示された フィーチャ レイヤーを指定できます。 CityEngine のルールは通常、入力シェープから出力 3D モデルを生成する方法を制御する多くのプロパティ (CityEngine では attrs と呼ばれます) を定義します。 たとえば、建物構造を生成するルールは、BuildingHeight に double タイプの attr、FloorCount に整数タイプの attr を持つ場合があります。 入力フィーチャクラスに、CityEngine のルール プロパティと同じ名前とデータ タイプを持つ属性フィールドがある場合、出力モデルの生成には、その属性フィールドの値が自動的に使用されます。 この CityEngine のルール プロパティと属性フィールドの自動照合は、デフォルト フィールド マッピングと呼ばれます。

  入力フィーチャ レイヤーが 単一シンボル でシンボル表示され、そのシンボルに入力ルール パッケージと同じルール パッケージを参照するプロシージャル シンボル レイヤーが含まれる場合、ツールで出力を作成する際、プロシージャル シンボル レイヤーで構成されたオーバーライドを適用します。 これにより、プロシージャル シンボル レイヤーを使用して、マッピングされたフィールド名がルール パッケージの属性名と正確に対応しない カスタム フィールド マッピング を構成したり、単一のカスタム値を使用してルール パッケージ属性をオーバーライドできるようになります。 詳細については、属性値を使用したシンボル設定 をご参照ください。

• ルール パッケージ パラメーター値は CityEngine .rpk ファイルです。 これは、コンパイルされた CityEngine ルールとこのルールが使用する関連アセットが含まれている圧縮ファイルです。 リーフ シェープのエクスポート パラメーターは、入力ルール パッケージが、次の CGA アノテーションを含むことでこの操作をサポートしていることを宣言している場合のみ使用可能です: @StartRule @Out (granularity=separatedShapes)。

• リーフ シェープのエクスポート パラメーターを使用してリーフ シェープを生成すると、一連の標準フィーチャクラスがプライマリー出力マルチパッチ フィーチャクラスと同じ場所に次の命名規則で作成されます: <outputFC_Points>、<outputFC_MPoints>、<outputFC_Lines>。 すべての出力フィーチャクラスには、出力の生成元になった入力フィーチャの ObjectID を参照する OriginalOID 属性フィールドが含まれています。 OriginalOID フィールドを使用すると、出力フィーチャクラスを入力フィーチャクラスと結合できます。 レポートを含める パラメーターを使用してレポートを生成する場合、出力フィーチャクラスは各レポートの属性も取得します。

• 各出力フィーチャの生成元になった入力フィーチャの ObjectID を含めるために、OriginalOID フィールドが出力フィーチャクラスに追加されます。 入力フィーチャクラスに OriginalOID という名前のフィールドがすでに存在する場合は、新しいフィールド名に数字が追加されます (例: OriginalOID2)。

• 変換中に発生したエラーまたは警告の詳細は、ArcGISProLog<process ID and GUID>.xml という名前のログ ファイル (ツールが ArcGIS Pro で対話的に実行され、診断ログが有効になっている場合)、または pythonLog<process ID and GUID>.xml という名前のログ ファイル (ツールがスタンドアロンの Python スクリプトで実行され、診断ログが有効である場合) に書き出されます。ここで <process ID and GUID> とは、ツールを実行するたびにログ ファイル名に追加されるプロセス ID および新しい GUID で、たとえば ArcGISProLog-12300~1A9C1C2A-A2CB-41AF-BEB9-1F8CDC4F6D29.xml や pythonLog-2160~807AFBC8-CA35-4370-9F90-4EDB2F9238AE.xml のようになります。 このファイルは、<Install drive>:\Users\<user name>\Documents\ArcGIS\Diagnostics にあります。

パラメーター

• Dialog
• Python

ラベル	説明	データ タイプ
入力フィーチャ	入力ポイント、ポリゴン、またはマルチパッチ フィーチャ。 入力フィーチャは、プロシージャ シンボルで表示されたフィーチャ レイヤーを指定できます。 フィールド マッピング (属性値を使用したシンボル プロパティ) が適用されます。	Feature Layer
ルール パッケージ	CGA ルールの情報およびアセットを含む CityEngine ルール パッケージ ファイル (*.rpk)。 .rpk ファイル内で @StartRule の注釈が付いているルールは、ポイント フィーチャ用のルール パッケージには @InPoint、ポリゴン フィーチャ用のルール パッケージには @InPolygon、マルチパッチ フィーチャ用のルール パッケージには @InMesh の注釈が付いています。 @StartRule に @InPoint、@InPolygon、または @InMesh の注釈がついていない場合、フィーチャ タイプはポリゴンと見なされます。	File
出力フィーチャ	CGA ルールが適用されたマルチパッチ フィーチャを含む出力フィーチャクラス。 各出力フィーチャの生成元になった入力フィーチャの ObjectID を含めるために、OriginalOID フィールドが出力フィーチャクラスに追加されます。	Feature Class
既存フィールドを含める (オプション)	出力フィーチャクラスが、入力フィーチャクラスの属性フィールドを含めるかどうかを指定します。 このパラメーターは、リーフ シェープのエクスポート パラメーターが使用されている場合は考慮されません。 オン—The attribute fields of the input feature class will be included in the output feature class. This is the default. オフ—The attribute fields of the input feature class will not be included in the output feature class. This option will be used automatically if the Export Leaf Shapes parameter is checked.	Boolean
レポートを含める (オプション)	ルール パッケージの作成方法によっては、モデルを作成するときに 1 つ以上のレポートを生成するロジックを含めることができます。 これらのレポートには、フィーチャに関する情報を含めることができます。 例として、各構築モデルに生成されるウィンドウ数を報告するルール パッケージが挙げられます。 このパラメーターは、ルール パッケージにレポートを生成するオプションが含まれていない場合は無視されます。 オン—The output feature class will include new attribute fields to hold reported values for each feature as defined by the rule package report generation logic. A unique attribute is created for each reported value. オフ—Reports generated in the rule package will be ignored, and no new attributes relating to the reports will be generated. This is the default.	Boolean
リーフ シェープのエクスポート (オプション)	各入力フィーチャを単一のマージされたマルチパッチ フィーチャに変換するか、ポイント、ライン、マルチパッチから構成される多くのフィーチャのセットにするかを指定します。 CityEngine のルール パッケージは、コンポーネントを個別に生成し、それらを 1 つの 3D オブジェクトにマージすることで、コンテンツを構築します。 ただし、これらのコンポーネント (リーフ シェープ) を別々のフィーチャとして保存することもできます。 このオプションは、建物の窓など、3D オブジェクトのサブエレメントを使用して解析操作を実行するときに、特に重要な場合があります。 たとえば、ルールによって、入力ポリゴンのフットプリントからシームレスな建物モデルを生成したり、集合住宅の正面ごとに、外向きパネル、代表の中心点、境界線を示すラインなど、別々のフィーチャを作成したりできます。 この例では、集合住宅のパネル、中心点、アウトラインがすべてリーフ シェープと見なされています。 オン—Additional output feature classes will be generated. The attribute fields from the input feature class will not be included in the output feature class. The output feature class will contain a field named OriginalOID that references the ObjectID of the input feature from which the output was generated. オフ—Additional output feature classes will not be generated, even if additional leaf shapes are defined in the logic of the rule. All of the geometry will be contained within the output multipatch features. This is the default.	Boolean

派生した出力

ラベル	説明	データ タイプ
出力ポイント フィーチャ	リーフ シェープを生成するとき、プライマリー出力マルチパッチ フィーチャクラスと同じ場所に出力ポイント フィーチャクラスが作成されます。	Feature Class
出力ライン フィーチャ	リーフ シェープを生成するとき、プライマリー出力マルチパッチ フィーチャクラスと同じ場所に出力ポリライン フィーチャクラスが作成されます。	Feature Class
出力マルチポイント フィーチャ	リーフ シェープを生成するとき、プライマリー出力マルチパッチ フィーチャクラスと同じ場所に出力ポリゴン フィーチャクラスが作成されます。	Feature Class

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

• Basic: はい
• Standard: はい
• Advanced: はい

関連トピック

• 3D フィーチャ ツールセットの概要
• ジオプロセシング ツールの検索