# Math ツールの機能

Math ツールは、総合的な算術演算機能を提供します。

- クロックドデータ関数は、セルの値のストリームを経時的に保存します。各関数は、指定されたイベントによってスプレッドシートが更新されるたびに、値のストリームから選択された単一の値を返します。

- 幾何学関数と計測関数を使用すると、円、点、ラインセグメントなどの標準的な幾何学構造体間の距離を簡単に計算できます。
- グラフィックス:
  - オペレータ I/F 関数は、スプレッドシートに対話型グラフィックス要素を挿入することによって、[関数の挿入] ダイアログやプロパティシートを使用することなくジョブの設定を簡単に変更できます。
  - 画像関数は、画像上にグラフィックスオーバレイを表示します。
- 数学関数:
  - 論理演算関数は、ブール代数および条件分岐の機能を提供します。すべての論理演算関数で、0 値は FALSE を意味し、0 以外の値は TRUE を意味します。
  - 値の範囲から最大値、最小値、またはインデックス番号を検索するには、ルックアップ関数を使用します。この関数は X および Y 座標と #ERR データを返し、#ERR セルを抑制して複数の関数にエラーが伝播するのを回避します。
  - 算術関数は、絶対値、累乗、切り捨て、四捨五入、乱数生成などのさまざまな数学関数を提供します。
  - 統計: 一連の値の最大値、最小値、平均値、標準偏差の各データを返します。
  - 三角関数: 正弦、余弦、接線、円周率、度、ラジアン関数 (およびそれらに関連する関数) を提供します。
- 演算子関数は、=、<>、>、<、>=、<= などの比較演算子を提供します。

- 文字列関数は、英数字データを表示用、および In-Sight ビジョンシステムとリモートデバイス間の通信用に書式設定します。

- データアクセス (VDA) 関数は、データ構造体、関数、およびその他のセル参照から個々の値を抽出します。

- ビジョンツール関数は、詳しいデータ分析および判定のために画像の特徴を抽出して処理する関数で構成されています。

注: [関数の挿入] リストにカテゴリ名は表示されません。関数は、1 つのリストとしてアルファベット順に表示されます。

## 関数のリスト

