Analyze TOPは、任意の画像を取得し、その画像の様々な特性（平均ピクセルカラー、最大輝度のピクセル、各チャンネルの最小値と最大値など）を解析します。その結果は、選択したスコープに応じて、1×1、1xN、またはNx1 画像に保存されます（下記のScope パラメータを参照）。計算された値は、TOP to CHOP を使用して CHOP に持ち込むことができます。

注意：minimum オペレーションとmaximum オペレーションを使用する場合、デフォルトではminimum パラメータで選択された値が最も高いピクセルを選択することになります。例えば、Luminance が選択されている場合、出力されるのは輝度値そのものではなく、輝度が最も高いピクセルのRGBA値です。同様に、Red、Green、Blueなどの単一チャンネルが選択されている場合は、各チャンネルの最高値ではなく、最高の赤の値を持つピクセルが出力されます。各チャンネルの最小値または最大値を個別に求めるには、Analyze Channel を RGBA Independent に設定してください。

注意：Operationパラメータが Count Pixels または Sum に設定されている場合、出力データを適切に保存するために、出力イメージはデフォルトで32ビットの浮動小数点フォーマットになります。それ以外ではデフォルトの出力フォーマットは入力フォーマットと同じです。イメージ フォーマットは、Common ページのパラメータを使用して手動で設定することができます。

注意：Exclude NaNsやMask機能を使用すると、ノードのパフォーマンスが低下するので、必要な場合のみ有効にしてください。

入力画像に対して行う操作を設定します。

• Average / average
  入力画像の各チャンネルの平均値を求めます。この操作は，Exclude NaNsやMaskを使用する場合、結果を計算するためにノードが2回のパスを実行するため、著しく遅くなります．

• Minimum / minimum
  Analyze Channel パラメータで設定された解析対象で値が最も低いピクセルを見つけます。詳細については概要の注意事項を参照してください。

• Maximum / maximum
  Analyze Channel パラメータで設定された解析対象で値が最も高いピクセルを見つけます。詳細については概要の注意事項を参照してください。

• Count Pixels / count
  入力画像の有効なピクセル数を計算します。デフォルトでは、出力は Scope パラメータで設定された画像のサイズに基づいて固定されます。Exclude NaNs パラメータが有効な場合、またはMask パラメータが設定されている場合、出力はMaskとNaNチェックを通過したピクセル数になります。デフォルトでは、ピクセル数をカウントする場合、出力画像は32ビットの浮動小数点フォーマットに設定されます。

• Sum / sum
  入力画像内のすべてのピクセルの値の合計を計算します。デフォルトでは、出力結果を正しく保存するために、出力画像は32ビットの浮動小数点型フォーマットに設定されます。

操作がどのような値で実行されるかを設定します。たとえば、OperationパラメータがMinimumでAnalyze Channel がRed の場合、出力されるのは赤の値が最も低いピクセルになります。（青や緑の値が最も低いとは限りません）各チャンネルの最低値を個別に見つけるには、このパラメータを RGBA Independent に設定します。

• Luminance / luminance
  出力結果は、入力されたピクセルの輝度に基づきます。輝度とは RGB チャンネルの値に基づくピクセルの相対的な強度のことです。注意: 出力には輝度値そのものではなく、輝度が最も高い/最も低いピクセルの元の RGBA 値が含まれます。

• Red / red
  Red チャンネルの値のみに基づいて計算します。

• Green / green
  Green チャンネルの値のみに基づいて計算します。

• Blue / blue
  Blue チャンネルの値のみに基づいて計算します。

• Alpha / alpha
  アルファ チャンネルの値のみに基づいて計算します。

• RGB Average / rgbaverage
  RGBチャンネルの平均値に基づいて計算します。

• RGBA Average / average
  RGBAチャンネルの平均値に基づいて計算します。

• RGBA Independent / independent
  各チャンネルごとに個別に計算を行います。各チャンネルの最高・最低値を求める場合は、このモードを使用してください。

ピクセルをどのようにグループ化して結果を計算するかを設定します。

• Full Image / image
  計算は、入力画像のすべてのピクセルに対して行われ、1つのピクセルの結果に結合されます。

• Rows / rows
  入力の各行に対して別々に計算が行われ、結果は入力と同じ行数の１ピクセルの幅の画像が出力されます。

• Columns / columns
  入力の各列に対して別々に計算が行われ、結果は入力と同じ列数で1ピクセルの高さの画像が出力されます。

このパラメータを有効にすると、入力画像のNaN値を持つピクセルをスキップします。NaNは通常、以前の計算（0で割るなど）のエラーを表しますが、点群画像の無効なピクセルを表すために使用することもできます。ほとんどの操作でNaNピクセルに遭遇した場合、結果の出力は常にNaNとなるため、有効な結果を得るためにはこのパラメータを有効にする必要があります。入力にNaN値を想定していない場合は、このパラメータをオフにしておくことをお勧めします。

このパラメーターを使用すると、入力の1つ以上のチャネルの値に基づいて特定のピクセルを除外できます。 たとえば、アルファに設定した場合、アルファにゼロ以外の値を持つピクセルのみが含まれます。 これは、たとえば、有効なポイントデータを格納しているピクセルを示すためにアクティブチャネルを使用しているポイントクラウド画像の平均位置を見つける必要がある場合に役立ちます。

• None / none
  マスクチャンネルはありません。すべてのピクセルが出力計算に使用されます。

• Red / red
  Red チャンネルの値が0以外のピクセルのみが使用されます。

• Green / green
  Green チャンネルの値が0以外のピクセルのみが使用されます。

• Blue / blue
  Blue チャンネルの値が0以外のピクセルのみが使用されます。

• Alpha / alpha
  アルファ チャンネルの値が0以外のピクセルのみが使用されます。

• RGBA Independent / independent
  各チャンネルはそれ自身のマスクとして機能するので、ピクセルだけがゼロ以外の値を出力計算に使用されます。

参照：共通 Common ページ