## データファイルの形式

データファイルはテキストファイルで、基本的には次のようなフォーマットです。

コメント行
… (コメントは無くても構いません)
コメント行
カラム1 | カラム2 | カラム3 | カラム4 …
カラム1 | カラム2 | カラム3 | カラム4 …
% コメント行
カラム1 | カラム2 | カラム3 | カラム4 …
カラム1 | カラム2 | カラム3 | カラム4 …
… | … | … | …

データファイル中のコメント

- データファイル先頭部分はDataダイアログボックスの[読込]の先頭スキップ行数で指定した行数だけまとめて読み飛ばせるので, コメントなどを入れておくことができます。
- デフォルトでこの行数は0行です。
- コメントはなくてもかまいません。

ファイル途中へのコメントの挿入

- ファイル途中にコメントを入れるには行頭にDataダイアログボックスの[読込]で[コメント行]に設定されている文字を入れます。
- デフォルトでは # % ' です。

データファイルからの読み込み

- データファイルの第一行目にデータファイル埋め込みオプションを記述しておくと Dataダイアログボックスの[Load settings]ボタンを押して各種設定をデータファイルから読み取る事ができます。

データ

- カラム1, カラム2, カラム3, … に数値データを入れます。
- データファイルの最大カラム数は999個です。
- 一行の最大文字数は特に制限がありません。
- カラムの区切りはDataダイアログボックス[読込]の[区切り文字]で設定できます。
- デフォルトではスペース, コンマ, タブ, 括弧です。
- 改行コードは LF, CR LF, CR のいずれかです。

数値データの指数部指定

- 数値データの指数部指定子には e, E, Dが使えます。
- (例) 1.0D+002

空行の扱い

- ヌル行(区切文字のみからなる行)は読み飛ばします。

## 欠損データを含むデータファイル

Ngraph で欠損データを指定する方法を示します。例として，2行目のデータが欠落している場合を考えます。

X | Y | Z
1.0 | 2.0 | 3.0
2.0 |  | 4.0 | ← Yが欠落している
3.0 | 4.0 | 5.0

このまま, Dataダイアログボックスで(X) columnを1, (Y) columnを2にして描画すると, 2行目のYにはZの値が使われてしまいます。
欠損データを正しく描画するには | あるいは = を欠損部分に入れます。

1.0 | 2.0 | 3.0
2.0 | | | 4.0
3.0 | 4.0 | 5.0

あるいは

1.0 | 2.0 | 3.0
2.0 | = | 4.0
3.0 | 4.0 | 5.0

これでYの欠損データを正しくスキップします。

- | と = の違い
  - データプロット形式がmarkなどの点類とFitの場合は区別がありません。どちらでも同じグラフになります。
  - データプロット形式がlineなどの線類では異なります。 | では欠損データの前後を直線・曲線で結びます。 = ではその前後で直線・曲線が分断されます。
- 欠損データの別表記法
  - 'CONT' は '|' と同等です。
  - 'BREAK'は '=' と同等です。

欠損データの(あまりお勧めしない)指定方法

- 欠損部分を数値データではない文字で埋めます。

  1.0 | 2.0 | 3.0
  2.0 | A | 4.0
  3.0 | 4.0 | 5.0

  この方法では, 描画の度にエラーが出て一時停止します。
- 2行目の先頭に%#'のいずれかの記号(Dataダイアログボックスの[コメント行]で変更可能)を入れて2行目全体をスキップさせます。

  1.0 | 2.0 | 3.0
  %2.0 |  | 4.0
  3.0 | 4.0 | 5.0

  これでは2行目のデータはX, Y, Zとも初めから存在しないのと同じ事です。 従って, (Y) columnを3にしたとき, Z=4.0もスキップしてしまいます。

欠損データを利用した複数グラフの描画

