Debian Codegraph @

doc/html/ja/data.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>Data file</title></head>
8 <body>
9 <div class="toc">
10 <a name="TOP">&nbsp;</a>
11 <h1><a href="./ngraph.html">データファイル</a></h1>
12 <ul>
13 <li><a href="#DATAFILE">データファイルの形式</a>
14 <li><a href="#DATAFILE_EMPTY">欠損データを含むデータファイル</a>
15 <li><a href="#DATAFILE_DIAGONAL">データプロット形式 diagonal, arrow, rectangle のデータファイル</a>
16 <li><a href="#DATAFILE_ERRBARX">データプロット形式 errorbar_x, errorband_x のデータファイル</a>
17 <li><a href="#DATAFILE_ERRBARY">データプロット形式 errorbar_y, errorband_y のデータファイル</a>
18 <li><a href="#DATAFILEOPTION">データファイル埋め込みオプション</a>
19 </ul>
20 </div>
21
22
23 <div class="chapter">
24 <h2><a name="DATAFILE">データファイルの形式</a></h2>
25 <br>
26 <div>
27 データファイルはテキストファイルで、基本的には次のようなフォーマットです。<br>
28 <br>
29 <table border="1">
30 <tr>
31 <td>
32 <table>
33 <tr>
34 <td colspan="4"> コメント行</td>
35 </tr>
36 <tr>
37 <td colspan="4"> … (コメントは無くても構いません)</td>
38 </tr>
39 <tr>
40 <td colspan="4"> コメント行</td>
41 </tr>
42 <tr>
43 <td>カラム1</td><td>カラム2</td><td>カラム3</td><td>カラム4 … </td>
44 </tr>
45 <tr>
46 <td>カラム1</td><td>カラム2</td><td>カラム3</td><td>カラム4 … </td>
47 </tr>
48 <tr>
49 <td colspan="4">% コメント行</td>
50 </tr>
51 <tr>
52 <td>カラム1</td><td>カラム2</td><td>カラム3</td><td>カラム4 … </td>
53 </tr>
54 <tr>
55 <td>カラム1</td><td>カラム2</td><td>カラム3</td><td>カラム4 … </td>
56 </tr>
57 <tr>
58 <td>…</td><td>…</td><td>…</td><td>…</td>
59 </tr>
60 </table>
61 </td>
62 </tr>
63 </table>
64 <br>
65 データファイル中のコメント
66 <ul>
67 <li>データファイル先頭部分はDataダイアログボックスの[読込]の先頭スキップ行数で指定した行数だけまとめて読み飛ばせるので, コメントなどを入れておくことができます。
68 <li>デフォルトでこの行数は0行です。
69 <li>コメントはなくてもかまいません。
70 </ul>
71 <br>
72 ファイル途中へのコメントの挿入
73 <ul>
74 <li>ファイル途中にコメントを入れるには行頭にDataダイアログボックスの[読込]で[コメント行]に設定されている文字を入れます。
75 <li>デフォルトでは # % ' です。
76 </ul>
77 <br>
78 データファイルからの読み込み
79 <ul>
80 <li>データファイルの第一行目にデータファイル埋め込みオプションを記述しておくと Dataダイアログボックスの[Load settings]ボタンを押して各種設定をデータファイルから読み取る事ができます。
81 </ul>
82 <br>
83 データ
84 <ul>
85 <li>カラム1, カラム2, カラム3, … に数値データを入れます。
86 <li>データファイルの最大カラム数は999個です。
87 <li>一行の最大文字数は特に制限がありません。
88 <li>カラムの区切りはDataダイアログボックス[読込]の[区切り文字]で設定できます。
89 <li>デフォルトではスペース, コンマ, タブ, 括弧です。
90 <li>改行コードは LF, CR LF, CR のいずれかです。
91 </ul>
92 <br>
93 数値データの指数部指定
94 <ul>
95 <li>数値データの指数部指定子には e, E, Dが使えます。
96 <li>(例) 1.0D+002
97 </ul>
98 <br>
99 空行の扱い
100 <ul>
101 <li>ヌル行(区切文字のみからなる行)は読み飛ばします。
102 </ul>
103 </div>
104
105
106
107
108 <h2><a name="DATAFILE_EMPTY">欠損データを含むデータファイル</a></h2>
109 <br>
110 <div>
111 Ngraph で欠損データを指定する方法を示します。例として,2行目のデータが欠落している場合を考えます。<br>
112 <br>
113 <table border="1" CELLPADDING="3" CELLSPACING="0">
114 <tr><td>X</td><td>Y</td><td>Z</td></tr>
115 <tr><td>1.0</td><td>2.0</td><td>3.0</td></tr>
116 <tr><td>2.0</td><td> </td><td>4.0</td><td>← Yが欠落している</td></tr>
117 <tr><td>3.0</td><td>4.0</td><td>5.0</td></tr>
118 </table>
119 <br>
120 このまま, Dataダイアログボックスで(X) columnを1, (Y) columnを2にして描画すると, 2行目のYにはZの値が使われてしまいます。<br>
121 <br>
122 欠損データを正しく描画するには | あるいは = を欠損部分に入れます。<br><br>
123 <table border="0">
124 <tr><td>
125 <table border="1" CELLPADDING="3" CELLSPACING="0">
126 <tr><td>1.0</td><td>2.0</td><td>3.0</td></tr>
127 <tr><td>2.0</td><td align="CENTER"> | </td><td>4.0</td></tr>
128 <tr><td>3.0</td><td>4.0</td><td>5.0</td></tr>
129 </table>
130 </td>
131 <td>
132 あるいは
133 </td><td>
134 <table border="1" CELLPADDING="3" CELLSPACING="0">
135 <tr><td>1.0</td><td>2.0</td><td>3.0</td></tr>
136 <tr><td>2.0</td><td align="CENTER"> = </td><td>4.0</td></tr>
137 <tr><td>3.0</td><td>4.0</td><td>5.0</td></tr>
138 </table>
139 </td>
140 </tr>
141 </table>
142 <br>
143 これでYの欠損データを正しくスキップします。<br>
144 <br>
145 <ul>
146 <li>| と = の違い
147 <br>
148 <br>
149 <ul>
150 <li>データプロット形式がmarkなどの点類とFitの場合は区別がありません。どちらでも同じグラフになります。<br>
151 <li>データプロット形式がlineなどの線類では異なります。
152 | では欠損データの前後を直線・曲線で結びます。
153 = ではその前後で直線・曲線が分断されます。
154 </ul>
155 <br>
156 <li>欠損データの別表記法
157 <br>
158 <br>
159 <ul>
160 <li>'CONT' は '|' と同等です。
161 <li>'BREAK'は '=' と同等です。
162 </ul>
163 </ul>
164 <br>
165 欠損データの(あまりお勧めしない)指定方法<br>
166 <br>
167 <ul>
168 <li>欠損部分を数値データではない文字で埋めます。
169 <br>
170 <br>
171 <table border="1" CELLPADDING="3" CELLSPACING="0">
172 <tr><td>1.0</td><td>2.0</td><td>3.0</td></tr>
173 <tr><td>2.0</td><td align="CENTER"> A </td><td>4.0</td></tr>
174 <tr><td>3.0</td><td>4.0</td><td>5.0</td></tr>
175 </table><br>
176 この方法では, 描画の度にエラーが出て一時停止します。<br>
177 <br>
178 <li>2行目の先頭に%#'のいずれかの記号(Dataダイアログボックスの[コメント行]で変更可能)を入れて2行目全体をスキップさせます。
179 <br>
180 <br>
181 <table border="1" CELLPADDING="3" CELLSPACING="0">
182 <tr><td>1.0</td><td>2.0</td><td>3.0</td></tr>
183 <tr><td>%2.0</td><td> </td><td>4.0</td></tr>
184 <tr><td>3.0</td><td>4.0</td><td>5.0</td></tr>
185 </table><br>
186 これでは2行目のデータはX, Y, Zとも初めから存在しないのと同じ事です。
187 従って, (Y) columnを3にしたとき, Z=4.0もスキップしてしまいます。
188 </ul>
189 <br>
190 欠損データを利用した複数グラフの描画<br>
191 <br>
192 <ul>
193 <li>欠損データの指定を応用して,データを = = で分断すれば一つのファイルで複数本のグラフを描画できます。<br>
194 <br>
195 <li>[例]データを = = で分断して2本の直線からなるグラフを描く例を示します。
196 <br>
197 <br>
198 <table border="1" CELLPADDING="3" CELLSPACING="0">
199 <tr><td>1.0</td><td>2.0</td></tr>
200 <tr><td>2.0</td><td>3.0</td></tr>
201 <tr><td>3.0</td><td>4.0</td></tr>
202 <tr><td align="CENTER"> = </td><td align="CENTER"> = </td></tr>
203 <tr><td>4.0</td><td>5.0</td></tr>
204 <tr><td>5.0</td><td>6.0</td></tr>
205 <tr><td>6.0</td><td>7.0</td></tr>
206 </table><br>
207 </ul>
208 </div>
209
210
211
212
213 <h2><a name="DATAFILE_DIAGONAL">データプロット形式 diagonal, arrow, rectangle のデータファイル</a></h2>
214 <br>
215 <div>
216 データプロット形式 diagonal, arrow, rectangle, rectangle_fill, rectangle_solid_fill などを用いて対角線や矩形をプロットしたい時に用いるデータファイル形式です。<br>
217 <br>
218 [例](0, 0)-(1, 1) と (1, 1)-(1, 2) に対角線, あるいは矩形を描きたいとき次のようなファイルを作り, (X) columnを1, (Y) columnを3にします。
219 <br>
220 <br>
221 <table border="1" CELLPADDING="3" CELLSPACING="0">
222 <tr><td>0.0</td><td>0.0</td><td>1.0</td><td>1.0</td></tr>
223 <tr><td>1.0</td><td>1.0</td><td>1.0</td><td>2.0</td></tr>
224 </table><br>
225 <br>
226 始点のXとY, 終点のXとYはそれぞれ連続していなければなりません。
227 (4つが連続している必要はありません)
228 </div>
229
230
231
232 <h2><a name="DATAFILE_ERRBARX">データプロット形式errorbar_x, errorband_xのデータファイル</a></h2>
233 <br>
234 <div>
235 データプロット形式errorbar_xを用いて誤差棒をプロットすることができます。
236 <br>
237 <br>
238 例えば次のようなデータを考えます。
239 <br>
240 <br>
241 <table border="1" CELLPADDING="3" CELLSPACING="0">
242 <tr><td>X</td><td>Error(X)</td><td>Y</td></tr>
243 <tr><td>1.0</td><td>+/-0.5</td><td>2.0</td></tr>
244 <tr><td>2.0</td><td>+/-1.0</td><td>3.0</td></tr>
245 </table><br>
246 <br>
247 このとき, 次のようなデータファイルを作り (X) columnを1、 (Y) column を4にします。
248 <br>
249 <br>
250 <table border="1" CELLPADDING="3" CELLSPACING="0">
251 <tr><td>1.0</td><td>-0.5</td><td>+0.5</td><td>2.0</td></tr>
252 <tr><td>2.0</td><td>-1.0</td><td>+1.0</td><td>3.0</td></tr>
253 </table><br>
254 <br>
255 X, Xの誤差下限, Xの誤差上限 の3つのカラムは連続していなければなりません。<br>
256 <p>データプロット形式 errorband_x の場合は誤差棒の代わりに帯状の領域を描画します。</p>
257 </div>
258
259
260
261
262 <h2><a name="DATAFILE_ERRBARY">データプロット形式errorbar_y, errorband_yのデータファイル</a></h2>
263 <br>
264 <div>
265 データプロット形式errorbar_yを用いて誤差棒をプロットすることができます。<br>
266 <br>
267 例えば次のようなデータを考えます。
268 <br>
269 <br>
270 <table border="1" CELLPADDING="3" CELLSPACING="0">
271 <tr><td>X</td><td>Y</td><td>Error(Y)</td></tr>
272 <tr><td>1.0</td><td>2.0</td><td>+/-0.5</td></tr>
273 <tr><td>2.0</td><td>3.0</td><td>+/-1.0</td></tr>
274 </table><br>
275 <br>
276 このとき, 次のようなデータファイルを作り, (X) columnを1, (Y) column を2にします。
277 <br>
278 <br>
279 <table border="1" CELLPADDING="3" CELLSPACING="0">
280 <tr><td>1.0</td><td>2.0</td><td>-0.5</td><td>+0.5</td></tr>
281 <tr><td>2.0</td><td>3.0</td><td>-1.0</td><td>+1.0</td></tr>
282 </table><br>
283 <br>
284 Y, Yの誤差下限, Yの誤差上限 の3つのカラムは連続していなければなりません。<br>
285 <p>データプロット形式 errorband_y の場合は誤差棒の代わりに帯状の領域を描画します。</p>
286 </div>
287
288
289
290
291 <h2><a name="DATAFILEOPTION">データファイル埋め込みオプション</a></h2>
292 <br>
293 <div>
294 データファイルの一行目にデータファイル埋め込みオプションを記述しておくと、Dataダイアログボックスの [Load settings]ボタンで各種設定を取り込む事ができます。
295 複数のオプションを記述する場合には, 各オプションはスペース, タブで区切らなければなりません。
296 <br>
297 <br>
298 <table border="1">
299 <tr><td>-xcolumn</td><td>(X) Column を column にします。</td></tr>
300 <tr><td>-ycolumn</td><td>(Y) Column を column にします。</td></tr>
301 <tr><td>-dtype[,{mark_type|interpolation}]</td><td>プロットタイプを type にします。
302 type が mark の時にはカンマに続いてマークの種類を数字で指定します。
303 type が curve の時にはカンマに続いて補間方式(spline, spline_close, bspline, bspline_close)を指定します。<br>
304 [例] -dline -dmark,10 -dcurve,spline_close</td></tr>
305 <tr><td>-omark_size</td><td>マークの大きさをmark_size にします。</td></tr>
306 <tr><td>-lline_style</td><td>ラインスタイルを指定します。<br>
307 例) -l100,40,40,40</td></tr>
308 <tr><td>-wline_width</td><td>ライン幅を line_width にします。</td></tr>
309 <tr><td>-cR, G, B</td><td>プロットカラーをRGBで指定します。</td></tr>
310 <tr><td>-CR, G, B</td><td>プロットタイプがmarkの時に使用される第2カラーをRGBで指定します。</td></tr>
311 <tr><td>-v{x|y}smooth</td><td>隣接平均数を smooth にします。</td></tr>
312 <tr><td>-sskip</td><td>先頭スキップ行数を skip にします。</td></tr>
313 <tr><td>-rstep</td><td>読込ステップ行数を step にします。</td></tr>
314 <tr><td>-ffinal_line</td><td>読込最終行数を final_line にします。</td></tr>
315 <tr><td>-m{x|y}math</td><td>変換数式を math にします。</td></tr>
316 <tr><td>-e{x|y}scale_type</td><td>軸のスケールタイプを scale_type にします。<br>
317 scal_type には linear, log, inverse を指定します。</td></tr>
318 <tr><td>-z{x|y}min, max, inc</td><td>軸の最小, 最大, 増分を min, max, inc で指定します。</td></tr>
319 </table>
320 </div>
321 </div>
322 </body>
323 </html>