ほとんどの組み込みXファンクションはデフォルトでLabTalkから呼び出すことができます。つまり、コマンドウィンドウ、 スクリプトウィンドウ、ツールバーボタン、ワークシートに埋め込まれたスクリプト、ボタンに埋め込まれたスクリプトなど、LabTalkスクリプトを実行できるところならどこでもXファンクションを呼び出すことができます。
各Xファンクションには、int、double、string、range、さらにはtreeなど、さまざまなデータ型の独自の入力変数と出力変数のセットがあります。
<xfunction> -<option1> option1value -<option2> option2value var1:=value1 var2:=value2 ....
ここでは、Xファンクションsmoothを使用してXファンクションを呼び出す方法を紹介します。
smooth -h
smooth -help
smooth m:=1
smooth method:=1
smooth method:=1
smooth method:=sg
smooth -r 1 method:=1 npts:=5
smooth method:=1 -r 1 npts:=5
smooth //smooth on active plot or selected data with all default smoothing settings
smooth m:=2 //アクティブプロットまたは選択されたデータを方式2でスムージング
smooth npt:=7 //アクティブプロットをデフォルトの方式1でスムージング、ただしウィンドウのポイント数は7とする
smooth (1,2) 2 //iy:= is skipped, method:= is skipped. It's same as smooth iy:=(1,2) method:=2
smooth (1,2) method:=2 //iy:= はスキップされる。smooth iy:=(1,2) method:=2 と同様
smooth -d //opens smooth dialog with all default settings.
smooth method:=2 -d //方式が方式2に設定されたスムージングダイアログを開く
smooth -db //opens smooth dialog with default settings and the dialog is docked to the left of active window
smooth -u // X-Function become undoable, i.e. you can undo by Ctrl + Z or select Undo from Edit menu
Xファンクションでファイルのメタデータを参照できます。スクリプトウィンドウ(ウィンドウ:スクリプトウィンドウ)を開き、次のように入力します。
page.info.=
これにより、Xファンクションの実行時に使用できるユーザー変数を含む、ファイルメタデータのリストがダンプされます。
rnormalize -r 2 method:=specify val:=page.info.USER.VARIABLES.NOOFPOINTS; // runs the X-Function rnormalize, dividing values in the selected column by the value of page.info.USER.VARIABLES.NOOFPOINTS.
スクリプトウィンドウに変数をダンプする代わりに、ファイルをインポートしたワークシート列の右側の灰色の部分で右クリックしてオーガナイザを表示することも可能です。page.infoを展開して、ノード上で右クリックしノードパスをコピーするを選択します。
Xファンクションが呼び出された後、入力または出力に関係なく、変数値にアクセスできます。一部のXファンクション出力は、ツリー変数に入れてからアクセスする必要があります。ここでは、いくつかの簡単な例のみを示します。
smooth.= //gives all variables and corresponding values
smooth.method= //方式の番号を与える
stats.= //gives all output values
stats.min= //計算された平均値を与える
レポートツリーにアクセスするには、例えばANOVAの場合、XファンクションGetresultsを使用します。
既存の操作の構成ツリーを取得するには、Xファンクション Op_changeを使用します。
コマンドウィンドウ(ウィンドウ:コマンドウィンドウ)を使用して、Xファンクションを呼び出す方法を簡単に学ぶことができます。コマンドウィンドウではXファンクション名、オプション、変数を自動入力できます。 次をお試しください。
![]() |
|
Xファンクションの変数設定はテーマファイルに保存できます。Xファンクションを呼び出し、-themeまたは-tオプションを使用して、テーマファイルに保存された設定を使用できます。
例:
1. smooth -t mytheme //Do smoothing with mytheme
2. smooth -t mytheme -d; // mythemeがロードされたスムージングダイアログを開く
いくつかのXファンクションには、Xファンクションスクリプトを生成するためのスクリプトの生成コンテキストメニューがあります。
smooth -r 1 method:=fft;
最初に述べたように、ほとんどのX関数はLabTalkで呼び出すことができます。呼び出しを禁止するには、
Note: 組み込みXファンクションの上書き保存はできません。ユーザ定義Xファンクションとして保存する必要があります。ユーザファイルフォルダとシステムフォルダに同じ名前のXファンクションがある場合、ユーザファイルフォルダの下にあるXファンクションが使用されます。