- 欠損データの指定を応用して，データを = = で分断すれば一つのファイルで複数本のグラフを描画できます。
- [例]データを = = で分断して2本の直線からなるグラフを描く例を示します。

  1.0 | 2.0
  2.0 | 3.0
  3.0 | 4.0
  = | =
  4.0 | 5.0
  5.0 | 6.0
  6.0 | 7.0

## データプロット形式 diagonal, arrow, rectangle のデータファイル

データプロット形式 diagonal, arrow, rectangle, rectangle_fill, rectangle_solid_fill などを用いて対角線や矩形をプロットしたい時に用いるデータファイル形式です。
[例](0, 0)-(1, 1) と (1, 1)-(1, 2) に対角線, あるいは矩形を描きたいとき次のようなファイルを作り, (X) columnを1, (Y) columnを3にします。

0.0 | 0.0 | 1.0 | 1.0
1.0 | 1.0 | 1.0 | 2.0

始点のXとY, 終点のXとYはそれぞれ連続していなければなりません。 (4つが連続している必要はありません)

## データプロット形式errorbar_x, errorband_xのデータファイル

データプロット形式errorbar_xを用いて誤差棒をプロットすることができます。
例えば次のようなデータを考えます。

X | Error(X) | Y
1.0 | +/-0.5 | 2.0
2.0 | +/-1.0 | 3.0

このとき, 次のようなデータファイルを作り (X) columnを1、 (Y) column を4にします。

1.0 | -0.5 | +0.5 | 2.0
2.0 | -1.0 | +1.0 | 3.0

X, Xの誤差下限, Xの誤差上限 の3つのカラムは連続していなければなりません。

データプロット形式 errorband_x の場合は誤差棒の代わりに帯状の領域を描画します。

## データプロット形式errorbar_y, errorband_yのデータファイル

データプロット形式errorbar_yを用いて誤差棒をプロットすることができます。
例えば次のようなデータを考えます。

X | Y | Error(Y)
1.0 | 2.0 | +/-0.5
2.0 | 3.0 | +/-1.0

このとき, 次のようなデータファイルを作り, (X) columnを1, (Y) column を2にします。

1.0 | 2.0 | -0.5 | +0.5
2.0 | 3.0 | -1.0 | +1.0

Y, Yの誤差下限, Yの誤差上限 の3つのカラムは連続していなければなりません。

データプロット形式 errorband_y の場合は誤差棒の代わりに帯状の領域を描画します。

## データファイル埋め込みオプション

データファイルの一行目にデータファイル埋め込みオプションを記述しておくと、Dataダイアログボックスの [Load settings]ボタンで各種設定を取り込む事ができます。 複数のオプションを記述する場合には, 各オプションはスペース, タブで区切らなければなりません。

-xcolumn | (X) Column を column にします。
-ycolumn | (Y) Column を column にします。
-dtype[,{mark_type|interpolation}] | プロットタイプを type にします。 type が mark の時にはカンマに続いてマークの種類を数字で指定します。 type が curve の時にはカンマに続いて補間方式(spline, spline_close, bspline, bspline_close)を指定します。 [例] -dline -dmark,10 -dcurve,spline_close
-omark_size | マークの大きさをmark_size にします。
-lline_style | ラインスタイルを指定します。 例) -l100,40,40,40
-wline_width | ライン幅を line_width にします。
-cR, G, B | プロットカラーをRGBで指定します。
-CR, G, B | プロットタイプがmarkの時に使用される第2カラーをRGBで指定します。
-v{x|y}smooth | 隣接平均数を smooth にします。
-sskip | 先頭スキップ行数を skip にします。
-rstep | 読込ステップ行数を step にします。
-ffinal_line | 読込最終行数を final_line にします。
-m{x|y}math | 変換数式を math にします。
-e{x|y}scale_type | 軸のスケールタイプを scale_type にします。 scal_type には linear, log, inverse を指定します。
-z{x|y}min, max, inc | 軸の最小, 最大, 増分を min, max, inc で指定します。