4.7 データ作成ライブラリ

本プログラムにはデータ作成ライブラリが添付しています。
これはC言語のプログラムを作成して入力データを出力するためのライブラリです。
以下のような用途に使用します。

1. データの数が多く規則的であるとき
2. 座標値が互いに関連しており一か所を変えるとたくさんのデータが連動して変わるとき
3. パラメーターを変えて繰り返し計算するとき

ファイル構成
datalibフォルダにデータ作成ライブラリのソースコード(omm_datalib.c) とヘッダーファイル(omm_datalib.h)があります。
ユーザーがプログラムを作成するときはomm_datalib.hをincludeし、 コンパイル時にomm_datalib.cを追加して下さい。

関数一覧
表4-7-1に関数一覧を示します。
関数については以下の規則があります。

1. 関数名はすべて小文字で"omm_"で始まります。
2. 引数のうち実数はすべてdoubleです。
3. 単位はすべてMKSA単位系です。角度の単位は度です。
4. 関数の呼び出し順は、最初がomm_init、最後がomm_outdataです。 その他の関数の呼び出し順は任意ですが、表の順に呼ぶことを推奨します。
5. 必須関数とオプション関数があります。必須関数は濃い色で表示しています。 オプション関数を呼び出さないときは既定値が設定されます。
6. 複数回呼び出すことができる関数があります。そのときは複数個のデータが出力されます。
7. 一度だけ呼び出せばよい関数を複数回呼び出したときは最後の呼び出しが有効になります。

サンプルプログラム
リスト4-7-1にデータ作成ライブラリを使用したサンプルプログラムを示します。

リスト4-7-1 データ作成ライブラリ用サンプルプログラム

/*
sample1.c

OpenMOMデータ作成ライブラリ、サンプルプログラム No.1

コンパイル+実行:
Windows + VC++:
> cl.exe /O2 sample1.c omm_datalib.c
> sample1.exe
Linux + gcc:
$ gcc -O sample1.c omm_datalib.c -o sample1
$ ./sample1
*/

#include "omm_datalib.h"

int main(void)
{
	// initialize

	omm_init();

	// title

	omm_title("sample1");

	// geometry

	omm_geometry_zline(-25e-3, +25e-3, 0e-3, 0e-3, 25);  // dipole
	omm_feed(1, 0);

	// frequency

	omm_frequency(2e9, 3e9, 10);

	// current distribution

	//omm_plotcurrent(1, 1);

	// frequency char.

	omm_plotsmith();
	omm_plotzin(1, 0, 0, 0);
	omm_plotyin(1, 0, 0, 0);
	omm_plotref(1, 0, 0, 0);

	// far0d field

	//omm_plotfar0d(90, 0, 1, 0, 0, 0);

	// far1d field

	//omm_plotfar1d('X', 180, 0);

	//omm_far1dstyle(0);
	//omm_far1dcomponent(1, 0, 0);
	//omm_far1ddb(1);
	//omm_far1dnorm();
	//omm_far1dscale(-30, +10, 4);

	// far2d field

	//omm_plotfar2d(18, 36);

	//omm_far2dcomponent(1, 0, 0, 0, 0, 0, 0);
	//omm_far2ddb(1);
	//omm_far2dscale(-20, +10);
	//omm_far2dobj(0.5);

	// near1d field

	//omm_plotnear1d("E", +50e-3, +50e-3, 0e-3, 0e-3, -50e-3, +50e-3, 100);

	//omm_near1ddb(1);
	//omm_near1dscale(-30, +20, 5);

	// near2d field

	//omm_plotnear2d("E", 'X', 10e-3, -50e-3, +50e-3, -50e-3, +50e-3, 20, 20);

	//omm_near2ddb(1);
	//omm_near2dscale(-30, +20);
	//omm_near2dcontour(0);
	//omm_near2dobj(1);

	// output

	omm_outdata("sample1.omm");

	return 0;
}

コンパイル・実行方法
データ作成ライブラリを使用したソースコードをコンパイル・実行する方法は以下の通りです。

Windows+VC++の場合

> cl.exe /O2 sample1.c omm_datalib.c
> sample1.exe

$ gcc -O sample1.c omm_datalib.c -o sample1
$ ./sample1

リスト4-7-2 データ作成ライブラリの出力サンプル

OpenMOM 4 0
title = sample1
geometry = 1 13 -0.025 0.025 0 0 25
feed = 1 0
frequency = 2e+09 3e+09 10
z0 = 50
geom3dnode = 0.05 1 0
plotsmith = 1
plotzin = 1
plotyin = 1
plotref = 1
end