グループ | タイプ | 関数 | 説明
--- | --- | --- | ---
クロックドデータ関数 | Accumulate | シンタックス:Accumulate(イベント,値,リセット,プリセット) 区間での値を合計します。この関数は、指定したイベントが発生するたびにサンプリングされたデータストリームの積分を返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 指定した値を読み取るイベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: Accumulate 関数は、指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をバッファリングします。
値 | 蓄積されるデータストリームのソースを含んでいるセルへの参照 (-16777216 ～ 16777216、デフォルト = 1.000)
リセット | アキュムレータをプリセット値に強制的にリセットします。
0 = OFF (デフォルト) | アキュムレータは、指定された値を無期限に合計し続けます。
1 = ON | アキュムレータは直ちにリセットされます。
プリセット | リセットが ON のときにアキュムレータをリセットする最小値を指定します (-16777216 ～ 16777216、デフォルト = 0.000)。
#### 出力
戻り値 | 最後のリセット以降の一定時間内のデータストリームの合計を表す値。
ClockedMax | シンタックス:ClockedMax(イベント,値,リセット,プリセット) 区間の値のストリームをサンプリングし、その区間にストリームからサンプリングされた最大値を返します。 ## 入力
パラメータ | 説明
--- | ---
イベント | 更新を強制するイベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: 指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をサンプリングする Maximum 関数とは異なり、ClockedMax 関数は、他の関数が参照値を更新した後に参照値の状態をサンプリングします。
値 | 最小値の検索対象であるデータストリームのソースセルへの参照 (-16777216 ～ 16777216、デフォルト = 0)。
リセット | 関数の内部レジスタをプリセットで指定した値に強制的にリセットします。
0 = OFF (デフォルト) | 現在のデータストリーム内の値をサンプリングし続けます。
1 = ON | 返した最小値をリセットし、サンプリングするための新しいデータストリームを開始します。
プリセット | 関数がリセットされる最小値を指定します (-16777216 ～ 16777216、デフォルト = -16777216)。
#### 出力
戻り値 | リセットから現時点までの区間のデータストリームの最小値を表す値。
ClockedMin | シンタックス:ClockedMin(イベント,値,リセット,プリセット)。 区間の値のストリームをサンプリングし、その区間にストリームからサンプリングされた最小値を返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 値を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: 指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をサンプリングする Minimum 関数とは異なり、ClockedMin 関数は、他の関数が参照値を更新した後に参照値の状態をサンプリングします。
値 | 最小値の検索対象であるデータストリームのソースセルへの参照 (-16777216 ～ 16777216、デフォルト = 0)。
リセット | 関数の内部レジスタをプリセットで指定した値に強制的にリセットします。
0 = OFF (デフォルト) | 現在のデータストリーム内の値をサンプリングし続けます。
1 = ON | 返した最小値をリセットし、サンプリングするための新しいデータストリームを開始します。
プリセット | 関数がリセットされる最小値を指定します (-16777216 ～ 16777216、デフォルト = -16777216)。
#### 出力
戻り値 | リセットから現時点までの区間のデータストリームの最小値を表す値。
ClockedSum | シンタックス:ClockedSum(イベント,値,リセット,プリセット)
Count | シンタックス:Count(イベント,最大値,リセット,プリセット) 区間のイベント数をカウントします。この関数は、前回のリセット以降に発生したイベント数をプリセット値に加算した値を返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | カウンタを増分する更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル
最大値 | 最大許容値を指定します。この値に達すると、カウンタは最小プリセット値に自動的にリセットされます (-16777216 ～ 16777216、デフォルト = 16777216)。
リセット | カウンタをプリセット値に強制的にリセットします。
0 = OFF (デフォルト) | カウンタは、最大値に達した後でリセットされます。
1 = ON | カウンタは、最大値に達していなくても直ちにリセットされます。
プリセット | 最大値に達した場合、またはリセットが ON の場合にカウンタがリセットされる最小値を指定します (-16777216 ～ 16777216、デフォルト = 0)
#### 出力
戻り値 | 前回のリセット以降に発生したイベント数をプリセット値に加算した値。
CountPassFail | シンタックス:CountPassFail(イベント,値,オフライン時にカウント,イベントのリセット.手動,イベントのリセット.オンライン,イベントのリセット.ジョブのロード) 指定された参照値の合格、不合格、およびイベント総数をカウントして返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | カウンタを増分するイベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル
値 | カウントされるデータストリームのソースを含んでいるセルへの必要な参照を指定します。参照されているセルがない場合、関数はすべての結果に対して #ERR を返します。増分されるカウンタ (Pass、Fail、または #ERR) は、次のように戻り値に基づいています。
Pass | 値 > 0
Fail | 値 = 0
#ERR | 値 < 0
オフライン時にカウント | センサがオフラインの間にカウンタが増分されるかどうかを指定します。
0 = OFF | センサがオフラインの場合、カウンタを増分させません。
1 = ON (デフォルト) | センサがオフラインの場合、カウンタを増分させます。
イベントのリセット | 特定のイベントによってカウンタを強制的にリセットします。
手動 | 指定されたイベントが発生したときにカウンタをゼロにリセットするかどうかを指定します。このパラメータは、[リセット] ボタンを自動的に参照します。[リセット] ボタンは、関数が最初に作成されたときにスプレッドシートに挿入されます。 注: プロパティシート内でこのチェックボックスを手動で切り替えると、[リセット] ボタンへの参照は削除されます。[リセット] ボタンを使用するには、このパラメータが [リセット] ボタンを含むセルを参照している必要があります。
0 = OFF (デフォルト) | 指定されたイベントが発生しても、カウンタをリセットしません。
1 = ON | 指定されたイベントが発生すると、カウンタをリセットします。
オンライン | センサがオンラインにされたときに最初のイベントが発生すると、カウンタをゼロにリセットするかどうかを指定します。
0 = OFF | センサがオンラインにされても、最初のイベント発生後にカウンタをリセットしません。
1 = ON (デフォルト) | センサがオンラインにされると、最初のイベント発生後にカウンタをリセットします。
ジョブのロード | ジョブがロードされた場合にカウンタをゼロにリセットするかどうかを指定します。
0 = OFF | ジョブがロードされても、カウンタをリセットしません。
1 = ON (デフォルト) | ジョブがロードされると、カウンタをリセットします。
#### 出力
戻り値 | 増分されたカウンタを含んでいるカウントデータ構造体。入力パラメータが無効な場合は #ERR を返します。
結果 | CountPassFail が初めてセルに挿入されると、スプレッドシート内に結果テーブルと [リセット] ボタンが作成されます。[リセット] ボタンをクリックすると、すべてのカウンタがゼロにリセットされます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。.
合格 | GetPassCount(カウント) | 合格の増分カウント。合格数は、返される値がゼロよりも大きい場合にカウントアップされます。
不合格 | GetFailCount(カウント) | 不合格の増分カウント。不合格数は、返される値がゼロの場合にカウントアップされます。
エラー | GetErrorCount(カウント) | エラーの増分カウント。エラー数は、返される値がゼロよりも小さい場合にカウントアップされます。
総数 | GetTotalCount(カウント) | 合格、不合格、およびエラーの総数。
Latch | シンタックス:Latch(イベント,値) 指定したイベントでの入力値を保存 (ラッチ) します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 値を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル
値 | 保存するデータを含んでいるセルへの参照 (-16777216 ～ 16777216、デフォルト = 0.000)。
#### 出力
戻り値 | 最後のイベント時に保存された値。
LatchString | シンタックス:LatchString(イベント,"文字列") 指定したイベントでの英数字入力文字列を保存 (ラッチ) します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 文字列を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル
文字列 | 保存する文字列を含んでいるセルへの参照。
#### 出力
戻り値 | 最後のイベント時に保存された文字列。
Maximum | シンタックス:Maximum(イベント,値,リセット,プリセット) 区間の値のストリームをサンプリングし、その区間にストリームからサンプリングされた最大値を返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 値を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: Maximum 関数は、指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をサンプリングします。
値 | 最大値の検索対象であるデータストリームのソースセルへの参照。
リセット | 関数の内部レジスタをプリセットで指定した値に強制的にリセットします。
0 = OFF (デフォルト) | 現在のデータストリーム内の値をサンプリングし続けます。
1 = ON | 返した最大値をリセットし、サンプリングするための新しいデータストリームを開始します。
プリセット | 関数がリセットされる最大値を指定します (-16777216 ～ 16777216、デフォルト = -16777216)。
#### 出力
戻り値 | 前回のリセット以降のデータストリームで最大値となった値。
Minimum | シンタックス:Minimum(イベント,値,リセット,プリセット) 区間の値のストリームをサンプリングし、その区間にストリームからサンプリングされた最小値を返します。 #### 入力
パラメータ | 説明
--- | ---
イベント | 値を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: Minimum 関数は、指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をサンプリングします。
値 | 最小値の検索対象であるデータストリームのソースセルへの参照。
リセット | 関数の内部レジスタをプリセットで指定した値に強制的にリセットします。
0 = OFF (デフォルト) | 現在のデータストリーム内の値をサンプリングし続けます。
1 = ON | 返した最小値をリセットし、サンプリングするための新しいデータストリームを開始します。
プリセット | 関数がリセットされる最小値を指定します (-16777216 ～ 16777216、デフォルト = 16777216)。
#### 出力
戻り値 | リセットから現時点までの区間のデータストリームの最小値を表す値。
ShiftRegister | シンタックス:ShiftRegister (イベント,値,ステップ数,リセット) 各イベント後にセルの値をバッファリングする、シフトレジスタ配列またはデータの「ストリーム」を実装します。 注: リセット後、読み取った最初の値がシフトレジスタに埋め込まれます。 #### 入力
イベント | 値を読み取る更新イベントを指定します。このパラメータは、次のいずれかを参照している必要があります。 「取り込み済み」キーワードは、最新の画像の取り込みを表します。 Event 関数を含むセル。 Button 関数を含むセル 注: 指定したイベントに依存する他の関数が参照値を更新する前に参照値の状態をバッファリングする DelayLine 関数とは異なり、ShiftRegister 関数は、他の関数が参照値を更新した後に参照値の状態をバッファリングします。
値 | ソースデータを含んでいるセルへの参照 (-16777216 ～ 16777216、デフォルト = 0)。
ステップ数 | 関数の内部シフトレジスタ配列内の値の数を指定します (1 ～ 5000、デフォルト = 10)。
リセット | 以前に読み取った値を関数自体から強制的に消去します。実質的には、リセット後に最初に読み取った値がシフトレジスタに「埋め込まれ」ます。
0 = OFF (デフォルト) | データストリームへの値の読み取りが続行されます。
1 = ON | データストリームからすべての値を消去します。
#### 出力
戻り値 | リセットから現在までの指定した値の統計を含むバッファデータ構造体。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
最後 | GetValue(Delay, インデックス) | 構造体に含まれている最後の値。
平均 | GetMean(Delay) | 構造体内のすべての値の平均値。
標準偏差 | GetSDev(Delay) | 構造体内のすべての値の標準偏差。
最小 | GetMin(Delay) | 構造体に含まれている最小値。
最大 | GetMax(Delay) | 構造体に含まれている最大値。
次のデータアクセス関数を使用して、その他のデータ要素を取得できます。
カウント | GetCount(Delay) | 構造体に含まれている値の個数。
合計 | GetSum(Delay) | 構造体に含まれているすべての値の合計。
幾何学関数 | Fit 関数 注: 幾何学関数でワールド座標データを参照として使用している場合、生成されたグラフィックスが正しく表示されません。 | CircleFromNPoints | シンタックス:CircleFromNPoints(点 X 0,点 Y 0,点 X 1,点 Y 1,点 X 2,点 Y 2,...,点 X N,点 Y N,表示) 3 つ以上の入力点を使用して最適円を作成します。 #### 入力
パラメータ | 説明
--- | ---
点 0 | 1 番目の点の座標を指定します。
点 X 0 | 1 番目の点の X 座標
点 Y 0 | 1 番目の点の Y 座標
点 1 | 2 番目の点の座標を指定します。
点 X 1 | 2 番目の点の X 座標
点 Y 1 | 2 番目の点の Y 座標
点 2 | 3 番目の点の座標を指定します。
点 X 2 | 3 番目の点の X 座標。
点 Y 2 | 3 番目の点の Y 座標。
点 3..N | 任意の追加点の座標をオプションで指定します。
点 X N | N 番目の点の X 座標
点 Y N | N 番目の点の Y 座標
表示 | 常時表示されるグラフィックス項目を指定します。
0 = 非表示 | CircleFromNPoints 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合を除き、すべてのグラフィックス項目が表示されません。
1 = 結果のグラフィックスのみ | 最適円のグラフィックスが常に表示されます。入力点は、CircleFromNPoints 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合のみ表示されます。
2 = 入力と結果のグラフィックス | 最適円と入力点が常に表示されます。
#### 出力
戻り値 | 最適円の X、Y、半径、およびシグマを含んでいる CircleFit データ構造体。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X | GetX(CircleFit) | 円の中心の X 座標。
Y | GetY(CircleFit) | 円の中心の Y 座標。
半径 | GetRadius(CircleFit) | 円の半径。
シグマ | GetSigma(CircleFit) | 点から円までの距離を点の数で除算した結果の二乗和の平方根。
次のデータアクセス関数を使用して、その他のデータ要素を取得できます。
距離 | GetDistance(CircleFit, インデックス) | インデックスで指定された点と円の間の距離。値が負の場合、点は円内にあります。インデックスで指定された点が無効な場合、#ERR が返されます。
最大距離 | GetMaxDist(CircleFit) | 円と、円から最も遠い点との間の距離。値が負の場合、点は円内にあります。
最大距離インデックス | GetMaxDistIndex(CircleFit) | 円から最も遠い点のインデックス。
N 点使用 | GetNPointsUsed(CircleFit) | 最適円の作成に使用された点の数。
LineFromNPoints | シンタックス:LineFromNPoints(点 X 0,点 Y 0,点 X 1,点 Y 1,[...点 X N,点 Y N,表示]) 2 つ以上の入力点を使用してラインを作成します。 #### 入力
パラメータ | 説明
--- | ---
点 0 | 1 番目の点の座標を指定します。
点 X 0 | 1 番目の点の X 座標
点 Y 0 | 1 番目の点の Y 座標
点 1 | 2 番目の点の座標を指定します。
点 X 1 | 2 番目の点の X 座標
点 Y 1 | 2 番目の点の Y 座標
点 2..N | 任意の追加点の座標を指定します。
点 X N | N 番目の点の X 座標
点 Y N | N 番目の点の Y 座標
表示 | 常時表示されるグラフィックス項目を指定します。
0 = 非表示 | LineFromNPoints 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合を除き、すべてのグラフィックス項目が表示されません。
1 = 結果のグラフィックスのみ | 最適ラインのグラフィックスが常に表示されます。入力点は、LineFromNPoints 関数を含んでいるセルがスプレッドシート内のアクティブセルである場合のみ表示されます。
2 = 入力と結果のグラフィックス | 最適ラインと入力点は常に表示されます。
#### 出力
戻り値 | 2 つ以上の有効な点がデータに含まれる場合は LineFit データ構造体、データに含まれる有効な点が 1 つ以下の場合、#ERR を返します。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X0 | GetX(LineFit, 0) | 始点の X 座標
Y0 | GetY(LineFit, 0) | 始点の Y 座標
X1 | GetX(LineFit, 1) | 終点の X 座標
Y1 | GetY(LineFit, 1) | 終点の Y 座標
カイ 2 乗 | GetChi2(LineFit) | 点とラインの間の距離の二乗の合計
次のデータアクセス関数を使用して、その他のデータ要素を取得できます。
距離 | GetDistance(LineFit, インデックス) | インデックスで指定された点と、ラインの間の距離
最大距離 | GetMaxDist(LineFit) | ラインから最も遠い点
最大距離インデックス | GetMaxDistIndex(LineFit) | ラインから最も遠い点のインデックス
N 点使用 | GetNPointsUsed(LineFit) | ラインの計算に使用された点の数
計測関数 | PointToCircle | シンタックス:PointToCircle(点.X,点.Y,円.X,円.Y,円.半径,表示) 点から、円上の最も近い点までの最小距離を計算します。点が円の内側にある場合、距離は負の数値として報告されます。 #### 入力
パラメータ | 説明
--- | ---
点 | 原点として使用する点の座標を指定します。
X | 点の X 座標。
Y | 点の Y 座標。
円 | 円の座標とサイズを指定します。
X | 円の中心の X 座標。
Y | 円の中心の Y 座標。
半径 | 円の半径。
表示 | 画像上の関数のグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、すべてのグラフィックスが表示されません。
1 = 結果のグラフィックスのみ | 点と円の間の最小距離を示すラインセグメントが常に表示されます。
2 = 入力と結果のグラフィックス | 点と円、およびそれらの間のラインセグメントが常に表示されます。
#### 出力
戻り値 | 点と、円上の最も近い点の間の有向距離を含んでいる距離データ構造体。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X0 | GetX(距離, 0) | 点の X 座標。
Y0 | GetY(距離, 0) | 点の Y 座標。
X1 | GetX(距離, 1) | 円上の最も近い点の X 座標。
Y1 | GetY(距離, 1) | 円上の最も近い点の Y 座標。
角度 | GetAngle(距離) | 2 点間の角度。
距離 | GetDistance(距離) | 2 点間の距離。
PointToLine | シンタックス:PointToLine(点.X,点.Y,ライン.X 0,ライン.Y 0,ライン.X 1,ライン.Y 1,表示) 点からラインまでの最小距離を計算します。 この例では、PointToLine 関数は点とラインの間の距離を計算します。点が原点であり、角度はラインとの相対的な位置に基づいて計算されます。 #### 入力
パラメータ | 説明
--- | ---
点 | 原点として使用する点の座標を指定します。
X | 点の X 座標。
Y | 点の Y 座標。
ライン | ラインの座標を指定します。
X 0 | ラインの始点の X 座標。
Y 0 | ラインの始点の Y 座標。
X 1 | ラインの終点の X 座標。
Y 1 | ラインの終点の Y 座標。
表示 | 画像上の関数のグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、すべてのグラフィックスが表示されません。
1 = 結果のグラフィックスのみ | 点と入力ラインの間の最小距離を示すラインセグメントが常に表示されます。
2 = 入力と結果のグラフィックス | 点、入力ライン、およびそれらの間のラインセグメントが常に表示されます。
#### 出力
戻り値 | 点と、ライン上の最も近い点の間の有向距離を含んでいる距離データ構造体。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X0 | GetX(距離, 0) | 点の X 座標。
Y0 | GetY(距離, 0) | 点の Y 座標。
X1 | GetX(距離, 1) | ライン上の最も近い点の X 座標。
Y1 | GetY(距離, 1) | ライン上の最も近い点の Y 座標。
角度 | GetAngle(距離) | 点とラインの間の角度。
距離 | GetDistance(距離) | 点とラインの間の距離。
PointToPoint | シンタックス:PointToPoint(点 0.X,点 0.Y,点 1.X,点 1.Y,表示) 2 点間の有向距離を計算します。 この例では、PointToPoint 関数は2 点間の距離を計算します。角度は、1 番目の点の、2 番目の点に対する相対的な位置に基づいて計算されます。 #### 入力
パラメータ | 説明
--- | ---
点 0 | 原点として使用する、1 番目の点の座標を指定します。
X | 1 番目の点の X 座標
Y | 1 番目の点の Y 座標
点 1 | 2 番目の点の座標を指定します。
X | 2 番目の点の X 座標
Y | 2 番目の点の Y 座標
表示 | 画像上の関数のグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、すべてのグラフィックスが表示されません。
1 = 結果のグラフィックスのみ | 2 つの入力点間の最小距離を示すラインセグメントが常に表示されます。
2 = 入力と結果のグラフィックス | 2 つの入力点とそれらの間のラインセグメントが常に表示されます。
#### 出力
戻り値 | 2 つの点の間の有向距離を含んでいる距離データ構造体。
結果 | この関数が初めてセルに挿入されると、スプレッドシート内に結果テーブルが自動的に作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X0 | GetX(距離, 0) | 1 番目の点の X 座標
Y0 | GetY(距離, 0) | 1 番目の点の Y 座標
X1 | GetX(距離, 1) | 2 番目の点の X 座標
Y1 | GetY(距離, 1) | 2 番目の点の Y 座標
角度 | GetAngle(距離) | 2 点間の角度。
距離 | GetDistance(距離) | 2 点間の距離。
PointToPointAngle | シンタックス:PointToPointAngle(点 0.X,点 0.Y,点 1.X,点 1.Y) 2 点間の角度を計算します。 #### 入力
パラメータ | 説明
--- | ---
点 0 | 原点として使用する、1 番目の点の座標を指定します。
X | 1 番目の点の X 座標
Y | 1 番目の点の Y 座標
点 1 | 2 番目の点の座標を指定します。
X | 2 番目の点の X 座標
Y | 2 番目の点の Y 座標
#### 出力
戻り値 | 画像の X 軸に対する、2 点間の角度を含む値。
注: 幾何学カテゴリの他の大部分の計測関数とは異なり、PointToPointAngle 関数は距離データ構造体または結果テーブルをスプレッドシートに挿入しません。
PointToPointDistance | シンタックス:PointToPointDistance(点 0.X,点 0.Y,点 1.X,点 1.Y) 2 点間の距離を計算します。 #### 入力
パラメータ | 説明
--- | ---
点 0 | 1 番目の点の座標を指定します。
X | 1 番目の点の X 座標
Y | 1 番目の点の Y 座標
点 1 | 2 番目の点の座標を指定します。
X | 2 番目の点の X 座標
Y | 2 番目の点の Y 座標
#### 出力
戻り値 | 2 点間の距離を含む値。
注: 幾何学カテゴリの他の大部分の計測関数とは異なり、PointToPointDistance 関数は、距離データ構造体または結果テーブルをスプレッドシートに挿入しません。
グラフィックス | コントロール 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 | Button | シンタックス:Button(名前,トリガ) ラベル付きプッシュボタンコントロールをスプレッドシートに挿入します。オプションで、スプレッドシートのイベントトリガを通知するようボタンの押下を設定できます。 ヒント: ボタンのプロパティシートにアクセスするには、ボタンを右クリックして、[関数の編集] を選択します。 注: ボタンコントロールは、In-Sight のネイティブモードコマンドの EV SetCellValue コマンドを使用してプログラム的に制御できます。ボタンを押すには 1 を入力し、ボタンを放すには 0 を入力します。ボタンを押した後にボタンを放すコマンドが送信されていることを確認します。そうしないと、ボタンは押されたままの状態になります。 ボタンをクリックすると、2 つのイベントが生成されます。ボタンを押すとボタンの状態は 0 から 1 に変わり、ボタンを放すと 1 から 0 に変わります。ソフトイベントを生成するようにボタンが設定されている場合は、ボタンを押すとイベントが 1 度だけトリガされます。 #### 入力
パラメータ | 説明
--- | ---
名前 | テキスト文字列ラベルを指定します。この名前がボタン自体に表示されます。
トリガ | オプションで、ボタンが押されたときに発生するトリガ信号を指定します。
-1 = なし (デフォルト) | トリガ信号は送られません。
32 = 手動 | 手動トリガ信号が送られます。
80 ～ 87 = ソフト 0 ～ 7 | ソフトトリガイベント信号が送られます。
#### 出力
戻り値 | ボタンが押されると 1 の値を、押されていない場合は 0 の値を返します。
結果 | ラベル付きボタン コントロール。
CheckBox | シンタックス:CheckBox(名前) ラベル付きチェックボックスコントロールをスプレッドシートに挿入します。 注: CheckBox のプロパティシートにアクセスするには、CheckBox を右クリックして、[関数の編集] を選択します。 #### 入力
パラメータ | 説明
--- | ---
名前 | チェックボックスの横に表示するテキスト文字列ラベルを指定します。
#### 出力
戻り値 | オフ (チェックされていない) の場合は 0、オン (チェックされている) の場合は 1。
結果 | ラベル付きチェックボックス コントロール。
#### 例 スプレッドシートが次のように設定されています。 A3=CheckBox("On") A4=A3 セル A4 はセル A3 を参照して、[On] チェックボックスのオン/オフを指定します。このチェックボックスをオフにすると、セル A4 には値 0.000 が返されます。このチェックボックスをオンにすると、値 1.000 が返されます。
EditFloat | シンタックス:EditFloat(最小,最大) 浮動小数点数編集コントロールをスプレッドシートに挿入します。このコントロールは、他の対話型の数値入力コントロールと同様に動作します。 注: EditFloat コントロールのプロパティシートにアクセスするには、コントロールを右クリックして、[関数の編集] を選択します。 #### 入力
パラメータ | 説明
--- | ---
最小 | 編集ボックスコントロールが受け入れる最小値を指定します (-16777216 ～ 16777216、デフォルト = 0)。
最大 | 編集ボックスコントロールが受け入れる最大値を指定します (-16777216 ～ 16777216、デフォルト = 100)。
#### 出力
戻り値 | コントロールに入力された値。
結果 | EditFloat コントロール。
EditInt | シンタックス:EditInt(最小,最大) 整数編集コントロールをスプレッドシートに挿入します。このコントロールは、他のすべての対話型の In-Sight 数値入力コントロールと同様に動作します。 注: EditInt コントロールのプロパティシートにアクセスするには、コントロールを右クリックして、[関数の編集] を選択します。 #### 入力
パラメータ | 説明
--- | ---
最小 | 編集ボックスコントロールが受け入れる最小値を指定します (-16777216 ～ 16777216、デフォルト = 0)。
最大 | 編集ボックスコントロールが受け入れる最大値を指定します (-16777216 ～ 16777216、デフォルト = 255)。
#### 出力
戻り値 | コントロールに入力された値。
結果 | EditInt コントロール。
EditString | シンタックス:EditString(最大文字列長) 整数編集コントロールをスプレッドシートに挿入します。このコントロールは、他のすべての対話型の In-Sight 数値入力コントロールと同様に動作します。 注: EditInt コントロールのプロパティシートにアクセスするには、コントロールを右クリックして、[関数の編集] を選択します。 #### 入力
パラメータ | 説明
--- | ---
最小 | 編集ボックスコントロールが受け入れる最小値を指定します (-16777216 ～ 16777216、デフォルト = 0)。
最大 | 編集ボックスコントロールが受け入れる最大値を指定します (-16777216 ～ 16777216、デフォルト = 255)。
#### 出力
戻り値 | コントロールに入力された値。
結果 | EditInt コントロール。
ListBox | シンタックス:ListBox("文字列0","文字列1","文字列2",...) スプレッドシートにドロップダウンリストコントロールを挿入します。 注: ListBox 関数は可変数の文字列を受け入れるため、この関数はプロパティシートを使用して設定しません。この関数はセル、または [ジョブの編集] ツールバーの数式バーで直接設定できます。 #### 入力
パラメータ | 説明
--- | ---
文字列0, 1, 2, ... | 個々のテキスト文字列の可変長リスト。ユーザーがドロップダウンリストから選択すると、それぞれ異なる値を返します。
#### 出力
戻り値 | 選択した項目のインデックス番号 (ゼロから始まる) を表す値。
結果 | ListBox コントロール。 注: リストから現在選択されているテキスト文字列に、GetString データアクセス関数を使用してアクセスすることもできます。
#### 例 スプレッドシートが次のように設定されています。 A3=ListBox("項目1","項目2","項目3") A4=A3 セル A3 の関数は、デフォルトの選択肢として「項目1」を含むリストコントロールを生成します。項目1 のインデックス値は 0 です。したがって、セル A4 の値は 0.000 になります。 ユーザーが「項目2」を選択した場合、セル A4 の値は 1.000 になります。「項目3」を選択した場合、セル A4 の値は 2.000 になります。 #### データアクセス関数 次のデータアクセス関数を使用して、その他のデータ要素を取得できます。
GetString | GetString(ListBox) | テキスト文字列を返します。
画像 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 | PlotCircle | シンタックス:PlotCircle(円.X,円.Y,円.半径,名前,色,表示) 画像に円を表示します。 #### 入力
パラメータ | 説明
--- | ---
円 | 表示する円の画像座標を指定します (-16777216 ～ 16777216)。
X | 円の中心の X 座標。
Y | 円の中心の Y 座標。
半径 | 円の半径。
名前 | グラフィックスとともに画像上に表示するテキストラベルを指定します。
色 | 表示するグラフィックスの色を指定します。(デフォルト: 0x32cd32、LimeGreen、最大: 0xffffff)
表示 | 画像上のグラフィックスオーバレイの表示モードを指定します。
0 = OFF | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、グラフィックスが表示されません。
1 = ON (デフォルト) | グラフィックスが常に表示されます。
#### 出力
戻り値 | グラフィックスを含む表示データ構造体。
PlotCross | シンタックス:PlotCro(十字.X,十字.Y,十字.角度,十字.高さ,十字.幅,名前,色,表示) 画像に十字を表示します。 #### 入力
パラメータ | 説明
--- | ---
十字 | 表示する十字の画像座標を指定します (-16777216 ～ 16777216)。
X | 十字の中心の X 座標。
Y | 十字の中心の Y 座標。
角度 | 十字の方向。
高さ | 十字の高さ。
幅 | 十字の幅。
名前 | グラフィックスとともに画像上に表示するテキストラベルを指定します。
色 | 表示するグラフィックスの色を指定します。(デフォルト: 0x32cd32、LimeGreen、最大: 0xffffff)
表示 | 画像上のグラフィックスオーバレイの表示モードを指定します。
0 = OFF | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、グラフィックスが表示されません。
1 = ON (デフォルト) | グラフィックスが常に表示されます。
#### 出力
戻り値 | グラフィックスを含む表示データ構造体。
PlotLine | シンタックス:PlotLine(ライン.X 0,ライン.Y 0,ライン.X 1,ライン.Y 1,名前,色,表示,始点の表示要素,終点の表示要素) 画像にラインセグメントを表示します。 #### 入力
パラメータ | 説明
--- | ---
ライン | 表示するラインの画像座標を指定します ()。
X 0 | ラインの始点の X 座標。
Y 0 | ラインの始点の Y 座標。
X 1 | ラインの終点の X 座標。
Y 1 | ラインの終点の Y 座標。
名前 | グラフィックスとともに画像上に表示するテキストラベルを指定します。
色 | 表示するグラフィックスの色を指定します。(デフォルト: 0x32cd32、LimeGreen、最大: 0xffffff)
表示 | 画像上のグラフィックスオーバレイの表示モードを指定します。
0 = OFF | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、グラフィックスが表示されません。
1 = ON (デフォルト) | グラフィックスが常に表示されます。
始点の表示要素 | ラインの始点の表示要素を指定します。
0 = なし (デフォルト)
1 = 矢印
終点の表示要素 | ラインの終点の表示要素を指定します。
0 = なし (デフォルト)
1 = 矢印
#### 出力
戻り値 | グラフィックスを含む表示データ構造体。
PlotPoint | シンタックス:PlotPoint(点.X,点.Y,名前,色,表示) 画像に点のクロスヘアを表示します。 #### 入力
パラメータ | 説明
--- | ---
点 | 表示する点の画像座標を指定します (-16777216 ～ 16777216)。
X | 点の X 座標。
Y | 点の Y 座標。
名前 | グラフィックスとともに画像上に表示するテキストラベルを指定します。
色 | 表示するグラフィックスの色を指定します。(デフォルト: 0x32cd32、LimeGreen、最大: 0xffffff)
表示 | 画像上のグラフィックスオーバレイの表示モードを指定します。
0 = OFF | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、グラフィックスが表示されません。
1 = ON (デフォルト) | グラフィックスが常に表示されます。
#### 出力
戻り値 | グラフィックスを含む表示データ構造体。
PlotString | シンタックス:PlotString(文字列,点.X,点.Y,色,表示) 画像上にテキスト文字列を表示します。 ヒント: PlotString 関数をスプレッドシートに挿入した後、この関数のスプレッドシートセルをハイライトし、[セルのフォーマット] ダイアログを使用して PlotString セルと表示されたテキスト文字列のフォント、フォントサイズ、およびフォントスタイルを設定します。 #### 入力
パラメータ | 説明
--- | ---
文字列 | 表示するテキスト文字列を指定します。
点 | 表示する文字列の画像座標を指定します (-16777216 ～ 16777216)。
X | 文字列の X 座標。
Y | 文字列の Y 座標。
色 | 表示するグラフィックスの色を指定します。(デフォルト: 0x32cd32、LimeGreen、最大: 0xffffff)
表示 | 画像上のグラフィックスオーバレイの表示モードを指定します。
0 = OFF | 関数を含んでいるセルがスプレッドシート内でハイライトされている場合を除き、グラフィックスが表示されません。
1 = ON (デフォルト) | グラフィックスが常に表示されます。
#### 出力
戻り値 | グラフィックスを含む表示データ構造体。
数値演算 | 論理演算 | And | シンタックス:And(値1, 値2, ...) 値の可変長リストの論理積を返します。
BitAnd | BitAnd(値1, 値2, ...) 値のビットごとの AND を返します。 注: 下位 16 ビットのみを処理します。 例 BitAnd(45, 77) は 13 を返します。 45 = 0000 0000 0010 1101 (2 進数)。 77 = 0000 0000 0100 1101 (2 進数)。 And 演算子を使用して、これら 2 つの 16 ビット 2 進数の共通ビットを個別に比較した結果は 0000 0000 0000 1101 で、これを 10 進数で表すと 13 になります。
BitNot | シンタックス:BitNot(値) 値をビットごとに反転させた結果を返します。 注: 下位 16 ビットのみを処理します。 例 BitNot(45) は 65490 を返します。 45 = 0000 0000 0010 1101 (2 進数)。 0 を 1、1 を 0 に反転した結果は 2 進数では 1111 1111 1101 0010 で、これを 10 進数で表すと 65490 になります。
BitOr | シンタックス:BitOr(値1, 値2, ...) 値のビットごとの OR を返します。 注: 下位 16 ビットのみを処理します。 例 BitOr(45, 77) は 109 を返します。 45 = 0000 0000 0010 1101 (2 進数)。 77 = 0000 0000 0100 1101 (2 進数)。 Or 演算子を使用して、これら 2 つの 16 ビット 2 進数の共通ビットを個別に比較した結果は 0000 0000 0110 1101 で、これを 10 進数で表すと 109 になります。
BitXor | シンタックス:BitXor(値1, 値2, ...) 値のビットごとの XOR (排他的 OR) を返します。(排他的論理和 ビットのいずれか 1 つのみが TRUE の場合、結果は TRUE です。2 つ以上のビットが等しい場合、結果は FALSE です。) 注: 下位 16 ビットのみを処理します。 例 BitXor(45, 77) は 96 を返します。 45 = 0000 0000 0010 1101 (2 進数) 77 = 0000 0000 0100 1101 (2 進数)。 次のように、45 と 77 で共通ビットではないのは 0110 0000 のみです。
45 | 77 | ビット単位の XOR | XOR ビット
--- | --- | --- | ---
0 | 0 | 2 個の 0 ≥ XOR FALSE | 0 (FALSE)
0 | 1 | 1 を 1 つのみ ≥ XOR TRUE | 1 (TRUE)
1 | 0 | 1 を 1 つのみ ≥ XOR TRUE | 1 (TRUE)
0 | 0 | 2 個の 0 ≥ XOR FALSE | 0 (FALSE)
1 | 1 | 2 個の 1 ≥ XOR FALSE | 0 (FALSE)
1 | 1 | 2 個の 1 ≥ XOR FALSE | 0 (FALSE)
0 | 0 | 2 個の 0 ≥ XOR FALSE | 0 (FALSE)
1 | 1 | 2 個の 0 ≥ XOR FALSE | 0 (FALSE)
0110 0000 = 96 (10 進数)
If | シンタックス:If(条件, 値1, 値2) 条件がゼロ以外の場合は値1 を返し、条件がゼロの場合は値2 を返します。 注: 条件または引数が空のセルを参照している場合、それらはゼロ (FALSE) と解釈されます。
InRange | シンタックス:InRange(値, 開始, 終了) Min(開始,終了) ≤ 値 ≤ Max(開始,終了) の場合、TRUE を返します。
InTolerance | シンタックス:InTolerance(実際の値, 予想された値, 許容範囲 %, マージン) 実際の値が予想された値の相対的な許容範囲内にあるかどうか、実際の値と予想された値の差がマージンを超えるかどうかを判定します。
Not | シンタックス:Not(値) 値がゼロ以外の場合は 0 を返し、値がゼロの場合は 1 を返します。(論理的反転) 例 Not(-12345) は 0 を返します。 Not(3.14) は 0 を返します。 Not(2-1) は 0 を返します。 Not(1-1) は1 を返します。
OneShot | シンタックス:OneShot(値) 今回の実行で値が 1 で、前の実行で 0 だった場合は、true を返します。
Or | シンタックス:Or(値1, 値2, ...) すべての値がゼロの場合は 0 を返し、ゼロ以外の値がある場合は 1 を返します。(論理和 値のいずれかが TRUE の場合、結果は TRUE です。) 例 Or(45, -77) は 1 を返します。 Or(-1, 0, 1) は 1 を返します。 Or(0, 1-1) は 0 を返します。
ルックアップ関数 注: 関数の引数がテキスト文字列を必要とする場合、If、Switch、または Choose を直接使用して文字列を指定することはできません。無効なテキスト文字列の例: Len(If(...)) この問題を解決するには、If、Switch、または Choose を個別のセルに配置し、そのセルへの参照を作成します。またはシンタックス内の順序を変更します。「If(Len( ) )」を 1 つのセルに入力すると、有効なテキスト文字列を指定できます。 | Choose | シンタックス:Choose(インデックス, 値0, [値1, ...]) 可変長リストからインデックスで指定された引数の値を返します。
CountError | シンタックス:CountError(セル1, [セル2, ...]) 1 つ以上のセルまたはセル範囲でのエラーの数を返します。
ErrFree | シンタックス:ErrFree(セルまたはセル範囲) エラーの伝播を防止するため、#ERR を空のセルに変換します。
If | シンタックス:If(条件, 値1, 値2) テストがゼロ以外の場合は値1 を返し、テストがゼロの場合は値2 を返します。
MaxI | シンタックス:MaxI(値0、[値1、...]) 値の可変長リストから最大値のインデックスを返します。
MinI | シンタックス:MinI(値0、[値1、...]) 値の可変長リストから最小値のインデックスを返します。
NthMaxI | シンタックス:NthMaxI(N,値0,[値1,...]) 値の可変長リストから N 番目に大きい値のインデックスを返します。
NthMinI | シンタックス:NthMinI(N,値0,[値1,...]) 値の可変長リストから N 番目に小さい値のインデックスを返します。
Switch | シンタックス:Switch(FindCase, デフォルト, ケース0, 値0, [ケース1, 値1, ...]) FindCase に一致する最初のケースに対応する値を返します。インデックスで指定されたケースが FALSE の場合、指定のデフォルト値が返されます。式内の複数のケースが FindCase と一致する場合、一致する最初のケースに対応する値が返されます。 Switch の例 A4 = Switch(A2,-1,2, "C",3, "B",A3, "A") セル A2 = 2 の場合、セル A4 に返される値は C です。 セル A2 = 3 の場合、セル A4 に返される値は B です。 セル A2 = 5 の場合、セル A4 に返される値はデフォルトの -1 です。これは、FindCase と一致するケースが式内にないためです。
X | シンタックス:X(セル) スプレッドシートセルの X 座標の数を返します。
Y | シンタックス:Y(セル) スプレッドシートセルの Y 座標の数を返します。 注: Y A = 0.0 および Y Z = 25.0
算術関数 | Abs | シンタックス:Abs(値) 値の絶対値を返します。
Exp | シンタックス:Exp(値) e の指定した値の累乗を返します。
Mod | シンタックス:Mod(値1, 値2) 値1 を値2 で除算した余りを返します。
Power | シンタックス:Power(基数, 指数) 基数の指定した指数の累乗を返します。
Rand | シンタックス:Rand(イベント) 入力イベントで乱数 (0.0 ～ 1.0) を返します。各イベントで新しい乱数が生成されます。 注: Rand 関数はセル内で唯一の項目である必要があります。
Round | シンタックス:Round(値) 最も近い整数に丸めた値を返します。
RoundDown | シンタックス:RoundDown(値) 小数部を切り捨てて、次に小さい整数にした値を返します。
RoundUp | シンタックス:RoundUp(値) 小数部を切り上げて、次に大きい整数にした値を返します。
Sqrt | シンタックス:Sqrt(値) 値の平方根を返します。
Sum | シンタックス:Sum(値1, [値2, ...]) 値の可変長リストの合計を返します。
Trunc | シンタックス:Trunc(値) 小数部を切り捨てて、ゼロ方向の近い整数にした値を返します。結果の値には小数部がありません。
演算子 注: 特定のスニペットがスプレッドシートに挿入されるとき、[ジョブの編集] ツールバーに表示される式に、!、&&、||、==、<>、>=、<=、!= などの文字が含まれる場合があります。これらの文字は、以下の論理および比較演算子の代替コードです。 | NOT | シンタックス: ! 論理否定
AND | シンタックス: && 論理積
OR | シンタックス: || 論理和
等しい | シンタックス: == 等しい
等しくない | シンタックス: <> (または !=) 等しくない
等値 | シンタックス: = 等値
非等値 | シンタックス: <> 非等値
より大きい | シンタックス: > より大きい
未満 | シンタックス: < 未満
以上 | シンタックス: >= 以上
以下 | シンタックス: <= 以下
パーセンテージ | シンタックス: % パーセンテージ
加算 | シンタックス: + 加算
減算 | シンタックス: - 減算
乗算 | シンタックス: * 乗算
除算 | シンタックス: / 除算
統計 | ComputeStats | シンタックス:ComputeStats 参照値の統計を計算します。
Max | シンタックス:Max(値0, [値1, ...]) 値の可変長リストから最大値を返します。
Mean | シンタックス:Mean(値0, [値1, ...]) 値の可変長リストの平均を返します。
Min | シンタックス:Min(値0, [値1, ...]) 値の可変長リストから最小値を返します。
NthMax | シンタックス:NthMax(N, 値0, [値1, ...]) 値の可変長リストから、N 番目に大きな値を返します。
NthMin | シンタックス:NthMin(N, 値0, [値1, ...]) 値の可変長リストから、N 番目に小さな値を返します。
SDev | シンタックス:SDev(値0, 値1, [値2, ...]) 値の可変長リストのバイアスを含めた標準偏差 (分母は N-1) を返します。
SDevUnbiased | シンタックス:SDevUnbiased(値0, 値1, [値2, ...]) 値の可変長リストのバイアスを除外した標準偏差 (分母は N) を返します。
三角関数 | ACos | シンタックス:ACos(値) 値の逆余弦を度単位で返します。 注: -1 ≤ 値 ≤ 1
ASin | シンタックス:ASin(値) 値の逆正弦を度単位で返します。 注: -1 ≤ 値 ≤ 1
ATan | シンタックス:ATan(値) 値の逆正接を度単位 (±90) で返します。
ATan2 | シンタックス:ATan2(DY,DX) ベクトル (x,y) = (DY,DX) の逆正接を度単位 (±180) で返します。
Cos | シンタックス:Cos(角度) 角度の余弦を度単位で返します。
Degrees | シンタックス:Degrees(ラジアン) ラジアン単位の角度値を度単位で返します。
Pi | シンタックス:Pi 円周率 ≈ 3.142 の値を返します。
Radians | シンタックス:Radians(度) 度単位の角度値をラジアン単位で返します。
Sin | シンタックス:Sin(角度) 角度の正弦を度単位で返します。
Tan | シンタックス:Tan(角度) 角度の正接を度単位で返します。
構造体 | Circle | シンタックス:Circle(フィクスチャ.X,フィクスチャ.Y,フィクスチャ.角度,円.X,円.Y,円.半径,表示) フィクスチャされた円構造体を作成します。 #### 入力 注: フィクスチャおよび円パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
パラメータ | 説明
--- | ---
フィクスチャ | 円を定義する画像座標系を指定します。
X | X オフセット。
Y | Y オフセット。
角度 | 角度
円 | 円のサイズおよび位置をフィクスチャ座標で指定します。
X | 円の x オフセット。
Y | 円の y オフセット。
半径 | 円の半径 (1 ～ 16777216、デフォルト = 100)。
表示 | 画像上の円のグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | Circle 関数を含んでいるセルがスプレッドシートでハイライトされている場合を除き、円構造体は表示されません。
2 = 入力のグラフィックスのみ | 円構造体が常に表示されます。
#### 出力
戻り値 | 円データ構造体。入力パラメータが無効であれば #ERR を返します。
結果 | Circle 関数が初めてセルに挿入されると、スプレッドシートに結果テーブルが作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X | GetX(円) | 画像座標系での円の中心の X オフセット。
Y | GetY(円) | 画像座標系での円の中心の Y オフセット。
半径 | GetRadius(Circle) | 円の半径。
Fixture | シンタックス:Fixture(フィクスチャ.X,フィクスチャ.Y,フィクチャ.角度,表示 フィクスチャ構造体を作成します。 #### 入力
パラメータ | 説明。
--- | ---
フィクスチャ | フィクスチャを定義する画像座標系を指定します。
X | X オフセット。
Y | Y オフセット。
角度 | 角度
表示 | 画像上のフィクスチャポイントのグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | Fixture 関数を含んでいるセルがスプレッドシートでハイライトされている場合を除き、フィクチャポイントのグラフィックスは表示されません。
2 = 入力のグラフィックスのみ | フィクチャポイントのグラフィックスは常に表示されます。
#### 出力
戻り値 | フィクスチャデータ構造体。いずれかの入力パラメータが無効な場合は #ERR を返します。
結果 | Fixture 関数が初めてセルに挿入されると、スプレッドシートに結果テーブルが作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X | GetX(フィクスチャ) | フィクスチャの X オフセットを画像座標系で返します。
Y | GetY(フィクスチャ) | フィクスチャの Y オフセットを画像座標系で返します。
角度 | GetAngle(フィクスチャ) | 方位角を画像座標系で返します。
Line | シンタックス:Line(フィクスチャ.X,フィクスチャ.Y,フィクスチャ.角度,ライン.X 0,ライン.Y 0,ライン.X 1,ライン.Y 1,表示) フィクスチャされたライン構造体を作成します。 #### 入力 注: フィクスチャおよびラインパラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
パラメータ | 説明
--- | ---
フィクスチャ | ラインを定義する画像座標系を指定します。
X | X オフセット。
Y | Y オフセット。
角度 | 角度
ライン | ラインの始点と終点を指定します。
X 0 | 始点の X オフセット。
Y 0 | 始点の Y オフセット。
X 1 | 終点の X オフセット。
Y 1 | 終点の Y オフセット。
表示 | 画像上のラインのグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | Line 関数を含んでいるセルがスプレッドシートでハイライトされている場合を除き、ライン構造体は表示されません。
2 = 入力のグラフィックスのみ | ライン構造体が常に表示されます。
#### 出力
戻り値 | ラインデータ構造体。いずれかの入力パラメータが無効な場合は #ERR を返します。
結果 | Line 関数が初めてセルに挿入されると、スプレッドシートに結果テーブルが作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X0 | GetX(ライン, 0) | 画像座標系の始点の X オフセット。
Y0 | GetY(ライン, 0) | 画像座標系の始点の Y オフセット。
X1 | GetX(ライン, 1) | 画像座標系の終点の X オフセット。
Y1 | GetY(ライン, 1) | 画像座標系の終点の Y オフセット。
Point | シンタックス:Point(フィクスチャ.X,フィクスチャ.Y,フィクスチャ.角度,点.X,点.Y,表示) フィクスチャされた点構造体を作成します。 #### 入力
パラメータ | 説明
--- | ---
フィクスチャ | 点を定義する画像座標系を指定します。
X | X オフセット。
Y | Y オフセット。
角度 | 角度
点 | 点の位置をフィクスチャ座標系で指定します。
X | 十字の x オフセット。
Y | 十字の y オフセット。
注: フィクスチャおよび点パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
表示 | 画像上の点のオーバレイグラフィックスの表示モードを指定します。
0 = 非表示 (デフォルト) | Point 関数を含んでいるセルがスプレッドシートでハイライトされている場合を除き、点構造体は表示されません。
2 = 入力のグラフィックスのみ | 点構造体は常に表示されます。
#### 出力
戻り値 | 点データ構造体。いずれかの入力パラメータが無効な場合は #ERR を返します。
結果 | Point 関数が初めてセルに挿入されると、スプレッドシートに結果テーブルが作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X | GetX(点) | 画像座標系での、点の X オフセット。
Y | GetY(点) | 画像座標系での、点の Y オフセット。
Region | シンタックス:Region(フィクスチャ.X,フィクスチャ.Y,フィクスチャ.角度,領域.X,領域.Y,領域.高さ,領域.幅,領域.角度,領域.カーブ,表示) フィクスチャされた領域構造体を作成します。 #### 入力 注: [フィクスチャ] および [領域] パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
パラメータ | 説明
--- | ---
フィクスチャ | 領域を定義する画像座標系を指定します。
X | X オフセット。
Y | Y オフセット。
角度 | 角度
領域 | 位置、サイズ、回転、カーブ (円状またはリング状の円環領域の場合) を指定します。領域は、常にフィクスチャの座標系内で定義されます。
X | フィクスチャ座標での原点の X オフセット
Y | フィクスチャ座標での原点の Y オフセット
高さ | 領域の X 軸に沿った寸法
幅 | 領域の Y 軸に沿った寸法
角度 | フィクスチャ座標での角度
カーブ | 領域の X 軸と反対側の境界線との間の角度変位
表示 | 画像上の領域のグラフィックスオーバレイの表示モードを指定します。
0 = 非表示 (デフォルト) | Region 関数を含んでいるセルがスプレッドシートでハイライトされている場合を除き、領域構造体のグラフィックスは表示されません。
2 = 入力のグラフィックスのみ | 領域構造体のグラフィックスが常に表示されます。
#### 出力
戻り値 | 領域データ構造体。いずれかの入力パラメータが無効な場合は #ERR を返します。
結果 | Region 関数が初めてセルに挿入されると、スプレッドシートに結果テーブルが作成されます。
#### データアクセス関数 結果テーブルを作成するため、次のデータアクセス関数がスプレッドシートに自動挿入されます。
X | GetX(構造体, [インデックス1], [インデックス2]) | X 座標を返します。 注: インデックス2 (エッジのみ) は端点を指定します (0 または 1)。インデックス2、ReadIDMax はシンボルの角を指定します。
Y | GetY(構造体, [インデックス1], [インデックス2]) | Y 座標を返します。 注: インデックス2 (エッジのみ) は端点を指定します (0 または 1)。インデックス2、ReadIDMax はシンボルの角を指定します。
高さ | GetHigh(領域) | 領域の X 軸に沿った寸法
幅 | GetWide(領域) | 領域の Y 軸に沿った寸法
角度 | GetAngle(領域) | 画像座標での角度
カーブ | GetCurve(領域) | 領域の X 軸と反対側の境界線との間の角度変位
テキスト | 文字列 | Code | シンタックス:Code(テキスト) 文字列の最初の文字の ASCII コードに対応する整数値を返します。 Code の例 セル A2 に「ABC123」という英数字文字列が含まれている場合、関数 Code(A2) は 65.000 を返します。これは「A」の ASCII コードです。
Concatenate | シンタックス:Concatenate(引数1, [引数2, 引数3, ...]) 複数の英数字テキスト文字列を連結した文字列を返します。数値引数は、自動的にテキストに変換されます。 注: In-Sight 2000-110/120/120C ビジョンセンサは出力データとして合格/不合格データのみを返し、戻り値は 0 または 1 に変換されます。 Concatenate の例 セル A2 に英数字列「A1B1」が含まれ、セル A3 に英数字列「C1D2」が含まれ、セル A4 に浮動小数点数 4.556 が含まれている場合、関数 Concatenate(A2,A3,A4) は「A1B1C1D24.556」を返します。
Exact | シンタックス:Exact(テキスト1, テキスト2) テキスト1 とテキスト2 が同じ場合は 1 を返し、同じでない場合は 0 を返します。 注: Exact 関数は大文字と小文字を区別します。 Exact の例 セル A2 に文字列「ABC123」が含まれ、セル A3 に文字列「ABC1234」が含まれている場合、関数 Exact(A2,A3) は 0.000 を返します。 セル A2 に文字列「VISION」が含まれ、セル A3 に文字列「VISION」が含まれている場合、関数 Exact(A2,A3) は 1.000 を返します。
Find | シンタックス:Find(FindText, SrcText, [StartChar]) 文字列テキスト2 に含まれている文字列テキスト1 のインデックスで指定された位置を返します。テキスト1 の検索は、テキスト2 内のオプションで指定された StartChar 位置から開始されます。 注: Find 関数は大文字と小文字を区別します。 Find の例 セル A2 に文字列「123」が含まれ、セル A3 に文字列「ABC123」が含まれている場合、関数 Find(A2,A3,2) は (ゼロから始まる) インデックス値 3.000 を返します。 関数 Find(A2,A3,4) は -1.000 を返します。これは、検索がインデックス 4 で開始されると、文字列「123」全体を文字列「ABC123」内で見つけることができないためです。
Left | シンタックス:Left(テキスト, NumChars) テキスト文字列の左端の文字を NumChars で指定した文字数だけ返します。 Left の例 セル A2 に英数字文字列「ABC123」が含まれている場合、関数 Left(A2,2) は文字列「AB」を返します。
Len | シンタックス:Len(テキスト) テキスト文字列の文字数 (バイト単位) を返します。 Len の例 セル A2 に英数字文字列「ABC123」が含まれている場合、関数 Len(A2) は整数値 6.000 を返します。
Lower | シンタックス:Lower(テキスト) 小文字に変換されたテキストを返します。 Lower の例 セル A2 に英数字文字列「ABC123」が含まれている場合、関数 Lower(A2) は文字列「abc123」を返します。
Mid | シンタックス:Mid(テキスト, StartChar, NumChars) 英数字文字列内のインデックスで指定された StartChar の位置から始まるテキストを、NumChars で指定された文字数だけ返します。 Mid の例 セル A2 に英数字文字列「ABC123」が含まれている場合、関数 Mid(A2,2,2) は文字列「C1」を返します。
Replace | シンタックス:Replace(SrcText, StartChar, NumChars, NewText) インデックスで指定された位置 StartChar から NewText で変更された SrcText を返します。 Replace の例 セル A2 に英数字文字列「ABC123」が含まれ、セル A3 に文字列「123」が含まれている場合、関数 Replace(A2,0,3,A3) は文字列「123123」を返します。
Right | シンタックス:Right(テキスト, NumChars) テキスト文字列の右端の文字を NumChars で指定された文字数だけ返します。 Right の例 セル A2 に文字列「ABC123」が含まれている場合、関数 Right(A2,2) は文字列「23」を返します。
Strcspn | シンタックス:Strcspn(SrcText, CharList) SrcText の中で、CharList にも含まれている最初の文字のインデックスを返します。SrcText の文字が CharList にない場合、この関数は SrcText の長さを返します。 注: Strcspn 関数は大文字と小文字を区別します。 Strcspn の例 セル A2 に文字列「BLUE」が含まれ、セル A3 に文字列「RED」が含まれている場合、Strcspn(A2,A3) は、インデックス値 3.000 を返します。それは「E」が CharList にも含まれている SrcText の最初の文字だからです。
Stringf | シンタックス:Stringf(フォーマット文字列, [テキストまたは値, ...]) "C" ライブラリの標準フォーマット文字列で構成されたテキスト文字列を返します。 ヒント: FormatString 関数はほとんどのフォーマット文字列パラメータをサポートしています。[FormatString] ダイアログを使用すると、In-Sight Explorer 内でパラメータが自動的に設定されます。 注: In-Sight 2000-110/120/120C ビジョンセンサは出力データとして合格/不合格データのみを返し、戻り値は 0 または 1 に変換されます。 フォーマット文字列は引用符 (") で囲む必要があります。 フォーマット文字列のパラメータには大文字と小文字の区別があります。 Stringf 関数を使用する場合、バックスラッシュ「\」を使用して、その後にフォーマット制御文字が続くことを示します。バックスラッシュの後に制御文字 (「n」、「r」、または「t」) が続かない場合、バックスラッシュは無視されます。1 つのバックスラッシュを表示するには、2 つのバックスラッシュを入力する必要があります (例: Stringf("C:\\InSight2\\") = "C:\InSight2\")。 印字不可/制御コードの ASCII 文字は記号で、または「文字化け」して表示されます。 使用可能なフォーマット文字列パラメータは以下のとおりです。
%c | 整数値に対応する ASCII 文字を返します。英数字テキスト文字列が指定された場合、最初の文字を返します。 Stringf の %c パラメータの例 セル A2 に整数値 65.000 が含まれている場合、Stringf("%c",A2) は文字「A」を返します。これは、ASCII コード 65 に対応する文字です。関数 Stringf("Value = %c",A2) は文字列「Value = A」を返します。 セル A2 に文字列「123ABC」が含まれている場合、Stringf("%c",A2) は文字「1」を返します。
%d | 整数値を含む文字列を返します。 Stringf の %d パラメータの例 セル A2 に浮動小数点値 123.456 が含まれている場合、Stringf("%d",A2) は数字文字列「123」を返します。関数 Stringf("Value = %d",A2) は、英数字文字列「Value = 123」を返します。 セル A2 に文字列「ABC123」が含まれている場合、Stringf("%d",A2) は数字文字列「65」を返します。これは、文字「A」の ASCII コードです。
%e | 指数表記値を含む文字列を返します。小数点以下の桁数は、% と e の各パラメータの間に小数点 (.) と数値を入力して指定できます。 Stringf の %e パラメータの例 セル A2 に浮動小数点値 123.456 が含まれている場合、Stringf("%e",A2) は数値文字列「1.234560e+02」を返します。関数 Stringf("%.1e",A2) は数値文字列「1.2e+02」を返します。これは、小数点の後に数値 1 が指定されているためです。
%f | 浮動小数点値を含む文字列を返します。小数点以下の桁数は、% と f の各パラメータの間に小数点 (.) と数値を入力して指定できます。 Stringf の %f パラメータの例 セル A2 に浮動小数点値 123.456 が含まれている場合、Stringf("%f",A2) は数値文字列「123.456001」を返します。関数 Stringf("%.1f",A2) は数値文字列「123.5」を返します。これは、小数点の後に数値 1 が指定されているためです。
%H | In-Sight センサの特定のホスト名を含む文字列を返します。 Stringf の %H パラメータの例 ホスト名が「is3k010203」である In-Sight センサで関数 Stringf("Host Name: %H") がセルに含まれている場合、この関数は、英数字文字列「Host Name: is3k010203」を返します。
%I | In-Sight センサの特定の IP アドレスを含む文字列を返します。 Stringf の %I パラメータの例 IP アドレスが「198.232.26.1」の In-Sight センサで関数 Stringf("IP Address: %I") がセルに含まれている場合、この関数は、英数字文字列「IP Address:198.232.26.1」を返します。
%M | In-Sight センサの特定のメディアアクセス制御 (MAC) アドレスを含む文字列を返します。MAC アドレスは、ネットワークの特定のノードを識別するためのハードウェアアドレスです。すべての In-Sight ビジョンシステムには、工場出荷時に固有の MAC アドレスが割り当てられており、変更できません。例: 00-d0-24-01-02-03。In-Sight ビジョンシステムの MAC アドレスを調べるには、ビジョンシステムに貼られたシリアル番号ラベルをご覧ください。または、[In-Sight Explorer について] ダイアログを表示することもできます。 Stringf の %M パラメータの例 MAC アドレスが「00-d0-24-01-02-03」の In-Sight センサで関数 Stringf("MAC Address: %M") がセルに含まれている場合、この関数は、英数字文字列「MAC Address: 00:d0:24:01:02:03」を返します。
%N | In-Sight センサの特定のシリアル番号を含む文字列を返します。 Stringf の %N パラメータの例 シリアル番号が「Z01020304」の In-Sight センサで関数 Stringf("Serial Number: %N") がセルに含まれている場合、この関数は、英数字文字列「Serial Number:Z01020304」を返します。
%o | 整数の 8 進数値を含む文字列、または英数字文字列の最初の文字を含む文字列を返します。 Stringf の %o パラメータの例 セル A2 に整数値 123.000 が含まれている場合、Stringf("%o",A2) は数値文字列「173」を返します。これは、整数 123 の 8 進数値です。セル A2 に文字列「ABC123」が含まれている場合、Stringf("%o",A2) は数値文字列「101」を返します。これは、文字「A」の 8 進数値です。
%s | 英数字が追加された文字列を返します。 Stringf の %s パラメータの例 セル A2 に文字列「ABC」が含まれている場合、Stringf("%s123",A2) は英数字文字列「ABC123」を返します。セル A2 に数値文字列「123」が含まれている場合、Stringf("%s.450",A2) は数値文字列「123.450」を返します。
%T | In-Sight センサの特定のモデルタイプを含む文字列を返します。 Stringf の %T パラメータの例 In-Sight 5400 センサで関数 Stringf("Model Type: %T") がセルに含まれている場合、この関数は、英数字文字列「Model Type: 5400」を返します。
%u | 符号なし整数値を含む文字列を返します。 Stringf の %u パラメータの例 セル A2 に浮動小数点値 123.456 が含まれている場合、Stringf("%u",A2) は数値文字列「123」を返します。関数 Stringf("Value = %u",A2) は英数字文字列「Value = 123」を返します。 セル A2 に文字列「ABC123」が含まれている場合、Stringf("%u",A2) は数値文字列「65」を返します。これは、文字「A」の ASCIIコードです。
%V | In-Sight センサの特定のファームウェアバージョンを含む文字列を返します。 Stringf の %V パラメータの例 ファームウェアバージョン 3.40.01 を実行している In-Sight センサで関数 Stringf("Firmware Version: %V") がセルに含まれている場合、この関数は英数字文字列「Firmware Version:3.40.01 (475)」を返します。
%x または %X | 整数値の 16 進数値を含む文字列、または英数字文字列の最初の文字を返します。 Stringf の %x パラメータの例 セル A2 に整数値 123.000 が含まれている場合、Stringf("%x",A2) は文字列「7b」を返します。これは、整数 123 の 16 進数値です。セル A2 に文字列「ABC123」が含まれている場合、Stringf("%x",A2) は数値文字列「41」を返します。これは、文字「A」の 16 進数値です。
次のフォーマット文字列パラメータは主に、テキストのフォーマットに使用されます。例えば、WriteSMTP 関数で電子メールメッセージのテキストのフォーマットに使用されます。
\x## | 16 進数値 ## で指定された ASCII 文字をテキストに挿入します。 Stringf の \x## パラメータの例 セル A2 に Stringf("\x02123\x1bABC\x03456") が含まれている場合、そのセルには (「<STX>123<ESC>ABC<ETX>456」) が表示されます。
\n | テキストにラインフィードを挿入します。このパラメータは通常、\r (キャリッジリターン) と一緒に使用されます。
\r | テキストにキャリッジリターンを挿入します。このパラメータは通常、\n (ラインフィード) と一緒に使用されます。
\t | テキストにタブを挿入します。
Strspn | シンタックス:Strspn(SrcText, CharList) SrcText の中で、CharList に含まれていない最初の文字のインデックスを返します。SrcText のすべての文字が CharList にもある場合、この関数は SrcText の長さを返します。 注: Strspn 関数は大文字と小文字を区別します。 Strspn の例 セル A2 に文字列「RED」が含まれ、セル A3 に文字「GREEN」が含まれている場合、Strspn(A2,A3) は (ゼロから始まる) インデックス値 2.000 を返します。それは、「D」が CharList に含まれていない、SrcText の最初の文字だからです。
Strtol | シンタックス:Strtol(IntegerText) 英数字文字列の先頭にある数字 (10 進数、16 進数、8 進数) を整数に変換します。16 進数文字は「0x」で始まり、8 進数文字は「0」で始まる必要があります。 Strtol の例 10 進数:セル A2 にテキスト文字列「123ABC」が含まれている場合、関数 Strtol(A2) は整数値 123.000 を返します。 16 進数:セル A2 にテキスト文字列「0x123」が含まれている場合、Strtol(A2) は整数値 291.000 を返します。 「A」と「B」は 16 進数文字であるため、「0x12AB」は 4,779.000 になります。 「G」は 16 進数文字ではないため、「0x12GB」は 18.000 になります。 8 進数:セル A2 にテキスト文字列「0123ABC」が含まれている場合、Strtol(A2) は整数値 83.000 を返します。
Substitute | シンタックス:Substitute(SrcText, OldText, NewText, [インスタンス]) SrcText 内に現れる OldText をすべて NewText に置換して作成したテキスト文字列を返します。オプションのインスタンスインデックスを指定すると、そのインスタンスのテキストのみが置換されます。 Substitute の例 セル A2 にテキスト文字列「ABC123123」が含まれ、セル A3 に文字列「123」が含まれ、セル A4 に文字列「abc」が含まれている場合、Substitute(A2,A3,A4,1) は SrcText の 2 番目のインスタンス「123」を置換し、文字列「ABC123abc」を返します。
Token | シンタックス:Token(テキスト、デリミタ、インスタンス) デリミタで区切られた文字列の中で、指定したインスタンスインデックスにある (出現した) テキストを返します。この関数内でデリミタは必ず引用符 (") で囲む必要があります。 Token の例 セル A2 にコンマ区切り文字列「A,B,C,1,2,3」が含まれている場合、Token(A2,",",2) は「C」を返します。それは、C がテキスト内のインデックス 2 にあるからです。
Trim | シンタックス:Trim(テキスト) テキストから先頭と末尾のスペースを除き、単語の間にスペースがある場合はそのスペース 1 つだけを残したテキストを返します。制御文字 (キャリッジリターン、ラインフィードなど) もすべて除去されます。 Trim の例 セル A2 に文字列「 ABC 123 」が含まれている場合、Trim(A2) は文字列「ABC 123」を返します。
Upper | シンタックス:Upper(テキスト) テキストを大文字に変換して返します。 Upper の例 セル A2 に英数字文字列「abc123」が含まれている場合、関数 Upper(A2) は文字列「ABC123」を返します。
Value | シンタックス:Value(NumericText) NumericText の浮動小数点値を返します。後続の数値以外の文字は無視されます。 Value の例 セル A2 に数値文字列「123.4」が含まれている場合、関数 Value(A2) は浮動小数点値 123.400 を返します。 注: In-Sight のセルには、最大 7 桁の数値を入力することができます。Value 関数が 8 桁以上の数値テキストを参照している場合、浮動小数点データ型の制限により、値が正確でない場合があります。例を次に示します。 A2 = '68456668 A3 = Value(A2) この場合、この関数は 68456672.000 を返します。
データアクセス関数 | AutoLearnClassify | GetClassLabel | シンタックス:GetClassLabel(構造体, [インデックス], [モデル]) この関数を使用するには、クラスを追加してから各クラスに画像を追加します。 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 GetClassLabel は、各クラスに関連付けられた文字列を返します。
GetModelHealth | シンタックス:GetModelHealth(構造体) この関数を使用するには、クラスを追加してから各クラスに画像を追加します。 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 GetModelHealth は、モデルの「状態」を表す数字 (0 ～ 100) を返します。これは、モデルがどの程度正しいかを示します。
GetNClasses | シンタックス:GetNClasses(構造体) この関数を使用するには、クラスを追加してから各クラスに画像を追加します。 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 GetNClasses はクラス数を返します。
GetNImages | シンタックス:GetNImages(構造体, [インデックス], [モデル]) この関数を使用するには、クラスを追加してから各クラスに画像を追加します。 注: 現在の画像を指定するには、必ず「取り込み済み」キーワードを使用してください。 GetNImage は各クラスの画像数を返します。
Blobs | GetAngle | シンタックス:GetAngle(ブロブ, インデックス) 検査対象となる画像領域を定義する対象領域 (ROI) の中心に対する、ブロブの重心の角度を返します。 ブロブの重心は、そのブロブのバランスポイントを表します。均一な材料のシートをブロブの形状に切り取った場合にバランスがとれる点が重心です。ブロブの重心が、実際にブロブ自体の中にあるとは限りません。 例えば、次の画像の黒い領域が ExtractBlobs 関数が示すブロブだとします。赤い点はブロブの重心を表します。 重心の X 座標と Y 座標はそれぞれ、GetX および GetY データアクセス関数が返します。
GetArea | シンタックス:GetArea(ブロブ, インデックス) ブロブの面積 (ピクセル単位) を返します。 ブロブの面積は、ブロブ内に含まれるピクセル数をカウントして計算されます。例えば、次の図のようにブロブを拡大したとします。 ピクセル数をカウントすると、このブロブの面積は 8 ピクセルであることがわかります。
GetHeight | シンタックス:GetHeight(ブロブ, インデックス) インデックスで指定されたブロブの高さを返します。
CircleFit | GetDistance | シンタックス:GetDistance(CircleFit, インデックス) インデックスで指定された点と円の間の距離を返します。値が負の場合、点は円内にあります。インデックスで指定された点が無効な場合、#ERR が返されます。
GetMaxDist | シンタックス:GetMaxDist(CircleFit) 円と、円から最も遠い点との間の距離を返します。値が負の場合、点は円内にあります。
GetMaxDistIndex | シンタックス:GetMaxDistIndex(CircleFit) 円から最も遠い点のインデックスを返します。
GetNPointsUsed | シンタックス:GetNPointsUsed(CircleFit) 最適円の作成に使用された点の数を返します。
GetRadius | シンタックス:GetRadius(CircleFit) 円の半径を返します。
GetSigma | シンタックス:GetSigma(CircleFit) 点から円までの距離を点の数で除算した結果の二乗和の平方根を返します。
クロックドデータ関数 | GetCount | シンタックス:GetCount(Delay) Delay 構造体のカウント値を返します。
GetErrorCount | シンタックス:GetErrorCount(カウント) カウント構造体から増分エラー数を返します。エラー数は、返される値がゼロよりも小さい場合にカウントアップされます。
GetFailCount | シンタックス:GetFailCount(カウント) カウント構造体から増分不合格数を返します。不合格数は、返される値がゼロの場合にカウントアップされます。
GetPassCount | シンタックス:GetPassCount(カウント) カウント構造体から増分合格数を返します。合格数は、返される値がゼロよりも大きい場合にカウントアップされます。
GetTotalCount | シンタックス:GetTotalCount(カウント) カウント構造体から合格、不合格、およびエラーの総数を返します。
色 | GetActiveMatchClrColorName | シンタックス:GetActiveMatchClrColorName(色, インデックス) MatchColor 関数のインデックスで指定されたアクティブな色の名前を返します。
GetBlue | シンタックス:GetBlue(色) MatchColor 関数で対象領域 (ROI) 内の平均色の青成分を返します。
GetColorLibraryName | シンタックス:GetColorLibraryName(色構造体) TrainExtractColor、TrainMatchColor、ExtractColor、および MatchColor と共に使用します。TrainExtractColor および TrainMatchColor 関数の場合、その関数によって保存されたカラーライブラリの名前を返します。ExtractColor および MatchColor 関数の場合、参照された Train 関数 (TrainExtractColor、TrainMatchColor など) の名前を返します。
GetConfidenceScore | シンタックス:GetConfidenceScore(色) MatchColor 関数の現在の検査の信頼性得点を返します。信頼性得点 = ( s1 * (M - s2) - s2 * (M - s1)) / ( (M - s2) + (M - s1))。ここで、s1 は最高点、s2 は 2 番目に高い得点、M は定数 1.01 です。信頼性得点が高いほど、最適一致が選択された可能性が高くなります。
GetGreen | シンタックス:GetGreen(色) MatchColor 関数の ROI 内の平均色の緑成分を返します。
GetHue | シンタックス:GetHue(色) MatchColor 関数の ROI 内の平均色の色相成分を返します。
GetIntensity | シンタックス:GetIntensity(色) MatchColor 関数の ROI 内の平均色の明度成分を返します。
GetMatchClrColorByRank | シンタックス:GetMatchClrColorByRank(色, ランク) MatchColor 関数のランク (0 ～ n-1) と一致する色のインデックスを返します。ランク 0 の色の得点が最高点です。
GetMatchClrColorState | シンタックス:GetMatchClrColorState(色, ColorName) MatchColor 関数の指定された色の状態を返します。
GetMatchClrDistByIndex | シンタックス:GetMatchClrDistByIndex(色, インデックス) MatchColor 関数のインデックスで指定された色の色差を返します。
GetMatchClrDistByName | シンタックス:GetMatchClrDistByName(色, 名前) MatchColor 関数の名前付きの色の色差を返します。
GetMatchClrScoreByIndex | シンタックス:GetMatchClrScoreByIndex(色, インデックス) MatchColor 関数のインデックスで指定された色の得点を返します。
GetMatchClrScoreByName | シンタックス:GetMatchClrScoreByName(色, 名前) MatchColor 関数の名前付きの色の得点を返します。
GetNActiveMatchClrColors | シンタックス:GetNActiveMatchClrColors(MatchColorLib) 参照されている MatchColor 関数でアクティブな、参照されている色の数を返します。
GetNTrainMatchClrColors | シンタックス:GetNTrainMatchClrColors(MatchColorLib) TrainMatchColor 関数によって保存された色の数を返します。
GetRed | シンタックス:GetRed(色) MatchColor 関数の ROI 内の平均色の赤成分を返します。
GetSaturation | シンタックス:GetSaturation(色) MatchColor 関数の ROI 内の平均色の彩度成分を返します。
GetTrainMatchClrColorName | シンタックス:GetTrainMatchClrColorName(MatchColorLib, インデックス) MatchColor 関数のインデックスで指定された保存済みの色の名前を返します。
SetMatchClrColorState | シンタックス:SetMatchClrColorState(色, 有効化, ColorName1, [ColorName2,...]) MatchColor 関数の有効な色、または無効な色の数を返します。この関数がスプレッドシートに初めて挿入されたとき、その関数のセルの状態は無効になっています。このセルは、Button 関数によって条件付きで有効にする必要があります。
オペレータ I/F | GetString | シンタックス:GetString(ListBox) テキスト文字列を返します。ListBox 関数を含んでいるセルが参照されている場合、現在リストから選択されているテキスト文字列が返されます。
距離 | GetDistance | シンタックス:GetDistance(距離) 距離値を返します。
GetErrorCode | シンタックス:GetErrorCode(構造体) GetErrorCode は、大部分の構造体および関数から診断コードを返すデータアクセス関数です。 注: #ERR に対応するエラーコードがない場合、GetErrorCode は -1 を返します。
GetErrorString | シンタックス:GetErrorString(構造体) GetErrorString は、大部分の構造体および関数から診断情報を返すデータアクセス関数です。
GetValue | シンタックス:GetValue(構造体,[インデックス],[色]) ここで、構造体は、ColorHist、Delay、またはヒストグラムの各データ構造体を含んでいるセルへの参照です。 インデックスはオプションで、ヒストグラム値をカウントする階層を指定します (ColorHist およびヒストグラムのみ)。 色はオプションで、ヒストグラムデータを抽出する色成分を指定します (ColorHist のみ)。 GetValue は、次の構造体から情報を返すデータアクセス関数です。 ColorHist Delay ヒストグラム
入力/出力 | GetClock | シンタックス:GetClock(時間, フォーマット文字列, [ローカル/GMT]) 現在の日付と時刻を、Now 関数によって返される時間データ構造体から、「C」ライブラリ標準フォーマット文字列を使用して構成された文字列として返します。
フォーマット文字列 | 日時を表示するフォーマットを指定します。デフォルトのフォーマット文字列は「月/日/年 時:分:秒」で、これは「%m/%d/%Y %H:%M:%S」として表されます。 次の変数を使用できます。
%m | 月
%d | 日
%Y | 年
%H | 時
%M | 分
%S | 秒
%3N | ミリ秒
%6N | マイクロ秒
%9N | ナノ秒
ローカル/GMT | 0 = 夏時間を考慮したローカル時刻 (デフォルト) 1 = GMT (UTC) 2 = 標準時のローカル時刻
エッジ検査 | GetWidth | シンタックス:GetWidth(InspectEdgeWidth, キャリパインデックス) インデックスで指定されたキャリパ内のエッジの幅を返します。インデックスで指定されたキャリパ内でエッジが検出されなかった場合は 0 を返します。
Linefit | GetChi2 | シンタックス:GetChi2(LineFit) 点とラインの間の距離の二乗和を返します。
GetDistance | シンタックス:GetDistance(LineFit,インデックス) インデックスで指定された点とラインの間の距離を返します。
GetMaxDist | シンタックス:GetMaxDist(LineFit) ラインから最も遠い点を返します。
GetMaxDistIndex | シンタックス:GetMaxDistIndex(LineFit) ラインから最も遠い点のインデックスを返します。
GetNPointUsed | シンタックス:GetNPointUsed(LineFit) ラインの計算に使用された点の数を返します。
GetX | シンタックス:GetX(構造体, [インデックス1], [インデックス2]) X 座標を返します。
GetY | シンタックス:GetY(構造体, [インデックス1], [インデックス2]) Y 座標を返します。
スクリプト | Get | シンタックス:Get(Script/Get,オブジェクトプロパティと配列の両方またはいずれか,[配列インデックス]) Script 関数または別の Get 関数によって出力された配列/オブジェクトのプロパティを返します。 注: この関数は、In-Sight 5.1.0 以降を搭載している In-Sight ビジョンシステムでのみ使用可能です。 #### 概要 Script 関数によって返されたオブジェクトのプロパティにアクセスするには、Get 関数を使用します。少なくとも 2 つの引数が必要です。1 つは Script 関数、あるいはオブジェクトまたは配列を返す別の Get 関数への参照です。もう 1 つは、オブジェクトのプロパティを表す文字列、またはサブオブジェクトのプロパティを指すドットで区切られたパスです。オプションで、配列を参照する場合にゼロから始まる配列インデックスにアクセスするための 3 番目の引数を指定できます。 Get 関数の戻り値は、プロパティの値 (またはインデックスで指定された配列要素) であり、次のいずれかの型です。 数値 true (1) または false (0) 文字列 バイナリデータ構造体 ブロブ、エッジ、ヒストグラム、IDMax、またはパターンのデータ構造体 形状オブジェクト オブジェクトまたは配列のデータ構造体 注: Get 関数で null または未定義を返すことはできません。 #### Get の例 この例では、セル B3 の Script 関数に、オブジェクトを返す実行メソッドがあります。
    Tool.prototype.run = function(n) {
      this.updateStats(n);
      return {
        total: this._total;
    	stats: {
    	  avg: this._avg,
    	  range: {
    	    max: this._max,
    	    min: this._min
    	  },
    	  values: this._valueArray
    	}
       };
    };
次の Get 関数は単純な数値を返します (戻り値が数値であることを前提とします)。 Get(B3, "total") Get(B3, "stats.avg") Get(B3, "stats.range.max") Get(B3, "stats.range.min") 次の Get 関数は「range」サブオブジェクトを返します。戻り値は別の Script 関数または Get 関数に渡すことができます。 Get(B3, "stats.range") 次の Get 関数は値の配列から要素 37 を返します。 Get(B3, "stats.values", 37) #### 入力
パラメータ | 説明
--- | ---
Script/Get | オブジェクトまたは配列のデータ構造体を返す Script 関数または別の Get 関数への参照を指定します。
オブジェクトプロパティと配列の両方またはいずれか | オブジェクトデータ構造体のプロパティへの参照を、文字列 (プロパティ名) またはサブオブジェクトのプロパティへのドット区切りパスとして指定するか、配列データ構造体として指定します。
[配列インデックス］ | 配列データ構造体を参照する場合に、配列のインデックスに対する引数をオプションで指定します。
#### 出力
戻り値 | この関数は、プロパティの値 (またはインデックスで指定された配列要素) を、次のいずれかの型で返します。 数値 true (1) または false (0) 文字列 バイナリデータ構造体 ブロブ、エッジ、ヒストグラム、IDMax、またはパターンのデータ構造体 形状オブジェクト オブジェクトまたは配列のデータ構造体
注: この関数が、Script 関数から null ステートメント、未定義ステートメント、または戻り値なしステートメントを返すことはありません (これらは空のオブジェクトと同様に処理されます)。
統計 | GetLatest | シンタックス:GetLatest(統計) 統計の計算に使用された最新の値を返します。
GetMax | シンタックス:GetMax(統計) 統計の計算に使用された最大値を返します。
GetMean | シンタックス:GetMean(統計) 値の平均値を返します。
GetMin | シンタックス:GetMin(統計) 統計の計算に使用された最小値を返します。
GetErrorCount | シンタックス:GetErrorCount(統計) 参照値からエラーの総数を返します。
GetNumSamples | シンタックス:GetNumSamples(統計) 計算に使用されたサンプルの総数を返します。
GetRange | シンタックス:GetRange(統計) 最小値と最大値の間の範囲を返します。
GetSDev | シンタックス:GetSDev(統計) 値の標準偏差を返します。
GetSum | シンタックス:GetSum(統計) 値の合計を返します。
GetVariance | シンタックス:GetVariance(統計) 値の分散を返します。
構造体 注: 次の関数の構造体引数は、Annulus、Circle、Cross、Fixture、Line、Mask、Point、または Region 関数から返されたデータ構造体への参照である必要があります。各関数の有効な構造体については以下で説明します。 | GetCurve | シンタックス:GetCurve(構造体) インデックスで指定された領域構造体からカーブ値を返します。
GetNPoints | シンタックス:GetNPoints(構造体) GetNPoints はポリゴンを処理し、点の数を返します。
Timer | GetAllTime | シンタックス:GetAllTime(画像) 画像の取り込みおよびジョブの実行に必要な時間をミリ秒単位で返します。入力値が無効であった場合は、#ERR が返されます。 注: この引数には、直近に取り込まれた画像を表す「取り込み済み」キーワードを使用する必要があります。 返される GetAllTime 値には、センサフィルムストリップの実行時間は含まれません。 GetAllTime 関数とステータスバーは、時間の計算方法が [ジョブのプロファイル] ダイアログ とは異なります。[ジョブのプロファイル] ダイアログでも結果グラフィックスの生成は考慮されます。 この関数を数式で使用すると、セルの位置に応じて戻り値が異なります。例えば、GetAllTime(A0) が 80 の場合、1*GetAllTime(A0) も 80 になる必要があります。しかし、1*GetAllTime(A0) を含んでいるセルがジョブの先頭にある場合、この関数は他のツールの実行時間を含まない GetTime(A0) とほぼ同じ値を返します。1*GetAllTime(A0) がジョブの最後にある場合は、すべてのジョブ実行時間が含まれます。正しい値を返すためには、GetAllTime(A0) 用にセルを個別に作成し、数式内ではそのセル参照を使用してください。例えば、GetAllTime(A0) 関数をセル B2 に作成すると、1*B2 は、セルの位置に関係なく正しい値を返します。 [HMI の設定] ダイアログの [最大ビュー接続数] 設定が 2 以上に設定されている場合、In-Sight ファームウェア 5.x.x を使用しているビジョンシステムからの GetAllTime 戻り値は、In-Sight ファームウェア 4.x.x を使用しているビジョンシステムの戻り値より長くなります。In-Sight ファームウェア 5.x.x を実行しているビジョンシステムの GetAllTime 戻り値には、画像取り込み時間とジョブ実行時間に加え、最終値に複数のビュー更新時間が加算されますが、In-Sight ファームウェア 4.x.x を実行しているビジョンシステムではこの値は加算されません。
GetTime | シンタックス:GetTime(セル 1, [セル 2, ...]) 可変長リストまたはセルの実行に必要な時間をミリ秒単位で返します。入力値が無効であった場合は、#ERR が返されます。複数のセルを選択した場合、実行時間の合計が返されます。