Attribute Promote SOPこのノードは、複数のアトリビュートをあるクラスから別のクラスへ簡単に変換することができます。 例えば、色々なマージメソッドのいずれかを使用して、PointアトリビュートをPrimitiveアトリビュートに変換することができます。
インデックスアトリビュートの場合、マージメソッドはアトリビュートを文字列として扱います。 Average は、中央値処理を行ない、 Sum は、連結処理を行ない、その他の数値メソッドは、 First Match に委ねられます。
複数のコンポーネントを持つアトリビュート(ベクトルなど)の場合、各コンポーネントに対して個別にマージが行なわれます。
Note
同じストリーム(入力が1つ)内のジオメトリ間でアトリビュートをコピーしたい場合は、Attribute Promoteを使用してください。
ある入力ジオメトリから別の入力ジオメトリへアトリビュートをコピーしたい場合は、
Attribute Transferを使用してください。
パラメータ ¶
Attribute ¶
Original Name
ソースクラスのアトリビュートの名前。
例えば、Cdはカラーを取得します。
また、パターンやスペース区切りのアトリビュートリスト(例えば、*やCd pscale)を指定することもできます。
Original Class
アトリビュートが属する元のクラス。
Point、Primitive、Detail、Vertexのいずれかを指定することができます。
New Class
アトリビュートがプロモートされるクラス。 Piece Attribute が有効でない限り、 New Class は Original Class とは異なる値でなければなりません。 そうでない場合、警告が発生し、何も実行されません。
Piece Attribute
New Class 内のパーティションアトリビュートの名前。 これは文字列型または整数型でなければなりません。 アトリビュート値が同じ各ポイント/頂点/プリミティブが同じピースの一部とみなされます。 Promotion Method は、そのピースの Original Class 内の呼応するエレメントを使用して適用され、その結果がピースのすべてのエレメントに書き込まれます。
例えば、PointsからPrimitivesへプロモートさせる場合、 Promotion Method は、そのピース内のプリミティブから参照されているすべてのポイントに適用されます:
-
Original Class のエレメントは、(例えば、あるポイントがピース内の複数のプリミティブから参照されている場合でも)複数回含まれることはありません。
-
Original Class のエレメントは、インデックス順に並べ替えられます(例えば、 First Match は、そのピースのプリミティブから参照されているすべてのポイントのうち、最も小さいポイントインデックス値を返します)。
-
ピースアトリビュートを使用した場合、 Original Class が New Class と同じ値になることがあります(例えば、これを利用して、各ピースのアトリビュートの平均値を計算することができます)。
Promotion Method
Original Class 内のアトリビュートのうち、 New Class 内の単一エンティティと一致するものが複数ある場合、新しい値を決定するために何らかのメソッドを使用する必要があります。 例えば、PointアトリビュートからPrimitiveアトリビュートへ変換する場合、単一ポリゴンに呼応するポイントが多数存在することになります。
Maximum
一致した中で最も大きい方を選択します。
Minimum
一致した中で最も小さい方を選択します。
Average
平均値、つまり、すべての一致の合計を一致の数で割った値です。
Mode
一致した数が最も多いもの。 一致した数が最も多いものが複数存在した場合、その中で最も小さい方が選択されます。
Median
一致値の中央値。 エレメントの数が偶数である場合は、2つの可能な中央値のうち、より大きい方が選択されます。
Sum
すべての一致値の合計。
Sum of Squares
すべての一致値の二乗を合計した値。
Root Mean Square
すべての一致値の二乗の平均の平方根。
First Match
最初の有効な一致。 ポイントをプリミティブにプロモートさせた場合、これはプリミティブの最初の頂点のポイントとなります。
Last Match
最後の有効な一致。 ポイントをプリミティブにプロモートさせた場合、これはプリミティブの最後の頂点のポイントとなります。
Array of All
ソースアトリビュートがタプルアトリビュートの場合、新しい配列アトリビュートが作成されます。 この配列アトリビュートには、一致したすべての値が格納されます。
Change New Name
無効な場合、 New Name アトリビュートは Original Name と一致します。
New Name
Change New Name が有効な場合のアトリビュートの新しい名前。
ソースがパターンの場合、この新しい名前は同じ長さに展開可能なパターンである必要があります。
Glob形式の名前変更が行なわれるため、マッチングパターンがinstance*で、新しい名前が my*instanceの場合、instancepointアトリビュートはmypointinstanceにプロモートされます。
Delete Original
有効にすると、プロモート後に元のアトリビュートが削除されます。 なお、Vertexアトリビュートを同名のPointアトリビュートにプロモートさせる場合などの一部のケースでは元のアトリビュートが常に削除されることに注意してください。 これを回避するには、プロモート時にアトリビュートの名前を変更してください。
| See also |
Attribute Rename
Attribute Create
