colmask

メニュー情報

列: 条件でセルをマスク

概要

条件に応じてセルをマスキングします

コマンドラインでの使用法

1. colmask irng:=2 cond:=sd nSD:=2; //Mask the cell values in column 2 which outlie 2SD from the mean

2. colmask irng:=3 cond:=gt val:=0.3; //0.3より大きい列3のセルをマスクする

Xファンクションの実行オプション

スクリプトからXファンクションにアクセスする場合、追加のオプションスイッチについてのページを参照してください。

変数

表示
変数
I/O

データ型
デフォルト
説明
入力 irng

入力

Range

<active>
マスクする範囲を指定します。
条件 cond

入力

int

0
入力データをマスクする条件を指定します。

オプションリスト:

  • sd:標準偏差による外れ値Deviation
    入力範囲の平均から標準偏差が離れている値をマスク
  • gt:>
    valで指定した値より大きいセル値をマスクします。
  • ge:>=
    valで指定した値以上のセル値をマスクします。
  • lt:<
    valで指定した値より小さいセル値をマスクします。
  • le:<=
    valで指定した値以下のセル値をマスクします。
  • eq:=
    valで指定した値に等しいセル値をマスクします。
  • IQRによる外れ値
    IQRは四分位数範囲です。これが選択された場合、[Q1-multiple*IQR, Q3+multiple*IQR]の範囲が計算され、この範囲を超えるデータは外れ値になります。これらの値をマスクします。
SDの倍数/IQRの倍数 nSD

入力

int

1
これは、cond変数がsdもしくはiqrにセットされている場合のみ利用できます。ここで指定した数値n は、平均から n 標準偏差が外れている値がマスクされることを意味しています。Origin 2019b以降、非整数値をサポートし、GUIツール(colmaskダイアログ)のコンボボックスに直接値を入力または、次のようにスクリプトを記述できます。 colmask nSD:=1.5;

オプションリスト:

  • 1
    平均から1SD外れているセルの値をマスクします。
  • 2
    平均から2SD外れているセルの値をマスクします。
  • 3
    平均から3SD外れているセルの値をマスクします。
  • 4
    平均から4SD外れているセルの値をマスクします。
  • 5
    平均から5SD外れているセルの値をマスクします。
  • 6
    平均から6SD外れているセルの値をマスクします。
val

入力

double

<unassigned>
これは、cond変数がsdもしくはiqrでない場合に利用できます。
条件判定に絶対値を使う abs

入力

int

0
これは、cond変数がsdもしくはiqrでない場合に利用できます。条件をテストするために絶対値を使うかどうかを指定します。
既存マスクの保存 keep

入力

int

0
既存のマスクを保存するかどうかをこの変数で指定します。

説明

この機能は条件に合う入力値をマスクします。

サンプル

  1. 次のステップは、乱数の平均から1標準偏差外れているデータをマスクする簡単な例を示しています。
    1. 新しいワークブックを作成します。
    2. フォーマット:ワークシートの表示属性」を選択し、ワークシートプロパティダイアログを開きます。サイズタブをクリックし、行数を10000にします。OK ボタンをクリックします。
    3. A列を選択し、右クリックします。開いたメニューから列値の一律設定: 正規乱数を選択して1列目に正規乱数を入力します。
    4. 列を選択したまま、列: 条件でセルをマスクするを選択し、colmaskダイアログを開きます。
    5. デフォルトの設定のまま、OK をクリックして実行します。1SDより離れた値は赤くマスクされます。
  2. 次のスクリプトは、256年の黒点数の記録データにおいて、平均から1SD外れている黒点数をマスクする方法を示します。
newbook;
string fn$=system.path.program$+"\Samples\Signal Processing\Average Sunspot.dat";
impasc fname:=fn$;
colmask irng:=2 cond:=sd;

関連 X ファンクション

wcellmask