ワークシートクエリ

Wks-Query

ワークシートクエリメニューコマンドはOriginにユーザー指定の条件式に基づいてアクティブワークシート内のデータを検索するように指示します。見つけられたデータ値は、（ａ）別のワークシートに抽出される（例：値がコピーされて貼り付けられる）か、または（ｂ）条件を満たすセルが選択されるかまたは特定の色で塗りつぶされます。

2つのメインパネル（「左パネル」と「右パネル」と呼びます）に加えて、ファイル（クエリの保存と読み込み）、スクリプト（データの前処理用）、および関数（挿入用）のメニューバーがあります。

簡単なチュートリアル

1. インポートウィザードを使って、\Samples\Data Manipulation\US Metropolitan Area Population.datをインポートします。インポート先のワークシートには場所は以下の4列が含まれています。: (Population, Sq.Mi., Density, and Metropolitan Area)
2. メニューのワークシート： ワークシートクエリを選び、ワークシートクエリダイアログボックスを開きます。
3. 左パネルのSq.Miの前にあるチェックボックスのチェックを外し、この列が抽出結果に含まれないようにします。
4. 選択条件ボックスに次の条件式を入力します。A-N-Dと入力せずに、AND ボタンをクリックすることもできます。

   C>100 AND D[i]$ == "* CA*"

   この条件で、列ショートネーム = "C"の100を超える密度での、カリフォルニアの領域（ "CA"）の列ショートネーム "D"を調べます。このツールは、文字列内の*などのワイルドカード記号をサポートしています。

5. テスト - 条件に合えば選択ボタンをクリックします。選択条件ボックスの下に見つかった行の数が更新され、ワークシート内の一部の行が強調表示されていることに注意してください。
6. 出力から "新しいワークシートに抽出" ラジオボタンを選択し、OK ボタンをクリックします。抽出された結果はソースワークブックの新しいワークシートにコピーされ、 "Sq。Mi"ファイルにコピーされます。 ステップ3で除外した列は出力に含まれませんでした。

Origin 2019bより前では、名前ではなく別名を使用してデータの列を参照していました。別名は引き続き使用できます--ワークブックでスプレッドシートのセル表記がオフになっている場合は、使用する必要があります。詳細については、スプレッドシートのセル表記、エイリアスの使用、および列の命名に関する注意 を参照してください。

ワークシートクエリダイアログボックスを開いて、実行する

ワークシートクエリツールを開くには:

1. ワークシートをアクティブにします。
2. メニューからワークシート：　ワークシートクエリを選択します。

選択条件ボックスに条件を入力したら、OKまたは適用ボタンをクリックしてクエリを実行します。

左パネル

左側のパネルには、アクティブなワークシートのすべての列とそれらに関する基本情報が一覧表示されます。列の抽出のボックスをオンまたはオフにして、どの列を抽出するかを決定します。

左側のパネルを右クリックしてショートカットメニューからコンポーネントを選択または有効にすることで、各列に表示する情報を制御できます。

右パネル

右側のパネルには、条件編集ボックス、出力コントロール、およびその他のコントロールがあります。

Ifテストの列変数を選択

ダイアログボックスのこの部分は、次のいずれかが当てはまる場合にのみ表示されます（参照）。

• ワークブックでスプレッドシートのセル表記がオフになっています。この場合、ワークブックの左上隅にこのアイコンが表示されます。
• ワークブックでスプレッドシートセル表記がオンになっていますが、ワークシートクエリダイアログボックスの右上隅にある別名を使用ボックスをチェックすることを選択しました。

別名を使用している場合は、左側のパネルで列を選択してから、ボタンを使用してそれらを列をテスト用の列変数の選択リストに移動します。列を移動すると、条件を定義するときに、列の名前またはインデックスの代わりに使用できる別名が作成されます。

選択条件

ワークシートクエリツールは、ユーザーが定義した条件式に従って、ワークシート内のデータを選択、抽出、または色分けするために使用されます。条件式を選択条件テキストボックスに入力します。

• 条件を構築するときは、式の中でワークシート列を参照するときに、ワークシート列の別名、列のショートネーム、またはロングネーム（Col（ 「ロングネーム」））を使用できます。
• 行番号を表示するには i 変数を使います。
• 次のラインにエクスプレッションを続けるには、Enter　をクリックします。

