Debian Codegraph @

doc/html/ja/tutorial.html

raw
1 <!DOCTYPE html>
2 <html lang="ja">
3 <head>
4 <meta charset="UTF-8">
5 <link rel="stylesheet" href="../ngraph.css" media="screen" type="text/css"/>
6 <link rel="icon" href="../ngraph.svg" />
7 <title>Tutorial</title>
8 </head>
9 <body>
10 <div class="toc">
11 <a name="TOP">&nbsp;</a>
12 <h1><a href="./ngraph.html">チュートリアル</a></h1>
13 <ul>
14 <li><a href="#VIEW">外観</a>
15 <li><a href="#GRAPH">グラフ作成の概略</a>
16 <li><a href="#SCALE">軸のスケール</a>
17 <li><a href="#PLOT">プロット方法</a>
18 <li><a href="#LEGEND">グラフを飾りづける</a>
19 <li><a href="#OUTPUT">グラフの印刷・保存・読込、ファイルへの出力</a>
20 <li><a href="#FIT">フィッティング</a>
21 <li><a href="#MATH">数式変換機能を使う</a>
22 <li><a href="#MULTI">複数のグラフ</a>
23 <li><a href="#DECIMALSIGN">小数点記号の扱い</a>
24 </ul>
25 </div>
26
27 <div class="chapter">
28 <h2><a name="VIEW">外観</a></h2>
29 <ol>
30 <li><h3>起動画面</h3>
31 <p>
32 Ngraph を起動すると下図のウィンドウが開かれます。
33 </p>
34 <p>
35 <img src="./tutorial/window.png" WIDTH="526" HEIGHT="351" ALT="">
36 </p>
37 <p>
38 ここでは、簡単にウィンドウの説明をします。
39 </p>
40 <ul>
41 <dl>
42 <dt> コントロールボタン(上部)
43 <dd> 通常のウィンドウアプリケーションと同様に、ファイルのオープン
44 など頻繁に使うメニューコマンドがボタンに割り当てられています。
45 <dt> コントロールボタン(左サイド)
46 <dd> マウスによる操作モードを指定するトグルボタン列です。グラフィッ
47 クスオブジェクトの選択モード、レジェンド種類別の作成モード、
48 プロットされたデータの評価モード、画面の拡大縮小モードなどを
49 切り替えます。
50 <dt> サイドバー
51 <dd> <p>グラフの右に表示され、上部にデータや軸などを一覧表示する
52 タブ、下部にマウスカーソル位置やフィッティングの情報を表示す
53 る場所があります。タブの順番・位置はドラッグ&ドロップで自由
54 に変更できます。</p>
55 <dl>
56 <dt> Data タブ
57 <dd> <p> 開かれたデータファイルが一覧表示されます。また、プ
58 ロットの為の各種パラメターも一覧表示されます。このリス
59 トをダブルクリックするとデータダイアログボックスが開き、
60 各種設定を変更する事ができます。</p>
61 <dt> Axis タブ
62 <dd> <p>座標軸の名前と、スケールの数値などの各種パラメター
63 が一覧表示されます。このリストをダブルクリックすると軸
64 ダイアログボックスが開き、各種設定を変更する事ができま
65 す。</p>
66 <dt> Merge タブ
67 <dd> <p>合成ファイルと各種パラメターが一覧表示されます。こ
68 のリストをダブルクリックすると合成ダイアログボックスが
69 開き、各種設定を変更する事ができます。</p>
70 <dt> Parameter タブ
71 <dd> <p>parameter オブジェクト作成・設定や、値の変更などを
72 行います。</p>
73 <dt> Path, Rectangle, Arc, Mark, Text タブ
74 <dd> <p>各レジェンドを一覧表示します。このリストをダブルク
75 リックすると各レジェンドのダイアログボックスが開き、各
76 種設定を変更する事ができます。</p>
77 <dt> Coordinate 表示
78 <dd> <p>グラフのマウスカーソルの位置が表示されます。
79 また、座標軸が有る場合にはマウスカーソルの位置に対応す
80 る軸の座標も表示されます。</p>
81 <dt> Information 表示
82 <dd> <p>フィットの結果等が表示されます。</p>
83 </dl>
84 </dl>
85 </ul>
86 </ol>
87
88 <h2><a name="GRAPH">グラフ作成の概略</a></h2>
89 <ol>
90 <li><h3>データファイルを用意する</h3>
91 <p>
92 Ngraphはデータファイルからデータを読み込みグラフを作成します。
93 従って、まずデータファイルを用意しなければなりません。
94 エディター、計算プログラム、あるいは測定装置コントロールソフトなどからデータファイルを作成します。
95 </p>
96
97 <li><h3>グラフの種類を決める</h3>
98 <p>
99 グラフにするデータファイルを用意したらNgraphを起動します。次に作成
100 したいグラフの種類を決めます。
101 Ngraphでは以下の3つに分類されています。
102 </p>
103 <table border="1">
104 <tr>
105 <td align=CENTER><img src="./tutorial/graphf.png" WIDTH="185" HEIGHT="185" ALT=""></td>
106 <td align=CENTER><img src="./tutorial/graphs.png" WIDTH="185" HEIGHT="185" ALT=""></td>
107 <td align=CENTER><img src="./tutorial/graphc.png" WIDTH="185" HEIGHT="185" ALT=""></td>
108 </tr>
109 <tr>
110 <td>フレームグラフ(Frame graph)<br>4つの軸で囲まれたグラフ</td>
111 <td>方眼グラフ(Section graph)<br>4つの軸で囲まれ、方眼線の入ったグラフ</td>
112 <td>交差グラフ(Cross graph)<br>X-Y2軸のグラフ</td>
113 </tr>
114 </table>
115 <p>
116 初期状態ではフレームグラフが一つ作成されています。
117 フレームグラフの4つの軸のスケールはまだ設定されていませんので、軸の基線を示す枠だけが表示されています。
118 これで良ければ次に進みます。
119 他の種類のグラフを作成するには、[グラフ]-[新規作成]([Graph]-[New graph])メニューで作成するグラフの種類を指定します。
120 </p>
121
122 <li><h3>データファイルを開く</h3>
123 <p>
124 次に、準備してあるデータファイルを開きます。
125 データファイルを開くには様々な方法が有りますが、
126 取り敢えず[データ]-[追加]メニューを選び、
127 ファイル選択のダイアログボックスでデータファイルを開いてください。
128 </p>
129 <p>
130 データファイルを開く方法は他にも用意されています。
131 </p>
132 <ol>
133 <li>下図のコントロールボタンを押す。
134 <p>
135 <img src="../img/fopen.png" ALT="file open control button">
136 </p>
137 <li>Data タブ上でマウス右ボタンを押してポップアップメニューを出し、"追加(A)" メニューを選ぶ。
138 <li>ファイルマネージャー等からデータファイルを選び、グラフまたは
139 Data タブ上にドラッグ&amp;ドロップする。
140 </ol>
141 <p>
142 いずれの方法でも、
143 データファイルを指定すると次いでプロット方法などを指定するデータダイアログボックスが開きますが、
144 取り敢えず OK で閉じてください。
145 </p>
146
147 <li><h3>描画する</h3>
148 <p>
149 グラフを再描画するには下図のボタンを押してください(再描画が必要な場合はアイコンが変化し注意を促します)。
150 </p>
151 <p>
152 <img src="../img/draw.png" ALT="">
153 </p>
154 <p>
155 描画する方法は他にも用意されています。
156 </p>
157 <ol>
158 <li>[表示]-[描画]([View]-[Draw])メニューを選択する。
159 <li>グラフ上でクリックしてスペースキーを押す。
160 </ol>
161 <p>
162 この様にして描画すると軸のスケールは少し余白をとるように自動的に設定され、グラフが描画されます。
163 </p>
164 </ol>
165
166 <h2><a name="SCALE">軸のスケール</a></h2>
167 <ol>
168 <li><h3>スケールを変える</h3>
169 <p>
170 特にスケール (座標軸の上限・下限)を設定せずに描画した場合にはオートスケールで値が決められます。
171 また Axis タブには軸が一覧表示されています。
172 フレームグラフの場合には軸は4つあり、それぞれ "fX1", "fY1", "fU1", "fR1" と名前が付いています。
173 これらの軸のスケールを変更するには、下図の様に Axis タブの一覧から変更したい軸を選んでダブルクリックしてください。
174 <p>
175 <img src="./tutorial/awindow.png" WIDTH="578" HEIGHT="222" ALT="">
176 </p>
177 <p>
178 軸ダイアログボックスを開く方法は他にも用意されています。
179 </p>
180 <ol>
181 <li>[軸]-[設定] ([Axis]-[Update]) メニューでプ変更したい軸を選ぶ。
182 <li>下図ボタンのいずれか一方
183 (どちらでも良いです)を押してグラフィックスオブジェクト選択モード
184 (あるいは軸のみの選択モード)にしてグラフ上で軸をダブルクリックし、
185 次いで出てくるダイアログボックスで変更したい軸のボタンを押す。
186 <p>
187 <img src="../img/axispo.png" ALT="">
188 </p>
189 </ol>
190 <p>
191 この様にすると下図の軸ダイアログボックスが開かれます。
192 ここで、「最小値」「最大値」「増分」に軸のスケールの最小,最大,増分を指定してください。
193 目盛数字は増分に対して付けられます。
194 「分割数」は「増分」をさらに何等分して目盛線を引くかを決めます。
195 この値が0の時は自動的に分割数が決められます。
196 「スケール法」では通常の線形軸(linear)、ログ(log)、逆数(inverse)、MJD の中から1つを選ぶ事ができます。
197 「ファイル」ボタンを押すとスケールを開いたデータファイル中から指定したファイルでオートスケールを行って決める事ができます。
198 「クリア」はスケールの設定を未設定状態にします。
199 </p>
200 <p>
201 <img src="./tutorial/adialog.png" WIDTH="305" HEIGHT="262" ALT="">
202 </p>
203 <p>
204 さらに軸に関する細かい設定ができるように「軸基線」「目盛線」「目盛数字」「フォント」「位置」のボタンが用意されています。
205 「軸基線」ボタンを押して軸の基線の太さ、色などの設定を行います。
206 軸の端に矢印をつけたりすることもできます。
207 「目盛線」ボタンを押して軸の"ゲージ"の長さ、太さ、色などの設定を行います。
208 また、目盛線をグラフの内側に描くか外側に描くかを決めたり(「位置」)、軸を全部描かずに一部だけにしたり(「範囲最小値」、「範囲最大値」)できます。
209 「目盛数字」ボタンを押して、その"ゲージ" に振る目盛数字に関する設定を行います。
210 目盛数字を振り始めるスケールの位置を変えたり(「開始点」、0で自動設定)、
211 間隔を変えたり(「間隔」、0で自動設定)、
212 個数を変えたり(「個数」、-1で自動設定)できます。
213 「フォント」ボタンを押して目盛数字のフォントの設定を行います。
214 </p>
215
216 <li><h3>スケールをクリアする</h3>
217 <p>
218 前節で説明したように、軸ダイアログボックスの「クリア」ボタンで、
219 軸のスケール設定を未設定状態にできますが、
220 複数の軸をクリアしたいような場合には[軸]-[スケールクリア]メニューでクリアしたい軸を複数指定し、一括してクリアする事ができます。
221 あるいは下図ボタンを押しても同じように複数の軸をクリアできます。
222 </p>
223 <p>
224 <img src="../img/aclear.png" ALT="">
225 </p>
226
227 <li><h3>一部を拡大する</h3>
228 <p>
229 前節のように軸のスケールは数値を入力して変更しますが、グラフの一部を拡大して描画したい時などはグラフィカルに変更する事もできます。
230 それには下図ボタンを押してトリミングモードにしてグラフ上で軸の範囲をマウスで指定します。
231 </p>
232 <p>
233 <img src="../img/trimming.png" ALT="">
234 </p>
235
236 <li><h3>スケールの値を元に戻す</h3>
237 <p>
238 軸のスケールの設定は、各軸10個まで履歴が記憶されています。
239 従って前節のように一部を拡大描画した後に、元のスケールの設定に簡単に戻す事ができます。
240 それには下図ボタンを押して設定を戻したい軸を指定してください。
241 </p>
242 <p>
243 <img src="../img/scundo.png" ALT="">
244 </p>
245
246 </ol>
247
248 <h2><a name="PLOT">プロット方法</a></h2>
249 <ol>
250 <li><h3>プロット方法を変える</h3>
251 <p>
252 デフォルトの状態では、黒い点でデータ点がプロットされます。また、Data タブには開いたデータファイルが一覧表示されています。
253 プロット方法を変える為に、Data タブの一覧表示をダブルクリックしてデータダイアログボックスを開いてください。
254 </p>
255 <p>
256 <img src="./tutorial/fwindow.png" WIDTH="580" HEIGHT="236" ALT="">
257 </p>
258 <p>
259 データダイアログボックスはその他に次の方法で開くことができます。
260 </p>
261 <ol>
262 <li>[データ]-[設定] ([Data]-[Update]) メニューでプロットしたいデータファイルを選ぶ
263 <li>下図ボタンを押してデータ選択モードにしてグラフ上でデータをクリックする
264 <p>
265 <img src="../img/datapo.png" ALT="">
266 </p>
267 <li>Data タブ上でマウス右ボタンを押してポップアップメニューを出し、"プロパティ(P)" メニューを選ぶ
268 </ol>
269 <p>
270 この様にすると下左図に示すデータダイアログボックスが現れます。
271 </p>
272 <table border="0">
273 <tr>
274 <td><img src="./tutorial/filedlg.png" WIDTH="386" HEIGHT="398" ALT=""></td>
275 <td><img src="./tutorial/fdialog.png" WIDTH="244" HEIGHT="164" ALT=""></td>
276 </tr>
277 </table>
278 <p>
279 例えばプロット方法を変更してデータを曲線で結ぶようにするには上右図にの様にプロットタイプを "曲線" にします。
280 その後、データダイアログボックスを OK で閉じ、もう一度描画してくだ
281 さい。
282 </p>
283 <p>
284 データダイアログボックスでは、その他にドットの大きさ、幅、色などの設定が行えます。
285 またデータファイルの先頭に何のデータであるかの注釈をつけておく事が多いと思いますが、
286 その部分を読み飛ばすのには「読込」ボタンを押して「先頭スキップ行」を設定します。
287 </p>
288
289 <li><h3>曲線+点でプロットする</h3>
290 <p>
291 データを曲線と点の両方でプロットするようにするには、
292 同じデータファイルを二度開き、片方を曲線で、もう片方を点でプロットするように設定します。
293 同じデータ2度開くのも基本的には前節で示した方法で、
294 二回開けば良いのですが、すでに開いて有るファイルをもう一度開くには下図に示したように
295 Data タブ上でマウス右ボタンを押してポップアップメニューを出し "複製(D)" メニューを選び複製を生成するのがより簡単です。
296 Data タブでINSキーを押す事でも同様の操作が行えます。
297 下左図は Data タブでポップアップメニューを出した状態です。
298 "複製(D)"メニューを選ぶ事で下右図のように Data タブには同じファイルが2つリストされるようになります。
299 </p>
300 <table border="0">
301 <tr>
302 <td><img src="./tutorial/fdup.png" WIDTH="290" HEIGHT="221" ALT=""></td>
303 <td><img src="./tutorial/fwindow2.png" WIDTH="290" HEIGHT="112" ALT=""></td>
304 </tr>
305 </table>
306 <p>
307 このようにして2度開いたファイルのプロットの設定を、
308 片方のプロットを "マーク" に、もう片方を "曲線" にする事で、
309 データは曲線と点の両方でプロットされるようになります。
310 </p>
311 <table border="0">
312 <tr>
313 <td><img src="./tutorial/fdialog2.png" WIDTH="244" HEIGHT="164" ALT=""></td>
314 <td><img src="./tutorial/fdialog.png" WIDTH="244" HEIGHT="164" ALT=""></td>
315 </tr>
316 </table>
317
318 <li><h3>データ点の評価・マスク・移動</h3>
319 <p>
320 プロットしたデータの値はグラフの座標値から読み取る時に、
321 グラフ上でマウス右ボタンを押してポップアップメニューを出し、
322 "クロスゲージ(G)" を選ぶと、マウスカーソルに縦横のクロスゲージが現れますので、座標値を読み取るのに便利です。
323 また、もっと直接的に数値を知りたいときには、
324 下図のコントロールボタンを押して「評価モード」にしてからグラフ上でデータをクリックします。
325 </p>
326 <p>
327 <img src="../img/eval.png" ALT="">
328 </p>
329 するとマウスポインターに近いデータの一覧がリストアップされます。
330 <p>
331 <img src="./tutorial/evaldlg.png" WIDTH="275" HEIGHT="206" ALT="">
332 </p>
333 <p>
334 ここでリストアップされた項目の「#」はデータファイルの番号、
335 「行」はそのファイル中の行数、「X、Y」が座標値を示してします。
336 リストボックスの中の項目を選択し「Mask」ボタンを押す事で、データの一部だけを描かなくすることができます。
337 また、「Move」ボタンを押すと、データを移動させる事もできます。
338 これらマスク、移動の解除はデータダイアログボックスの「マスク」「移動」で行います。
339 </p>
340 </ol>
341
342
343 <h2><a name="LEGEND">グラフを飾りづける</a></h2>
344 <ol>
345 <li><h3>Legend を入れる</h3>
346 <p>
347 図にテキスト、矢印などを入れるには、
348 下図のコントロールボタンを押してLegend の種類を選び、マウスで位置を決めます。
349 Legend の作成が終わるとマウスは選択モードに戻ります。
350 複数の Legend を作成したいときは SHIFT キーを押しながらコントロールボタンをクリックしてください。
351 また Legend の位置指定時に CTRL キーを押しながらマウスを操作すると、角度や縦横の比を制限できます。
352 </p>
353 <p>
354 <img src="../img/legend.png" ALT="">
355 </p>
356 <table border="1">
357 <tr><td><img src="../img/bline.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>直線・曲線を作成します。</td></tr>
358 <tr><td><img src="../img/brect.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>矩形を作成します。</td></tr>
359 <tr><td><img src="../img/barc.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>円・楕円を作成します。</td></tr>
360 <tr><td><img src="../img/bmark.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>データプロット形式 "マーク" に対応するマークを作成します。</td></tr>
361 <tr><td><img src="../img/btext.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>テキストを作成します。</td></tr>
362 <tr><td><img src="../img/bgauss.png" WIDTH="32" HEIGHT="32" ALT=""></td><td>ガウス関数, ローレンツ関数, 放物線, 正弦曲線を作成します。<br>作成した曲線はただちにレジェンド-曲線に展開されるので, 一度作成すると関数としての変更はできません。</td></tr>
363 </table>
364 <p>
365 文字列をグラフ上にドラッグ&amp;ドロップすることでもテキストを作成できます。
366 </p>
367
368 <li><h3>グラフ上での移動、設定変更</h3>
369 <p>
370 マウスによって Legend、Axis などの設定の変更、移動、拡大縮小などを行う事もできます。
371 Ngraph には、その為のマウスポインターのモードが4種類あるので注意が必要です(下図)。
372 </p>
373 <p>
374 <img src="../img/pointer.png" ALT="">
375 </p>
376 <p>
377 ここで、"legend+axis" のポインターモードでは、レジェンドと軸を選択する事ができます。
378 "legend" のポインターモードではレジェンドのみが選択対象になります。
379 軸とレジェンドが込み合っていて軸を選択したく無いような場合に使ってください。
380 "axis" のポインターモードでは逆に軸のみが選択対象になります。
381 "data" のポインターモードではプロットしたデータが選択対象になり、プロットした点に対応するデータファイルの設定を行う事ができます。
382 </p>
383 <p>
384 選択したいグラフィックスオブジェクトに合ったコントロールボタンを押してモードを決め、
385 マウスで目的のグラフィックスをクリックするとフォーカスされている事を示す点線枠が表示されます(下図)。
386 SHIFT キーを押しながらクリックすると複数のオブジェクトを複数選択できます。
387 </p>
388 <p>
389 <img src="./tutorial/focus.png" width="122" height="111" alt="">
390 </p>
391 <p>
392 マウスのドラッグで移動、拡大・縮小ができます。
393 移動の際に CTRL キーを押しながらドラッグすると、水平垂直方向にしか動きませんので、位置合わせをするのに便利です。
394 また、移動の際はグリッドが効いています。このグリッドを解除するには SHIFT キーを押しながらドラッグしてください。
395 ダブルクリックでダイアログボックスが開き各種設定の変更が行えます。
396 </p>
397 <p>
398 <img src="./tutorial/setting_bar.png" width="1112" height="44" alt="">
399 </p>
400 <p>
401 また、レジェンドや軸を選択すると コントロールボタン(上部)
402 が上のような表示になります(表示されるボタンなどは選択し
403 たオブジェクトによって変わります)。ここで値を編集するこ
404 とにより、選択したオブジェクトの設定をまとめて変更できま
405 す。
406 </p>
407
408 <li><h3>レジェンドの複製</h3>
409 <p>
410 同じ様なレジェンドを沢山作成しなければならない時の為に、1つ作成してそれの複製を生成する機能があります。
411 それには前節で説明した方法で、複製を作成したいレジェンドがフォーカス(選択)された状態(点線枠で囲まれた状態)にします。
412 もし、複数のレジェンドの複製を作りたいのであれば、それら複数のレジェンドをマウスで囲むようにしてフォーカスされた状態にしてください。
413 ここで INS キーを押すと(あるいはポップアップメニューを出して "複製(D)" メニューを選択する)、
414 フォーカスされているレジェンドの複製が生成されます。
415 複製は同じ位置に生成されますので、重なって1つしか見えません。
416 ですが、複製後は複製されたレジェンドのみがフォーカスされていますので、そのままドラッグすれば複製されたものだけが移動します。
417 </p>
418
419 <li><h3>legend.nsc を使う</h3>
420 <p>
421 Ngraph にはアドインと呼ばれる副プログラムを使う機能が用意されています。
422 その一つにデータの凡例を自動生成する LGEND が用意されています。
423 [アドイン] ([Addin]) メニューの中から [Legend...] を選び実行すると、現在開かれているデータファイルの凡例が自動生成されます。
424 下図は LEGEND アドインによる凡例の作成例です。
425 </p>
426 <p>
427 <img src="./tutorial/alegend.png" width="169" height="38" alt="">
428 </p>
429
430 <li><h3>込み合っているレジェンドの選択方法</h3>
431 <p>
432 "Path タブ"、"Rectangle タブ"、"Arc タブ"、"Mark タブ"、"Text タブ" には
433 それぞれのオブジェクトの一覧が表示されています。
434 "File タブ" や"Axis タブ" と同様に一覧をダブルクリックするとダイアログボックスが開き、
435 各種設定を行う事ができます。
436 また、一覧の中から適当な legendを選びスペースを押す
437 (あるいはポップアップメニューを出して "フォーカス(F)" メニューを選ぶ)と、
438 グラフで対応するグラフィックスオブジェクトがフォーカスされます。
439 作成したlegendが重なりあってしまい、目的の legend だけをマウスで選択するのが困難な時にこの機能を使うと便利です。
440 </p>
441 </ol>
442
443 <h2><a name="OUTPUT">グラフの印刷・保存・読込、ファイルへの出力</a></h2>
444 <ol>
445 <li><h3>グラフの印刷</h3>
446 <p>
447 印刷は[グラフ]-[印刷]メニューで行います。
448 </p>
449
450 <li><h3>グラフの保存</h3>
451 <p>
452 グラフの保存は[グラフ]-[保存]メニューで行います。
453 このメニューを選択すると保存するファイル名を聞いてきた後、各種セーブオプション指定の為のダイアログボックスが開きます。
454 ここで OK を押せば、Ngraph の保存形式で NGP の拡張子を持つファイルが作成されます。
455 一方、Ngraphは予め用意してあるデータファイルを読み込んでグラフにしています。
456 従って、グラフを完全に保存するにはグラフの状態を保存した NGP ファイルだけでなく、データファイルも保存しておく必要がある事になります。
457 ところが、このように NGP ファイルとデータファイルを別々に保存しておくと、
458 フォルダ構成の異なるコンピュータにコピーした時に正常にデータファイルが読み込めなくなってしまいます。
459 これを回避する為に幾つかのセーブオプションが用意されています。
460 </p>
461 <dl>
462 <dt>パス情報
463 <dd>
464 セーブする時にデータファイルのパス情報をどうするかを指定します。
465 unchange では何の変更もしません。
466 full にするとデータパスをフルパスでセーブします。
467 relative はカレントフォルダからの相対パスでセーブします。
468 base はパス名をつけずファイル名だけでセーブします。
469 </dd>
470 <dt>データファイルを含める
471 <dd>
472 このオプションをチェックすると、データファイルの内容も NGP ファイルに埋め込まれます。
473 したがって、グラフの保存にデータファイルはもはや不要となります。
474 埋め込まれたデータファイルはNGPファイルの読み込み時に展開されます。
475 </dd>
476 <dt>合成タファイルを含める
477 <dd>
478 上記同様に合成ファイル(GRAファイル)をNGPファイルに埋め込みます。
479 </dd>
480 </dl>
481
482 <li><h3>グラフの読込</h3>
483 <p>
484 セーブしてあるNGPファイル(*.ngp)を読み込むには[グラフ]-[開く]メニューで行います。
485 ファイルマネージャー等からNGPファイルを選び、
486 グラフ上にドラッグ&amp;ドロップしてもグラフを読み込むことができます。
487 このメニューを選択すると読み込むファイル名を聞いてきた後、
488 各種読み込みオプション指定の為のダイアログボックスが開きます。
489 各オプションの意味は以下の通りです。
490 <dl>
491 <dt>データファイル展開
492 <dd>
493 データファイルが埋め込まれている NGP ファイルを読みこむとき、埋め込まれているデータファイルを展開するかどうかを指定します。
494 展開するフォルダは「展開ファルダ」で指定できます。デフォルトではカレントフォルダ(.\)になっています。
495 </dd>
496 <dt>パス情報
497 <dd>
498 データファイルのパス情報の扱いを選択します。
499 「フルパス」はフルパスで指定されていないデータファイルについて、
500 カレントフォルダから推測されるフルパスに変換します。
501 「ファイル名のみ」の場合、パス情報は無視され、
502 データファイルはカレントフォルダにあるものとみなされます。
503 フォルダ構成が変わってしまい、かつデータファイルがカレントフォルダに有る場合にはこのオプションをチェックしてください。
504 </dd>
505 </dl>
506
507 <li><h3>画像ファイルへのエクスポート</h3>
508 <p>
509 [グラフ]-[画像にエクスポート]で出力ファイル形式を指定してファイルに出力する事ができます。
510 </p>
511
512 <li><h3>GRAファイルへの出力</h3>
513 <p>
514 GRAファイルとは、直線、円などのグラフィックス命令を記述したNgraph独自のファイル形式です。
515 グラフの合成に使う事ができます。
516 GRAファイルの作成は[グラフ]-[画像にエクスポート]-[GRA ファイル]で行います。
517 そのようにして出力したGRAファイルを[合成]-[開く]メニューで指定するか、
518 ファイルマネージャー等からGRAファイルを選び、
519 グラフまたはMerge タブ上にドラッグ&amp;ドロップ事で取り込む事ができます。
520 </p>
521
522 </ol>
523
524 <h2><a name="FIT">フィッティング</a></h2>
525 <ol>
526 <li><h3>通常のフィット</h3>
527 <p>
528 データのフィッティングをするには下図の様にデータダイアログボックスでプロット形式を fit にします。
529 </p>
530 <table border="0">
531 <tr>
532 <td><img src="./tutorial/filedlg.png" WIDTH="388" HEIGHT="312" ALT=""></td>
533 <td><img src="./tutorial/fdialog3.png" WIDTH="244" HEIGHT="164" ALT=""></td>
534 </tr>
535 </table>
536 <p>
537 その後、「作成」ボタンを押すと下図のフィットダイアログボックスが開きますので、そこでフィッティングの方法を指定します。
538 </p>
539 <p>
540 <img src="./tutorial/fitdlg.png" WIDTH="430" HEIGHT="327" ALT="">
541 </p>
542 <p>
543 フィットダイアログボックスの「種類」には "多項式", "べき関数", "指数関数", "対数" から選択します。
544 "ユーザ定義" を選ぶとユーザ指定の関数でフィットできますが、それは次節で説明します。
545 また "多項式" (多項式フィット)の場合には「多項式次元」も指定してください。
546 その後、描画するとフィッティングが行われます。
547 フィット結果は線としてグラフに表示されます。またサイドバー右下にも情報が表示されます。
548 あるいはフィットダイアログボックスの「結果表示」ボタンでもフィット結果が数値で表示されます。
549 </p>
550 <p>
551 フィット結果の表示で&lt;DY^2&gt;はデータが (Xi, Yi)、フィットした関数が Y=f(X) のとき、
552 &lt;DY^2&gt;=&lt;ΔY^2&gt;=&lt;[Yi-f(Xi)]^2&gt;=(1/N)Σ[Yi-f(Xi)]^2
553 の意味です。また "|r| or |R|" は相関係数の絶対値です。
554 </p>
555
556 <li><h3>任意関数によるフィット</h3>
557 <p>
558 任意関数でフィットする場合には、フィットダイアログボックスの「種類」で "ユーザ定義" を選びます。
559 フィット関数を「フィット式」に指定します。
560 </p>
561 <p>
562 例として
563 <pre>
564 Y=a*(X+b)^2
565 </pre>
566 のフィットの場合を説明します。
567 フィッティングパラメターは a と b です。
568 フィッティングパラメターは「フィット式」の中では %00 から %09 で指定します。
569 つまりフィッテングパラメターは最大 10 個までに制限されています。
570 上の例では「フィット式」に
571 <pre>
572 %00*(X+%01)^2
573 </pre>
574 と入力してください.
575 任意関数のフィットでは一気にパラメターの値を決めるのではなく、パラメターの値を変えながら誤差が最小になる点を探して行きます。
576 探し方はパラメターの初期値を決め、その時のパラメター空間での誤差の勾配から新たなパラメターの値を決めると言う動作を
577 パラメターの値が変わらなくなるまで(収束するまで)繰り返します。
578 「%00:〜%09:」「収束(%)」「微分式指定」「dF/d(%00):〜dF/d(%09):」でこの繰り返し動作を制御します。
579 パラメター空間での誤差の勾配を求めるにはフィット関数を各パラメターで偏微分した式が必要です。
580 「微分式指定」をチェックし、これら微分式を「dF/d(%00):〜dF/d(%09):」に入力してください。
581 上の例の場合 %00*(X+%01)^2 を %00, %01 で偏微分した式を入力します。
582 具体的には
583 <pre>
584 dF/d(%00): (X+%01)^2
585 dF/d(%01): %00*2*(X+%01)
586 </pre>
587 としてください。
588 「微分式指定」をチェックしなければ、微分式の近似値を数値的に求めますが、明示的に微分式を指定した方が収束は速くなります。
589 また、フィットパラメターの初期値を「%00:〜%09:」で指定してください。
590 パラメターの値が変わらなくなった時を収束したと判断していますが、全く変化しなくなる事はありません。
591 変化しなくなったと見なす基準を「収束(%):」で指定します。
592 デフォルトでは 1% ですのでフィット結果の有効桁数は2桁です。
593 これらのオプションを指定したら、ダイアログボックスを閉じて描画すればフィットが行われます。
594 また、時として
595 <pre>
596 singular matrix あるいは too small number of data
597 </pre>
598 のエラーが出たり、収束せずにフィット処理がいつまでも続いてしまう事
599 があります(描画進行状況を示すダイアログの「停止」ボタンを押して中断してください)。
600 このような場合にはフィットパラメターの初期値を変えて再度挑戦してみてください。
601 フィット関数によっては初期値をかなり慎重に選ばないと収束してくれま
602 せん。
603 </p>
604 <p>
605 なおフィッティングのユーザ定義関数では下記の定数、関数は使用できません。
606 <ul>
607 <li> F(), G(), H()
608 <li> CIOLOR(), ALPHA()
609 <li> OBJ_COLOR(), OBJ_ALPHA()
610 <li> RGB(), RGB2()
611 <li> HSB(), HSB2()
612 <li> MARKSIZE(), MARKTYPE()
613 <li> NUM
614 <li> MINX, MAXX
615 <li> MINY, MAXY
616 <li> SUMX, SUMY
617 <li> SUMXX, SUMYY, SUMXY
618 <li> AVX, AVY
619 <li> SGX, SGY
620 <li> FIRST
621 <li> MASK, MOVE
622 <li> COLX, COLY
623 <li> AXISX, AXISY
624 <li> HSKIP, RSTEP, FLINE
625 <li> FILE_OBJ, PATH_OBJ, RECT_OBJ, ARC_OBJ, MARK_OBJ, TEXT_OBJ
626 <li> %D, %N
627 </ul>
628 </p>
629 </ol>
630
631 <h2><a name="MATH">数式変換機能を使う</a></h2>
632 <ol>
633 <li><h3>データを数式で変換してプロットする</h3>
634 <p>
635 Ngraph ではデータファイルのデータをそのままグラフにするだけではなく、データを指定した数式で変換してからグラフにする機能を持っています。
636 変換する為の式はデータダイアログボックスで「変換数式」タブを表示し、「変換数式:」に入力します。
637 変換数式は各データファイルで独立しています。
638 下図のボタンを押して、複数のデータファイルの変換数式を一括して入力する事もできます。
639 </p>
640 <p>
641 <img src="../img/math.png">
642 </p>
643
644 <p>
645 例えば、縦軸データを二乗したものをグラフにしたい時には「(Y)カラム数式変換」に
646 <pre>
647 Y^2 (あるいは同じ事ですが SQR(Y))
648 </pre>
649 と入力してください。もしデータダイアログボックスの「(Y)カラム」が 2 となっている場合には
650 <pre>
651 %2^2 (あるいは同じ事ですが SQR(%2))
652 </pre>
653 でも同じ結果を得ることができます。%2 の意味は "データファイルの2カラム目のデータ"です。
654 このように %1〜%999 で特定のカラムを取り出す事ができます。
655 一方、Xはデータダイアログボックスの「(X)カラム」に指定したカラムのデータであり、
656 Yはデータダイアログボックスの「(Y)カラム」に指定したカラムのデータです。
657 ですから、「(Y)カラム」を 3 にすると、今度は "Y" と "%3" が同じ値を示すようになります。
658 また配列 COL を使って特定のカラムを取り出すこともできます。 COL[1] が1カラム目のデータになります。
659 </p>
660 <p>
661 縦軸データをカラム 1 とカラム2 の和をプロットしたい時には変換数式に
662 <pre>
663 %1+%2
664 </pre>
665 と入力してください。このようにカラム間の演算ができます。
666 また、0番目(Data タブのリストの先頭の数字)のデータのカラム 1 と、1 番目のデータのカラム2 の和をプロットしたい時には変換数式に
667 <pre>
668 %F0001+%F0102
669 </pre>
670 と入力してください。このようにファイル間の演算もできます。
671 </p>
672 <p>
673 数式変換では四則演算、括弧のほか多くの関数が使用できます。
674 </p>
675
676 </ol>
677
678 <h2><a name="MULTI">複数のグラフ</a></h2>
679 <ol>
680 <li><h3>複数のグラフの作り方</h3>
681 <ul>
682 <li>グラフを新たに作成する
683 <p>
684 一枚の紙に複数のグラフを作成したい場合には、 [軸]-[追加作成]メニューの中から作成したいグラフの種類を指定します。
685 あるいは下図のコントロールボタン
686 <p>
687 <img src="../img/addgraph.png" ALT="">
688 </p>
689 を押して、グラフ(軸)の作成モードにして グラフ上でマウスを使って位置を指定し作成する事もできます。
690 </p>
691 <li>すでに作成してあるグラフを複製する
692 <p>
693 既に一つのグラフが作成してあり、それと同じ様なグラフを新たに追加するのには、
694 その既に作成してあるグラフを複製してしまうのが、より簡単で現実的です。
695 それには、下図ボタンを押してマウスをポインター(選択)モードにします。
696 このモードでは軸とレジェンドが選択対象になります(legendも一緒に複製する事を考えています)。
697 <p>
698 <img src="../img/lapoint.png" ALT="">
699 </p>
700 次いで、グラフ上で複製ーしたいグラフ全体を囲むようにマウスで範囲を指定します。
701 すると、マウスの範囲に入っているグラフとレジェンドが全て選択され、点線枠で囲まれます。
702 この状態で INS キーを押す(あるいはポップアップメニューを出して "複製(D)" メニューを選択する)と、
703 選択されているグラフとレジェンドが複製されます。
704 この時、フォーカス(選択)されているのは新たに複製されたグラフとレジェンドだけで、複製元は選択されていません。
705 この状態でマウスでドラッグして位置をずらしてください。
706 通常、複数のグラフを作成する場合には縦、あるいは横に位置を揃えたい場合が多いですが、
707 マウスで位置をずらす時に CTRL キーを押しながらドラッグすれば水平・垂直方向にしか移動しませんので、簡単に揃える事ができます。
708 </p>
709 </ul>
710
711 <li><h3>append.nscを使う</h3>
712 <p>
713 NGP ファイルとして保存されている別のグラフを、現在のグラフと同じページに取り込むのはもっと簡単です。
714 Ngraph にはアドインと呼ばれる副プログラムを使う機能が用意されています。
715 その一つにNGPファイルに保存されているグラフを現在のグラフに追加する APPEND が用意されています。
716 [アドイン] ([Addin]) メニューの中から [Append...] を選び実行しNGPファイル名を指定するだけで、現在のグラフに追加する事ができます。
717 </p>
718
719 <li><h3>軸の名称</h3>
720 <p>
721 フレームグラフや方眼グラフは4つの軸(X軸、Y軸、U軸、R軸)から構成されます。
722 また交差グラフは2つの軸(X軸、Y軸)から構成されます。
723 これらの軸には複数のグラフを作成しても一意になるように名前が自動的に付けられます。
724 軸の名前は以下の形式をしています。
725 </p>
726 <p>
727 <table border="1">
728 <tr align="CENTER"><td>グラフの種類</td><td>軸</td><td>グラフの番号</td></tr>
729 <tr><td>f: フレームグラフ<br>s: 方眼グラフ<br>c: 交差グラフ</td>
730 <td>X<br>Y<br>U<br>R</td>
731 <td>グラフの種類毎に 1 から振られます</td></tr>
732 </table>
733 </p>
734 <p>
735 例えば、最初に作成したフレームグラフの軸の名前は fX1, fY1, fU1, fR1 となり、二番目作成したフレームグラフの軸の名前は fX2, fY2, fU2, fR2 です。
736 </p>
737 <p>
738 Axis タブの "name" の部分には、この名前が一覧表示されます。
739 またこれとは別に他のグラフィックオブジェクトと同様に0からの通し番号が付いています。
740 Axis タブの "#" の部分に表示されている数字がこの番号です。
741 </p>
742 <li><h3>プロットする軸の指定</h3>
743 <p>
744 データをプロットする軸はデータダイアログボックスの「軸」で指定します。
745 </p>
746
747 <li><h3>軸の連携</h3>
748 <p>
749 Ngraph の座標軸は軸の間で連携する為の機能を2つもたせてあります。
750 </p>
751 <dl>
752 <dt>Reference パラメタ
753 <dd>
754 <p>
755 座標軸の最大・最小値が設定されていない時、Reference パラメタに他の座標軸番号が指定されていれば、
756 その軸から最大・最小値を自動的に読み取ります。主にフレームグラフの U軸, R軸の為に使われます。
757 </p>
758 </dd>
759 <dt>Adjust パラメタ
760 <dd>
761 <p>
762 他の軸番号が指定されている場合には、
763 その軸とAdjust position で交差するように自分自身を平行移動させます。
764 主に交差グラフの軸に対して使われます。
765 </p>
766 </dd>
767 </dl>
768 <p>
769 これらは「参照軸」、「位置ボタン」-「交差軸」でそれぞれ指定できます。
770 </p>
771 <p>
772 軸には前で説明した様に、0からの通し番号が付けられています。
773 さらに、(他のグラフィックオブジェクトと同様に)実行時に一意に決まる番号も付いています(^で始まる数字として指定します)。
774 Axis タブの最後の"^#" の部分に表示されている数字がこの番号です。
775 </p>
776 <p>
777 複数のグラフで X 軸を共通にしたい場合、
778 下図の様に Reference パラメタを設定すると fX2 軸のスケールを変えるだけで fU2, fX1, fU1 の軸のスケールを揃える事ができます。
779 </p>
780 <p>
781 <img src="./tutorial/axisref.png" WIDTH="250" HEIGHT="244" ALT="">
782 </p>
783 </ol>
784 <h2><a name="DECIMALSIGN">小数点記号の扱い</a></h2>
785 <ul>
786 <li> 軸の目盛数字やデータファイルで使われる小数点の記号は「グラフ」-「ページの設定」で変更できます。
787 <li> 小数点記号は「ピリオド (.)」または「コンマ (,)」を選択できます。
788 <li> 小数点記号が「ピリオド (.)」のときはデータファイル中でピリオドのみを小数点記号として認識します。
789 <li> 小数点記号が「コンマ (,)」のときはデータファイル中でコンマとピリオドの両方を小数点記号として認識します。
790 <li> 小数点記号の設定により以下の描画が変化します。
791 <ul>
792 <li> 軸目盛
793 <li> レジェンドテキストの %pf による整形
794 <li> 数式変換の printf 関数や、数値の文字列への変換
795 </ul>
796 <li> 小数点記号の既定値は「設定」-「その他」で指定できます。
797 <li> 既定値が「ロケール」の場合はシステムの言語設定によって選ばれます。
798 </ul>
799 </div>
800 </body>
801 </html>