数式の記述方法

1. 基本
2. 使用可能なキーワード
3. 数式ヘッダ
4. 使用例 -- ファイル読込み関数
5. 使用例 -- 文字列の読込みと表示
6. CalcEngineバージョン履歴

１．基本

次の例のように数式が複数個となる場合は、各数式を@ で区切り、最後の数式に、y=を付けます。
x=<::>でループ変数の範囲を指定します。最初から、初期値、最大値、ステップ値の３つの値が入ります。
ここで、abc、defはユーザ定義変数、piは登録定数です。（ユーザ定義変数と登録定数は、英字のみ、もしくは英字＋数字（文字数制限なし）です。）

x = < -2*pi: 2*pi: 0.01*pi > @
abc = 2 * x @
def = 3 * x @
y = sin( abc ) + cos( def )

だだし、次の例のように数式が一つの場合はy=が省略できます（ByeGraphでは必須）。

2+3*(log(sin(2*pi^2))+6.8)

変数={,,,}でパラメータを指定します（最大16個まで指定可）。各パラメータには、ユーザ定義変数や関数を含む事ができます。
ここで、sitaはユーザ定義定数、kRadは登録定数です。

x = < 0: 360: 1 > @
sita = { 0, 45, 90 } @
y = sin( kRad * ( x + sita ) )

２．使用可能なキーワード

３．数式ヘッダ

数式ヘッダは、数式の前に記述して、数式や計算結果に対するオプション的な働きをします。

４．使用例 -- ファイル読込み関数

ファイル読込み関数を数式に組み入れることで、実験等で得られた生データに対して、各種の計算処理を加える事ができます。ファイル読込み関数には、シーケンシャルにデータを読込むfread関数とランダムにデータを読込むfread2関数があります。下記は、fread関数の使用例です。

【例】Ｘデータ、Ｙデータを共に読み出し、Ｘデータより 2*pi*x を計算して、その２乗をＹデータに乗じます。

	0.0 1  2
	0.1 2  4
	0.2 3  6
	0.3 4  8
	0.4 5 10
	:   :  :

データをfread関数で読込むため、 ループ変数xの範囲指定（x=<::>）は不要です。（繰り返しの数は対象ファイルの行数により決まります。）

! フォーマット指定
%format f e
x = fread(0) @
omg = 2*pi*x @
w = { 1, 2 } @
y = fread(w)*omg^2

結果は下記の通りです。

	0.0  0.000e+00 0.000e+00
	0.1  7.896e-01 1.579e+00
	0.2  4.737e+00 9.475e+00
	0.3  1.421e+01 2.842e+01
	0.4  3.158e+01 6.317e+01
	 :         :         :

５．使用例 -- 文字列の読込みと表示

バージョン1.8より文字列の読込みが可能となりました。これはその使用例です。

【例】ファイル中の５列目と６列目にラベル（文字列）のみ設定されているデータ列に、（ラベルはそのままにして）計算によって新たに列データを付け加えます。また、%statoutヘッダーにより、各列データの所定の統計データを算出します。

	Name    Math  English  Science  Total  Average
	JAMES     78      81      58
	MARY      68      83      63
	JOHN      72      77      71
	PATRICIA  91      68      69
	ROBERT    77      71      88
	LINDA     88      82      59
	MICHAEL   90      72      74
	BARBARA   69      71      58
	WILLIAM   78      79      63
	ELIZABETH 81      83      70
	DAVID     65      71      58
	JENNIFER  88      83      81

下の数式では、switch関数を使って、１行目（ループ変数#LOOP=0）ではラベルを、２行目以降では計算結果（２〜４列のデータの合計および平均）を切り替えて表示します。

%external "~/tmp/Grades.txt" 0
%statout avg max min n dev !各列データの所定の統計データを算出し、出力する
%format s d
x=fread(0)@
z=sum(fread(k),k=1:3)@
y={fread(1),fread(2),fread(3),
switch(#LOOP=0,fread(4):z),
switch(#LOOP=0,fread(5):z/3)}

結果は下記の通りです。

	Name      Math English Science Total Average
	JAMES       78      81      58   217      72
	MARY        68      83      63   214      71
	JOHN        72      77      71   220      73
	PATRICIA    91      68      69   228      76
	ROBERT      77      71      88   236      79
	LINDA       88      82      59   229      76
	MICHAEL     90      72      74   236      79
	BARBARA     69      71      58   198      66
	WILLIAM     78      79      63   220      73
	ELIZABETH   81      83      70   234      78
	DAVID       65      71      58   194      65
	JENNIFER    88      83      81   252      84
	--------- ---- ------- ------- ----- -------
	N           12      12      12    12      12
	AVG         79      77      68   223      74
	DEV          9       6      10    16       5
	MAX         91      83      88   252      84
	MIN         65      68      58   194      65

６．CalcEngineバージョン履歴

CalcEngineは、CalcLoop、CalcLoop Plus、ByeGraphで用いられている、数式処理のためのライブラリです。