たとえば、列Aの値が0より大きい行を抽出するには、次のように入力します。

A>0

または、

Col(A)>0

列Aに対して、例えば「Temperature」という別名を指定していれば、次のように使うことができます。

 Temperature > 0

テキストの条件を使ってワークシートのデータを抽出するには、次のシンタックスを使います。

Col(ColumnName)[i]$ == "text";

例えば、

Col(Station)[i]$ == "Northwest";

可能な操作

式の作成には、以下にリストされている論理演算子および関係演算子のいずれかを使用できます。さらに、任意の算術演算子（+、 - 、*、/、^）を使用できます。

ボタン

これらのボタンの使用はオプションです（要素を直接選択条件ボックスに入力できます）が、これらのボタンを使用するといくつかのキーストロークを節約できます。

ボタン	使用方法
	式に列変数と条件を追加するために使用されます。 別名を使用している場合は、追加をクリックする前に上の列の選択...フィールドで別名/列を強調表示すると、別名が列変数フィールドに登録されます。
	選択条件ボックスで式の一部または全部を強調表示し、削除をクリックして削除します。
	「AND」を条件文に追加.
	「OR」を条件文に追加.
	「NOT」を条件文に追加.
	「左括弧」を条件文に追加
	「右括弧」を条件文に追加
	このボタンをクリックして、テストを実行します。条件に合うデータが見つかったら、見つかった結果の数がワークシートクエリダイアログの見つかった行:に表示され、結果の行が元のワークシートで選択されます。

行番号(i): 開始 - 終了 -

分割する行範囲を指定します。

出力

• 再計算 の制御

  このドロップダウンオプションは、元データや条件が変更されたときに結果をどう更新するか指定します。なしは更新なし、自動は自動更新、手動は手動で更新します。再計算の詳細については、分析結果の再計算を参照してください。

• 条件が満たされる場合に出力されるものを指定します。

ダイアログメニュー

ファイル

スクリプト

データクエリの前に実行されるLabTalkスクリプトを設定します。これは条件検索のための適切なデータを準備するのに役立ちます。データループ選択前に実行するスクリプトで、If条件の前に実行するスクリプトを設定できます。

Originは実際には以下のようにデータクエリルーチンを実行します。

1. データループを選択する前にスクリプトを実行します。
2. ユーザーが指定した開始値と終了値で定義されたすべての行をループします。行番号がiである各列に対して、
   1. IF条件の前のスクリプト を実行します。
   2. 行iのデータについて条件をテストします。
   3. 条件が真であればデータを抽出します。
   4. 抽出完了
3. ループ終了

2列あるとします。Col（a）にはデータがあります。Ｃｏｌ（ｂ）は、Ｃｏｌ（ａ）から抽出されるセルの行番号として使用される３つの数を含みます。

データループ選択前に実行するスクリプトを次のようにセットします。

j=1;

If条件前のスクリプトを実行します。

if( i == col(b)[j] )
{
	temp = col(a)[i];
	j++;
}

次の条件でワークシートのデータを抽出します。

A == temp

テストボタンをクリックすると、Originは行1, 4, 7を選択します。

制御条件またはloopスクリプトをロードする簡単な方法があります。データループ選択前に実行するスクリプト ボックスまたは、 IＦ条件前に実行するスクリプト ボックスでスクリプトを実行する場合、編集ボックスを右クリックし、メニューの下部にある条件/ループ を選択し、条件構造やループ構造を選択します。シンタックスは簡単なコメントでカーソルに追加されます。

関数

クエリ条件を構築するために、いくつかの分類されたリストから関数を挿入することができます。 最近使った関数は最近使用したものサブメニューから利用できます。この関数メニューは、値の設定ダイアログボックスにあるメニューと同じです。

これらの関数は、LabTalk 関数 と 組み込みOrigin C関数を含みます。

関数選択にユーザ定義関数を追加する方法については、値の設定ダイアログでユーザ定義ユーザ定義関数を作成する方法をご覧ください。

関数についての詳細は、LabTalkがサポートしている関数を参照してください。

また、事前定義変数 サブメニューから、事前に定義した変数や、クエリ条件を使用出来ます。使用できる変数と定数に関しては こちら をご参照ください。