エンベディングのフィールドへの抽出 (GeoAI ツール)
サマリー
BLOB (Binary Large Object) フィールドとして格納されているベクター エンベディングを、新しい出力フィーチャクラスの個々の数値フィールドに抽出します。
このプロセスにより、BLOB フィールド タイプをサポートしていない ArcGIS Pro ツールで、エンベディング ディメンションを直接使用できるようになります。
図
使用法
フィーチャ レイヤーには、BLOB (Binary Large Object) として格納されているエンベディング フィールドを 入力フィーチャ パラメーター値として指定し、ジオデータベース フィーチャクラスの場所を 出力フィーチャ パラメーター値として指定します。
このツールは、エンベディング フィールド パラメーター値のフィールド値を、出力フィールドの接頭辞 パラメーター値で始まるフィールド名を持つ個別の浮動小数点値に向けて抽出します。
たとえば、ディープ ラーニング生成のエンベディングがある衛星画像のフットプリントを含むフィーチャ レイヤーがあり、多変量クラスター分析 ツールを使用してそれらのフィーチャをグループ化するか、類似検索を使用してエンベディング空間内で類似するフットプリントを特定したい場合は、以下を実行します。
エンベディング BLOB フィールドを含むレイヤーを 入力フィーチャ パラメーター値として使用します。
エンベディング フィールド パラメーター値には、シリアル化された埋め込みベクトルを格納する BLOB フィールドを選択します。
出力フィーチャ パラメーター値には、有効なジオデータベース フィーチャクラスの場所を指定します。
新しいエンベディング ディメンション フィールドに名前を付けるため、出力フィールドの接頭辞 パラメーター値に意味のわかる接頭辞を指定します。 たとえば、出力フィールドの接頭辞 パラメーター値に embed_ を指定した場合、出力エンベディング ディメンションのフィールド名の先頭は、embed_1、embed_2 などになります。
このツールは、入力フィーチャ パラメーター値を 出力フィーチャ パラメーター値にコピーして、元の BLOB フィールドを保持します。 その後、各エンベディングを一連の Float32 フィールドに抽出しますが、出力フィールドの接頭辞 パラメーター値によって、エンベディング ディメンションあたり 1 つのフィールドになります。
注意:
出力フィーチャ パラメーター値は、ファイル、モバイル、またはエンタープライズ ジオデータベースに格納されたフィーチャクラスを参照している必要があります。 シェイプファイルや GeoPackages などのフォルダーベースの出力はサポートされていません。 出力フィールドの接頭辞 パラメーター値は、ジオデータベースのフィールド命名規則に準拠している必要があります。 接頭辞の先頭を数字にすることはできず、英数字とアンダースコアのみを使用できます。
- エンベディングの次元は、最初に遭遇した有効な BLOB レコードをデシリアライズすることで決定されます。 この次元は、作成される出力フィールドの数を定義するために使用します。 たとえば、エンベディングに 256 のディメンションが含まれている場合、ツールは 256 個の新しい Float32 フィールドを作成します。
注意:
すべてのフィーチャに有効なエンベディング値が含まれている必要があります。 エンベディング フィールドで NULL 値に遭遇すると、ツールは失敗し、エラーを返します。 さらに、すべてのエンベディングが同じ次元を持つ必要があります。 エンベディング BLOB の長さが確立されたディメンションと一致しない状況が発生した場合、ツールは処理を停止し、無効なフィーチャの ObjectID をレポートします。
出力フィーチャクラスには、入力フィーチャと同じジオメトリー タイプが常に含まれています。 このツールでは、ジオメトリーの変更や空間変換は実行されません。
抽出された数値フィールドは、多変量クラスター分析 や 類似検索 などのツールや、数値属性を必要とする他の 空間分析 および 空間統計ツールの入力として直接使用できます。 エンベディング ディメンションは数値であり、本質的に説明的ではないため、解釈や意思決定のために、元の 入力フィーチャ の識別子やカテゴリー フィールドを保持しておくことをおすすめします。
エンベディング BLOB フィールドを含むすべての元の属性は、新しく作成された Float32 エンベディング ディメンション フィールドとともに出力フィーチャクラスに保持されます。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力フィーチャ |
BLOB として格納されたエンベディング フィールドを含むフィーチャ レイヤー。 すべてのフィーチャに有効なエンベディング値が含まれている必要があります。 |
Feature Layer |
|
出力フィーチャ |
抽出されたエンベディング フィールドを含む出力フィーチャクラス。 ファイル、モバイル、またはエンタープライズ ジオデータベース内のフィーチャクラスである必要があります。 元の BLOB フィールドは保持されます。 |
Feature Class |
|
エンベディング フィールド |
シリアル化されたエンベディング ベクターを含む 入力フィーチャ パラメーター値の BLOB フィールド。 |
Field |
|
出力フィールドの接頭辞 |
新たに作成されたエンベディング ディメンション フィールドの名前の指定に使用される接頭辞。 ヒント:フィールド名の読みやすさと管理しやすさを保つため、短くわかりやすい接頭辞を使用してください。 たとえば、embed_ という値によって、embed_1、embed_2、...、embed_n という名前のフィールドが作成され、各フィールドは単一のエンベディング ディメンションを表します。 明確な接頭辞は、高次元のエンベディングを扱う際に特に重要です。これにより、下流の解析、フィールドの選択、解釈が容易になります。 |
String |
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい