C RCS $Id: gnuplot-ja.doc,v 1.41 2012/05/17 06:54:33 markisch Exp $

C corresponding original gnuplot.doc revision: 1.731

C

C Copyright (C) 1986 - 1993, 1998, 1999, 2000, 2001, 2004 Thomas Williams, Colin Kelley et al.

C

C Japanese translation: Hiroharu Tamaru (2.0, 3.2), MASUTANI Yasuhiro (3.5),

C Shigeharu Takeno et al (3.7, 4.X)

1 gnuplot

?gnuplot

C 下の contributers の表のアクセント文字は、現在のオリジナルでは UTF-8

C で書かれているが、それを HTML 名前参照形式に変更している。

^<h2 align="center"> An Interactive Plotting Program </h2>

^<p align="center"> Thomas Williams & Colin Kelley</p>

^<p align="center"> Version 4.4 organized by Ethan A Merritt and others</p>

^<p align="center">Major contributors (alphabetic order):<br>

^<br>

^ Hans-Bernhard Broeker, John Campbell,<br>

^ Robert Cunningham, David Denholm,<br>

^ Gershon Elber, Roger Fearick,<br>

^ Carsten Grammes, Lucas Hart,<br>

^ Lars Hecking, P&eacute;ter Juh&aacute;sz,<br>

^ Thomas Koenig, David Kotz,<br>

^ Ed Kubaitis, Russell Lang,<br>

^ Timoth&eacute;e Lecomte, Alexander Lehmann,<br>

^ Alexander Mai, Bastian M&auml;rkisch,<br>

^ Ethan A Merritt, Petr Mikul&iacute;k,<br>

^ Carsten Steger, Shigeharu Takeno,<br>

^ Tom Tkacik, Jos Van der Woude,<br>

^ James R. Van Zandt, Alex Woo, Johannes Zellner<br>

^</p>

^<p align="center"> Copyright (C) 1986 - 1993, 1998 - 2004 Thomas Williams, Colin Kelley<br>

^ Copyright (C) 2004 - 2011 various authors</p>

^<p align="center"> Mailing list for comments: <tt>[email protected]</tt><br>

^ Mailing list for bug reports: <tt>[email protected]</tt><br>

^ Web access (preferred): <tt>http://sourceforge.net/projects/gnuplot</tt></p>

^<p align="center"> This manual was originally prepared by Dick Crawford</p>

C 行が長いのは、できればなんとかしたい

2 著作権 (Copyright)

?copyright

?license

Copyright (C) 1986 - 1993, 1998, 2004, 2007 Thomas Williams, Colin Kelley

Permission to use, copy, and distribute this software and its

documentation for any purpose with or without fee is hereby granted,

provided that the above copyright notice appear in all copies and

that both that copyright notice and this permission notice appear

in supporting documentation.

Permission to modify the software is granted, but not the right to

distribute the complete modified source code. Modifications are to

be distributed as patches to the released version. Permission to

distribute binaries produced by compiling modified sources is granted,

provided you

1. distribute the corresponding source modifications from the

released version in the form of a patch file along with the binaries,

2. add special version identification to distinguish your version

in addition to the base release version number,

3. provide your name and address as the primary contact for the

support of your modified version, and

4. retain our contact information in regard to use of the base

software.

Permission to distribute the released version of the source code along

with corresponding source modifications in the form of a patch file is

granted with same provisions 2 through 4 for binary distributions.

This software is provided "as is" without express or implied warranty

to the extent permitted by applicable law.

AUTHORS

Original Software:

Thomas Williams, Colin Kelley.

Gnuplot 2.0 additions:

Russell Lang, Dave Kotz, John Campbell.

Gnuplot 3.0 additions:

Gershon Elber and many others.

Gnuplot 4.0 additions:

See list of contributors at head of this document.

(以下おおまかな訳; 訳は正しくないかも知れませんので詳しくは上記の原文

を当たってください。訳者は責任を持ちません。)

Copyright (C) 1986 - 1993, 1998, 2004, 2007 Thomas Williams, Colin Kelley

このソフトウェアとその付属文書の使用、複製、配布の許可は、上記の著作権

(copyright) 表示が、全ての複製物に書かれていること、および著作権表示と

この許諾文の両方がその支援文書に書かれていることを条件とした上で、この

文書により保証されます。

このソフトウェアの修正も認められています。しかし、修正を含む全ソースコ

ードの配布の権利は認められません。修正はリリース版に対するパッチの形で

配布しなければなりません。修正されたソースをコンパイルして作られたバイ

ナリの配布は、以下の条件の元で認められます:

1. リリース版からのソースの修正部分を、パッチの形でバイナリと共に配

布すること

2. ベースとなるリリース版と区別するために、そのバージョン番号に特別

なバージョン指定子を付加すること

3. その修正版のサポート用に、あなたの名前とアクセス可能なアドレスと

を提供すること

4. ベースとなるソフトウェアの使用に関しては、我々の連絡情報を保持し

続けること

リリース版のソースコードを、パッチの形でのソースの修正と一緒に配布する

ことは、バイナリ配布に関する条項 2 から 4 までの条件の元で許されます。

このソフトウェアは "あるがまま" 提供され、適用可能な法律で許められる範

囲の保証を表明あるいは暗示していはいません。

著者

オリジナルソフトウェア:

Thomas Williams, Colin Kelley.

Gnuplot 2.0 追加:

Russell Lang, Dave Kotz, John Campbell.

Gnuplot 3.0 追加:

Gershon Elber とその他の人々。

Gnuplot 4.0 追加:

この文書の最初にある寄与者 (contributors) のリスト参照。

2 はじめに (Introduction)

?introduction

?

`gnuplot` は、ポータブルなコマンド入力方式のグラフユーティリティで、

Linux, OS/2, MS Windows, OSX, VMS, その他多くのプラットホーム上で動作

します。ソースコードには著作権がありますが、無料で配布されています (す

なわち、それに対価を支払う必要はありません)。元は、科学者や学生が数学

関数やデータなどを対話的に表示できるよう作られたのですが、現在までに、

例えば Web スクリプトなど、多くの非対話型の利用もサポートするように成

長しています。これは、例えば Octave のようにサードパーティのアプリケー

ションの描画エンジンとしても使われています。gnuplot は、1986 よりサポ

ートと活発な開発が行われています。

gnuplot は、2 次元、または 3 次元の、多くの種類のグラフをサポートして

います: 折線グラフ、点グラフ、棒グラフ、等高線、ベクトル場描画、曲面、

そしてそれらに関連するさまざまな文字列等。そしてさらにいくつかの特別な

描画型もサポートしています。

gnuplot は多くの異なる出力をサポートしています: 対話型スクリーン出力形

式 (マウスやホットキー入力も可能)、ペンプロッタや現在のプリンタへの直

接出力、または多くのファイル形式への出力 (eps, emf, fig, jpeg, LaTeX,

pdf, png, postscript, ...)。gnuplot は、容易に新しい出力形式を追加する

よう拡張することができます。最近追加された対話型出力形式には、

wxWidgets (複数のプラットホームで利用可能), Qt を元にしたものがありま

す。svg や HTML5 canvas 出力形式を利用すれば、グラフを Web ページ内に

マウス利用可能な形で埋め込んだ出力を生成することもできます。

`gnuplot` のコマンド言語は大文字小文字を区別します。すなわち、小文字で

書かれたコマンドや関数名は、それらを大文字で書いたものとは同じではあり

ません。いずれのコマンドも、あいまいさの無い限りにおいて省略することが

できます。1 行中にはセミコロン (;) で区切って複数のコマンドを書くこと

ができます。文字列は単一引用符、あるいは二重引用符のどちらかで書き始め

ますが、両者には微妙な違いがあります (詳細は、以下参照: `syntax`)。例:

load "filename"

cd 'dir'

コマンドは、複数行にまたがることができます。その場合は、最終行以外の

全ての行の行末にバックスラッシュ (\) を書く必要があります。バックスラ

ッシュは必ず各行 *最後* の文字でなくてはなりません。その結果としてバッ

クスラッシュと、それに続く改行文字が存在しなかったかのように扱われます。

つまり、改行文字がスペースの役をすることもありませんし、改行によってコ

メントが終了することもありません。ですから複数行にまたがる行の先頭をコ

メントアウトすると、そのコマンド全体がコメントアウトされることになりま

す (以下参照: `comments`)。なお注意しますが、もし、複数行のコマンドの

どこかでエラーが起きたとき、パーサはその場所を正確には指示することがで

きませんし、また、正しい行に指示する必要もないでしょう。

このドキュメントにおいて、中括弧 ({}) は省略可能な引数を表すものとし、

縦棒 (|) は、互いに排他的な引数を区切るものとします。`gnuplot` のキー

ワードや `help` における項目名は、バッククオート (｀) または可能な場合

には `boldface` (太字) で表します。角括弧 (<>) は、それに対応するもの

に置き換えられるべきものを表します。多くの場合、オプションの引数には、

それが省略されるとデフォルトの値が使用されます。しかし、これらの場合、

必ずしも角括弧が中括弧で囲まれて書かれているわけではありません。

ある項目についてのヘルプが必要なときには、`help` に続けてその項目名を

入力して下さい。または単に `help ?` でもヘルプの項目のメニューが現われ

ます。

初めて `gnuplot` を使う方は、`plotting` に関する説明から読みはじめると

良いでしょう (対話型で使用中ならば `help plotting` と入力して下さい)。

simple.dem デモを参照してください。あるいは以下の Web ページにも他のデ

モと一緒にあります。

^ <a href="http://www.gnuplot.info/demo/">

http://www.gnuplot.info/demo/

^ </a>

`gnuplot` はコマンドラインから、あるいはデスクトップ環境のアイコンから

起動することができます。コマンドラインから起動するときは、以下の書式が

使えます。

gnuplot {OPTIONS} file1 file2 ...

ここで file1, file2 等は、`local` コマンドで取り込むのと同等の入力ファ

イル (スクリプトファイル) です。

X11 ベースのシステムでは、以下の書式が使えます。

gnuplot {X11OPTIONS} {OPTIONS} file1 file2 ...

詳細は、X11 のドキュメント、および以下参照: `x11`。

gnuplot に与えるオプションは、コマンド行のどこに置いても構いません。フ

ァイルは指定した順に実行され、同様に -e オプションで任意のコマンドを与

えることもできます。例:

gnuplot file1.in -e "reset" file2.in

特別なファイル名 "-" は、標準入力から読ませるのに使います。`gnuplot`

は最後のファイルを処理し終わると終了します。読み込ませるファイルを一つ

も指定しない場合は、`gnuplot` は標準入力からの対話入力を取ります。詳細

は、以下参照: `batch/interactive`。gnuplot 用のオプションについては、

以下のようにして一覧を見ることができます:

gnuplot --help

詳細は以下参照: `command line options`。

対話型描画ウィンドウでの作業中は、'h' を打つとホットキー (`hotkeys`)

とマウス機能 (`mousing`) に関するヘルプを見ることができます。

`seeking-assistance` のセクションは、さらなる情報やヘルプ、FAQ を探す

手掛りを与えてくれるでしょう。

2 探し出す手助け (Seeking-assistance)

?help-desk

?faq

?FAQ

?seeking-assistance

公式の gnuplot Web ページは以下にあります。

^ <a href="http://www.gnuplot.info">

http://www.gnuplot.info

^ </a>

助けを求める前に、ファイル FAQ.pdf か、または上の Web サイトの

^ <a href="http://www.gnuplot.info/faq/">

FAQ (度々聞かれる質問; Frequently Asked Questions) の一覧

^ </a>

をチェックしてください。

gnuplot ユーザとしての手助けが必要なら、以下のニュースグループを利用し

てください。

comp.graphics.apps.gnuplot

私達はメーリングリストに参加するより、むしろニュースグループのメッセー

ジを読むことを勧めます。メーリングリストも有効で、同じメッセージ列を配

送しています。メーリングリストに参加する方法に関しては、SouceForge に

ある gnuplot の開発 Web サイト

^ <a href="http://sourceforge.net/projects/gnuplot">

http://sourceforge.net/projects/gnuplot

^ </a>

を参照してください。

メーリングリストメンバーへのメールアドレス:

[email protected]

バグリポート、ソースの改良等は以下の trackers に upload してください:

http://sourceforge.net/projects/gnuplot/support

ただし、リポートを送る前に、あなたがリポートしようとしているバグが、よ

り新しい gnuplot で既に修正されていないかチェックしてください。

開発版に関するメーリングリスト:

[email protected]

何か質問を投稿するときは、あなたが使用している gnuplot のバージョン、

出力形式、オペレーティングシステム、といった全ての情報を含むようにして

ください。その問題を引き起こす「小さい」スクリプトがあればなお良いです。

その場合、データファイルのプロットよりも関数のプロットの方がより良いで

す。

2 新しい機能 (New features)

?new-features

この節では、バージョン 4.6 以降に追加、変更された主なものを紹介します。

より網羅的な一覧は、ファイル NEWS を参照してください。

* 新しい座標系 (度、分、秒)。以下参照: `set xdata geographic`。

* 32-bit のアルファ値 + RGB 色表記 (#AARRGGBB) を新たにサポート。以下

参照: `colorspec`。

* NaN や他の予期せぬ入力データの処理の変更。以下参照: `missing`。

2 非推奨な書式 (Deprecated syntax)

?deprecated syntax

?backwards compatibility

?compatibility

以前の版で使われていたいくつかの書式は gnuplot 4 で非推奨となりました

が、後方互換性を持たせるためのコンパイル時のオプションが用意されていま

す。古い書式のサポートは現在は削除されています。

非推奨:

set title "Old" 0,-1

set data linespoints

plot 1 2 4 # horizontal line at y=1

新:

TITLE = "New"

set title TITLE offset char 0, char -1

set style data linespoints

plot 1 linetype 2 pointtype 4

2 バッチ/対話型操作 (Batch/Interactive)

?batch/interactive

?command line options

`gnuplot` は多くのシステム上で、バッチ処理形式、あるいは対話型のどちら

の形式でも実行でき、それらを組み合わせることも可能です。

コマンドライン引数は、プログラムへのオプション (文字 - で始まる) か、

`gnuplot` コマンドを含むファイルの名前であると解釈されます。

-e "command" の形式のオプションは、gnuplot コマンドを強制的に実行させ、

各ファイルとこのコマンド文字列は、指定された順に実行されます。特別なフ

ァイル名 "-" は、コマンドを標準入力から読み込むことを意味します。最後

のファイルを実行した後に `gnuplot` は終了します。読み込ませるファイル、

およびコマンド文字列を指定しなかった場合は、`gnuplot` は標準入力からの

対話型の入力を受け付けます。

`exit` と `quit` はどちらも現在のコマンドファイルを終了し、まだ全ての

ファイルが終っていなければ、次のファイルを `load` するのに使われます。

例:

対話を開始する:

gnuplot

2 つのコマンドファイル "input1", "input2" を使ってバッチ処理を行なう:

gnuplot input1 input2

初期化ファイル "header" の後、対話型モードを起動し、その後別のコマンド

ファイル "tailer" を実行する:

gnuplot header - trailer

コマンドラインから `gnuplot` コマンドを直接与え、終了後にスクリーン上

にグラフが残るようにオプション "-persist" を使う:

gnuplot -persist -e "set title 'Sine curve'; plot sin(x)"

ファイルのコマンドを実行する前に、ユーザ定義変数 a と s をセットする:

gnuplot -e "a=2; s='file.png'" input.gpl

2 キャンバスサイズ (Canvas size)

?canvas size

?canvas

?set term size

gnuplot の以前の版では、`set size` の値を、出力する描画領域 (キャンバ

ス) のサイズを制御するのにも使っていた出力形式もありましたが、すべての

出力形式がそうだったわけではありませんでした。この目的のために

`set size` を使用することは version 4.2 で非推奨となり、version 4.4 以

降は、ほとんどの出力形式が以下のルールに従うようになりました:

`set term <terminal_type> size <XX>, <YY>` は、出力ファイルのサイズ、

または "キャンバス" のサイズを制御します。デフォルトでは、グラフはその

キャンバス全体に描画されます。

`set size <XX>, <YY>` は、描画自体をキャンバスのサイズに対して相対的に

伸縮させます。1 より小さい伸縮値を指定すると、グラフはキャンバス全体を

埋めず、1 より大きい伸縮値を指定すると、グラフの一部分のみがキャンバス

全体に合うように描画されます。1 より大きい伸縮値を指定すると、ある出力

形式では問題が起こるかもしれないことに注意してください。

このルールに沿わない主な例外は PostScript ドライバで、デフォルトでは以

前の版のと同じ振舞いをします。gnuplot の次の版では、PostScript ドライ

バも同様にデフォルトの振舞いを変更することになるでしょう。

例:

set size 0.5, 0.5

set term png size 600, 400

set output "figure.png"

plot "data" with lines

このコマンドは、幅 600 ピクセル、高さ 400 ピクセルの出力ファイル

"figure.png" を生成します。グラフはキャンバスの中の左下に置かれます。

これは、multiplot モードが常に行ってきた方法と矛盾しません。

2 コマンドライン編集 (Command-line-editing)

?line-editing

?editing

?command-line-editing

コマンドラインでの編集機能とコマンドヒストリの機能は、外部の GNU

readline ライブラリか外部の BSD libedit ライブラリ、または組み込まれて

いる同等のもののいずれかを使ってサポートしています。この選択は、

gnuplot のコンパイル時の configure のオプションで行います。

組み込みの readline 版の場合の編集コマンドは以下の通りですが、DEL キー

に関する動作はシステムに依存することに注意してください。GNU readline

ライブラリと BSD libedit ライブラリに関しては、それ自身のドキュメント

を参照してください。

@start table - まずは対話型テキスト形式

`行編集`:

^B 1 文字前へ戻す

^F 1 文字先へ進める

^A 行の先頭に移動

^E 行の最後に移動

^H 直前の文字を削除

DEL 現在の文字を削除

^D 現在位置の文字を削除、空行なら EOF を送信

^K 現在位置から行末まで削除

^L,^R 壊れた表示の行を再表示

^U 行全体の削除

^W 直前の単語を削除

`履歴`:

^P 前の履歴へ移動

^N 次の履歴へ移動

#\begin{tabular}{|cl|} \hline

#\multicolumn{2}{|c|}{コマンド行編集コマンド} \\ \hline \hline

#文字 & 機能 \\ \hline

# & \multicolumn{1}{|c|}{行編集}\\ \cline{2-2}

#\verb~^B~ & 1 文字前へ戻す\\

#\verb~^F~ & 1 文字先へ進める\\

#\verb~^A~ & 行の先頭へ移動\\

#\verb~^E~ & 行の最後へ移動\\

#\verb~^H~ & 直前の文字を削除\\

#\verb~DEL~ & 現在の文字を削除\\

#\verb~^D~ & 現在位置の文字を削除、空行なら EOF\\

#\verb~^K~ & 現在位置から行末まで削除\\

#\verb~^L, ^R~ & 壊れた表示の行を再表示\\

#\verb~^U~ & 行全体の削除\\

#\verb~^W~ & 直前の単語を削除\\ \hline

# & \multicolumn{1}{|c|}{履歴} \\ \cline{2-2}

#\verb~^P~ & 前の履歴へ移動\\

#\verb~^N~ & 次の履歴へ移動\\

%c l .

%文字@機能

%_

%@行編集

%^B@1 文字前へ戻す

%^F@1 文字先へ進める

%^A@行の先頭に移動

%^E@行の最後に移動

%^H@直前の文字を削除

%DEL@現在の文字を削除

%^D@現在位置の文字を削除、空行なら EOF

%^K@現在位置から行末まで削除

%^L, ^R@壊れた表示の行を再表示

%^U@行全体の削除

%^W@直前の単語を削除

%_

%@履歴

%^P@前の履歴へ移動

%^N@次の履歴へ移動

@end table

^<table align="center" border="1" rules="groups" frame="hsides" cellpadding="3">

^<colgroup>

^ <col align="center">

^ <col align="left">

^</colgroup>

^<thead>

^<tr> <th>文字</th> <th>機能</th></tr>

^</thead>

^<tbody>

^<tr> <td></td> <th>行編集</th></tr>

^<tr> <td><tt>^B</tt></td> <td>1 文字前へ戻す</td></tr>

^<tr> <td><tt>^F</tt></td> <td>1 文字先へ進める</td></tr>

^<tr> <td><tt>^A</tt></td> <td>行の先頭へ移動</td></tr>

^<tr> <td><tt>^E</tt></td> <td>行の最後へ移動</td></tr>

^<tr> <td><tt>^H</tt></td> <td>直前の文字を削除</td></tr>

^<tr> <td><tt>DEL</tt></td> <td>現在の文字を削除</td></tr>

^<tr> <td><tt>^D</tt></td> <td>現在位置の文字を削除、空行なら EOF</td></tr>

^<tr> <td><tt>^K</tt></td> <td>現在位置から行末まで削除</td></tr>

^<tr> <td><tt>^L, ^R</tt></td> <td>壊れた表示の行を再表示</td></tr>

^<tr> <td><tt>^U</tt></td> <td>行全体の削除</td></tr>

^<tr> <td><tt>^W</tt></td> <td>直前の単語を削除</td></tr>

^</tbody>

^<tbody>

^<tr> <th></th> <th>履歴</th></tr>

^<tr> <td><tt>^P</tt></td> <td>前の履歴へ移動</td></tr>

^<tr> <td><tt>^N</tt></td> <td>次の履歴へ移動</td></tr>

^</tbody>

^</table>

2 コメント (Comments)

?comments

コメントは次のように実装されています: 文字 '#' は、行中のたいていの場

所に書くことができます。このとき `gnuplot` はその行の残りの部分を無視

します。ただし、引用符の中、数 (複素数を含む) の中、コマンド置換

(command substitution) の中などではこの効果がありません。簡単に言うと

意味のあるような使い方をしさえすれば、正しく動作すると言うことです。

データファイル中のコメント文字の指定については、以下参照:

`set datafile commentschars`。コメント行が '\' で終わっている場合、次

の行もコメントとして扱われることに注意してください。

2 座標系 (Coordinates)

?coordinates

=axes

コマンド `set arrow`, `set key`, `set label`, `set object` はグラフ上

の任意の位置が指定できます。その位置は以下の書式で指定します:

{<system>} <x>, {<system>} <y> {,{<system>} <z>}

各座標系指定 <system> には、`first`, `second`, `graph`, `screen`,

`character` のいずれかが入ります。

`first` は左と下の軸で定義される x,y (3D の場合は z も) の座標系を使用

します。`second` は x2, y2 軸 (上と右の軸) を使用します。`graph` はグ

ラフ描画領域内の相対的位置を指定し、左下が 0,0 で 右上が 1,1 (splot の

場合はグラフ描画領域内の左下が 0,0,0 で、土台の位置は負の z の値を使用

します。以下参照: `set xyplane`) となります。`screen` は表示範囲内 (範

囲全体であり、`set size` で選択される一部分ではありません) を指定し、

左下が 0,0 で 右上が 1,1 となります。`character` は、画面領域の左下

(screen 0,0) からの、文字の幅、文字の高さでの位置を与えます。よって、

`character` 座標は、選択されたフォントのサイズに依存します。

x の座標系が指定されていない場合は `first` が使われます。y の座標系が

指定されていない場合は x に対する座標系が使用されます。

与える座標が絶対的な位置ではなくて相対的な値である場合もあります (例え

ば `set arrow` ... `rto` の 2 番目の数値)。そのほとんどが、与えられた

数値を最初の位置に対する差として使います。与えられた座標が対数軸内にあ

る場合は、その相対的な値は倍率として解釈されます。例えば

set logscale x

set arrow 100,5 rto 10,2

は、x 軸が対数軸で y 軸が線形の軸なので、100,5 の位置から 1000,7 の位

置への矢印を書くことになります。

一つ (あるいはそれ以上) の軸が時間軸である場合、`timefmt` の書式文字列

に従って、引用符で囲まれた時間文字列で適切な座標を指定する必要がありま

す。以下参照: `set xdata`, `set timefmt`。また、`gnuplot` は整数表記も

認めていて、その場合その整数は 2000 年 1 月 1 日からの秒数と解釈されま

す。

2 文字列データ (Datastrings)

?datastrings

データファイルには、ホワイトスペース (空白やタブ) を含まない任意の印字

可能な文字列、あるいは 2 重引用符で囲まれた任意の文字列 (ホワイトスペ

ースが含まれても良い)、のいずれかの形からなる文字列データを持たせるこ

とも可能です。データファイルに次のような行が含まれている場合、それは 4

つの列を含み、3 列目がテキスト部分であると見なされます:

1.000 2.000 "Third column is all of this text" 4.00

テキスト部分は 2 次元や 3 次元描画内で例えば以下のように使用されます:

plot 'datafile' using 1:2:4 with labels

splot 'datafile using 1:2:3:4 with labels

テキスト部分の列データは 1 つ、または複数の描画軸の目盛りのラベルとし

て使用できます。次の例は、入力データの 3 列目と 4 列目を (X,Y) 座標と

して取り出し、それらの点の列を結ぶ線分を描画します。しかしこの場合

gnuplot は、x 軸に沿って標準的に間の空いた数字ラベルのついた目盛り刻み

をつけるのではなく、入力データファイルの 1 行目の X 座標の位置に、目盛

り刻みと文字列を x 軸に沿ってつけて行きます。

set xtics

plot 'datafile' using 3:4:xticlabels(1) with linespoints

=columnheader

入力データの列の最初のエントリ (すなわち列の見出し) をテキスト部分と解

釈するもう一つのオプションがあり、それはテキスト部分を、その描画した列

のデータの説明 (key) のタイトル部分として使用します。次の例は、先頭の

行の 2 列目の部分を説明ボックス内のタイトルを生成するのに使用し、その

後の列の 2,4 列目は要求された曲線を描画するのに処理されます:

plot 'datafile' using 1:(f($2)/$4) with lines title columnhead(2)

別の例:

plot for [i=2:6] 'datafile' using i title "Results for ".columnhead(i)

以下参照: `set style labels`, `using xticlabels`, `plot title`,

`using`。

2 拡張文字列処理モード (Enhanced text mode)

?enhanced text

?enhanced

多くの出力形式が、拡張文字列処理モード (enhanced text mode) をサポート

しています。これは、文字列に追加の書式情報を埋めこみます。例えば "x^2"

は x の自乗を、通常我々が見る上付きの 2 がついた形で書き出します。この

モードは、例えば、"set term png enhanced" のように普通は出力形式を設定

するときに選択しますが、後で "set termoption enhanced" を使ってその機

能を有効/無効にもできますし、"set label 'x_2' noenhanced" のように個々

の文字列に適用することもできます。

@start table - まずは対話型テキスト形式

制御記号 例 説明

^ a^x 上付き文字

_ a_x 下付き文字

@ @x, a@^b_{cd} 空ボックス (幅がない)

& &{space} 指定した長さのスペースを挿入

~ ~a{.8-} 'a' の上に '-' を、現在のフォントサ

イズの .8 倍持ち上げた位置に重ね書き

#\begin{tabular}{|cccl|} \hline

#\multicolumn{4}{|c|}{拡張文字列制御記号} \\ \hline

#制御記号 & 例 & 結果 & 説明 \\ \hline

#\verb~^~ & \verb~a^x~ & $a^x$ & 上付き文字\\

#\verb~_~ & \verb~a_x~ & $a_x$ & 下付き文字\\

#\verb~@~ & \verb~a@^b_{cd}~ & $a^b_{cd}$ & 空ボックス (幅がない)\\

#\verb~&~ & \verb~d&{space}b~ & d\verb*+ +b & 指定した長さのスペースを挿入\\

#\verb|~| & \verb|~a{.8-}| & $\tilde{a}$ & 'a' の上に '-' を、現在のフォントサ\\

#\verb~ ~ & \verb~ ~ & ~ ~ & イズの .8 倍持ち上げた位置に重ね書き\\

%c c l .

%.TE", /* ugly - doc2ms uses @ for column separator, but here we */

%.TS", /* need @ in table, so end and restart the table ! */

%center box tab ($) ;

%c c l .

%制御記号$例$説明

%_

%^$a^x$上付き文字

%\&_$a\&_x$下付き文字

% @ $ @x, a\&@^b\&_{cd}$空ボックス (幅がない)

% & $ &{space}$指定した長さのスペースを挿入

% ~ $ ~a{.8-}$'a' の上に '-' を、現在のフォントサ

% $ $イズの .8 倍持ち上げた位置に重ね書き

@end table

^<table align="center" border="1" rules="groups" frame="hsides" cellpadding="3">

^<colgroup>

^ <col align="center">

^ <col align="center">

^ <col align="left">

^</colgroup>

^<thead>

^<tr> <th>制御記号</th> <th>例</th> <th>説明</th></tr>

^</thead>

^<tbody>

^<tr> <td><tt> ^ </tt></td> <td><tt>a^x</tt></td> <td>上付き文字</td></tr>

^<tr> <td><tt> _ </tt></td> <td><tt>a_x</tt></td> <td>下付き文字</td></tr>

^<tr> <td><tt> @ </tt></td> <td><tt> @x</tt>, <tt>a@^b_{cd}</tt></td> <td>空ボックス (幅がない)</td></tr>

^<tr> <td><tt> &amp;</tt></td> <td><tt> &amp;{space}</tt></td> <td>指定した長さのスペースを挿入</td></tr>

^<tr> <td><tt> ~ </tt></td> <td><tt> ~a{.8-}</tt></td> <td>'a' の上に '-' を、現在のフォントサ<br>イズの .8 倍持ち上げた位置に重ね書き</td></tr>

^</tbody>

^</table>

中カッコは一文字が期待される箇所に複数の文字を書く場合に使われます (例

えば 2^{10})。フォント、およびそのサイズを変更するには、以下の形式を使

ってください: {/[fontname][=fontsize | *fontscale] text} よって、例え

ば {/Symbol=20 G} は 20 ポイントのΓ (ガンマ)に、{/*0.75 K} は現在の有

効なフォントサイズの 3/4 の大きさの K になります (文字 '/' は、'{' の

直後の文字でなくてはなりません)。

空ボックス (phantom box) は a@^b_c の上付き文字と下付き文字を揃えると

きに有用ですが、文字にアクセント記号を重ねる場合にはうまく働きません。

後者の目的のためには、色々なアクセントやその他のダイアクリティカルマ

ークのある多くの文字を持つエンコード (例えば iso_8859_1 や utf8) を使

用する方がいいでしょう。以下参照: `set encoding`。そのボックスはスペー

シングが行なわれないので、ボックス内 (つまり @ の後ろ) の上付き文字や

下付き文字を短く出力するのに適しています。

ある文字列と同じ長さのスペースを文字 '&' を使うことで入れることができ

ます。すなわち、

'abc&{def}ghi'

は以下を生成します (abc と ghi の間は 3 文字分の空白):

'abc ghi'

文字 '~' は、次の文字、またはカッコで囲まれた文字列に、それに続く文字

またはカッコで囲まれた文字列を重ね書きします。2 番目の文字は最初の文字

にあわせて水平方向にセンタリングされます。よって '~a/' は 'a' を貫くよ

うなスラッシュが得られます。2 番目の文字は、その前に数字を置くことで垂

直方向に移動させることができます。その数字は現在のフォントサイズに対す

る割合を意味し、それに従って文字が上がったり下がったりします。この場合

数字と文字列は 1 文字より長くなるのでカッコで囲む必要があります。重ね

書きされる文字列が数字から始まっている場合は、垂直にずらす値と文字列と

の間にスペースを入れてください ('~{abc}{.5 000}')。それ以外はスペース

は不要です ('~{abc}{.5---}')。一方、あるいは両方のフォントを変更するこ

ともできます ('~a{.5 /*.2 o}'; 'a' その 1/5 の大きさの 'o'、この場合数

字とスラッシュの間のスペースは必要です) が、その文字列が始まった後で変

更することはできません。それぞれの文字列内で、他の特殊な書式を使うこと

もできません。もちろん、'~a{\^}' のように特殊な文字をエスケープするこ

と (下記参照) は可能です。

\文字コード (8 進数) を指定することで特殊な記号を指定することができま

す。例えば、{/Symbol \245} は無限大の記号になります。しかし、これは、

UTF-8 のようなマルチバイトエンコードの場合にはうまくいきません。UTF-8

環境では、タイプ入力するかまたは別のやり方であなたが望む文字を選択する

ことでマルチバイト列を入力できるようにすべきです。

制御文字は、 \\ や \{ などのように \ を使ってエスケープできます。

しかし、二重引用符内の文字列は単一引用符内の文字列とは異なって解釈され

ることを知っておいてください。主な違いは、二重引用符内の文字列ではバッ

クスラッシュは 2 つ重ねる必要があることです。

例 (これらは言葉で説明するのは難しいのでとりあえずやってみてください):

set xlabel 'Time (10^6 {/Symbol m}s)'

set title '{/Symbol=18 \\362@_{/=9.6 0}^{/=12 x}} \\

{/Helvetica e^{-{/Symbol m}^2/2} d}{/Symbol m}'

gnuplot ソース配布物内の /docs/psdoc サブディレクトリにあるファイル

"ps_guide.ps" に、拡張された書式に関する例が更に載っています。

2 環境変数 (Environment)

?environment

`gnuplot` は多くのシェル環境変数を認識します。必須のものはありませんが、

使えば便利になるかも知れません。

GNUTERM が定義されている場合、それは使用される出力形式 (terminal) の名

前として使われます。これは `gnuplot` が起動時に見つけた出力形式に優先

して使用されますが、.gnuplot (またはそれに相当する) スタートアップファ

イル (以下参照: `startup`) による指定や、当り前のことですが、その後に

明示的に指定した物の方が優先されます。

GNUHELP にヘルプファイル (gnuplot.gih) のパス名を定義しておくことがで

きます。

VMS では、論理名 GNUPLOT$HELP を `gnuplot` のヘルプライブラリの名前と

して定義します。`gnuplot` のヘルプは任意のシステムのヘルプライブラリに

入れることができ、`gnuplot` の内部からでも外部からでも参照して構いませ

ん。

Unix においては、カレントディレクトリに .gnuplot というファイルがない

場合には、HOME に定義されたディレクトリを探します。MS-DOS, Windows,

OS/2 では GNUPLOT がその役割に使われます。Windows では、NT 専用の変数

USERPROFILE も参照されます。VMS では SYS$LOGIN です。`help startup`

と打ってみてください。

Unix においては、PAGER がヘルプメッセージの出力用のフィルタとして使わ

れます。

Unix では、SHELL が `shell` コマンドの際に使われます。MS-DOS, OS/2 で

は COMSPEC が `shell` コマンドの際に使われます。

FIT_SCRIPT は、当てはめ (fit) が中断されたときに実行する `gnuplot` コ

マンドの指定に使われます。以下参照: `fit`。FIT_LOG は当てはめによるロ

グファイルのデフォルトのファイル名の指定に使われます。

GNUPLOT_LIB は、データやコマンドファイルの検索ディレクトリを追加定義す

るのに使われます。その変数は、一つのディレクトリ名かまたは複数のディレ

クトリ名を書くことができますが、ディレクトリの区切りはプラットホーム毎

に違います。例えば Unix では ':' で、MS-DOS, Windows, OS/2 では ';' で

す。GNUPLOT_LIB の値は変数 `loadpath` に追加されますが、それは `save`

や `save set` コマンドでは保存されません。

出力ドライバの中には gd ライブラリ経由で TrueType フォントを扱えるもの

もいくつかあります。これらのドライバのフォント検索パスは、環境変数

GDFONTPATH で制御できます。さらに、それらのドライバでのデフォルトのフ

ォントは環境変数 GNUPLOT_DEFAULT_GDFONT で制御できます。

postscript 出力ドライバは自分で持っているフォント検索パスを使いますが、

それは環境変数 GNUPLOT_FONTPATH で制御できます。書式は GNUPLOT_LIB と

同じです。GNUPLOT_FONTPATH の値は変数 `fontpath` に追加されますが、そ

れは `save` や `save set` コマンドでは保存されません。

PostScript ドライバは、外部 (組み込まれていない) 定義ファイルを探すた

めに環境変数 GNUPLOT_PS_DIR を利用します。インストール時の作業により、

gnuplot にはそれらのファイルのコピーが組み込まれているか、またはデフォ

ルトのパスが埋め込まれています。この変数は、postscript 出力形式でデフ

ォルトのファイルの代わりにカスタマイズした prologue ファイルを使用する

のに利用できます。以下参照: `postscript prologue`。

2 式 (Expressions)

?expressions

基本的には C, FORTRAN, Pascal, BASIC において利用可能な数学表現を使用

できます。 演算子の優先順位は C 言語の仕様に従います。数式中の空白文字

とタブ文字は無視されます。

複素数の定数は {<real>,<imag>} と表現します。ここで <real> と <imag>

(実部、虚部) は数値定数である必要があります。例えば {3,2} は 3 + 2i を

あらわし、{0,1} は 'i' 自身を表します。これらには明示的に中カッコを使

う必要があります。

=division

gnuplot は "実数" と "整数" 演算を FORTRAN や C のように扱うということ

に注意してください。"1", "-10" などは整数と見なされ、"1.0", "-10.0",

"1e1", 3.5e-1 などは実数と見なされます。 これら 2 つのもっとも重要な違

いは割算です。整数の割算は切り捨てられます: 5/2 = 2。実数はそうではあ

りません: 5.0/2.0 = 2.5。それらが混在した式の場合、計算の前に整数は実

数に "拡張" されます: 5/2e0 = 2.5。負の整数を正の整数で割る場合、その

値はコンパイラによって変わります。"print -5/2" として、あなたのシステ

ムが -2 と -3 のどちらを答えとするかを確認してください。

数式 "1/0" は "未定義値 (undefined)" フラグを生成し、それによりその点

を無視します。あるいは、あらかじめ定義されている値 NaN を使っても同じ

ことになります。例については、以下参照: `using`。

=NaN

複素数表現の実数部分、虚数部分は、どんな形で入力されても常に実数です:

{3,2} の "3" と "2" は実数であり、整数ではありません。

gnuplot は文字列に対する単純な演算、および文字列変数も利用できます。例

えば式 ("A" . "B" eq "AB") は真と評価されますが、これは文字列の結合演

算子と文字列の等号演算子を意味しています。

数としての値を含む文字列は、それが数式で利用された場合は、対応する整数

や実数に変換されます。よって、("3" + "4" == 7) や (6.78 == "6.78") は

どちらも真になります。整数は、それが文字列結合演算子で使われた場合は文

字列に変換されますが、実数や複素数はダメです。典型的な例は、ファイル名

や他の文字列内に整数を使う場合でしょう: 例えば ("file" . 4 eq "file4")

は真です。

後置指定する範囲記述子 [beg:end] によって、部分文字列を指定することが

できます。例えば、"ABCDEF"[3:4] == "CD" で、"ABCDEF"[4:*] == "DEF" で

す。書式 "string"[beg:end] は、文字列値の組み込み関数

substr("strings",beg,end) を呼ぶこととほぼ同じですが、関数呼び出しでは

beg, end は省略することはできません。

3 関数 (Functions)

?expressions functions

`gnuplot` の数学関数は、Unix 数学ライブラリの関数とほぼ同じですが、特

に注意がなければ全ての関数が整数、実数、複素数の引数を取ることができま

す。角を引数や戻り値とする関数 (例えば sin(x), cos(x), arg(z)) は、そ

の値をラジアンとして扱いますが、これはコマンド `set angles` によって度

に変更できます。

^<table align="center" border="1" rules="groups" frame="hsides" cellpadding="3" width="90%">

^<colgroup>

^ <col align="center">

^ <col align="center">

^ <col align="left">

^</colgroup>

^<thead>

^<tr> <th colspan="3"> 数学ライブラリ関数 </th></tr>

^<tr> <th>関数</th> <th>引数</th> <th>戻り値</th></tr>

^</thead>

^<tbody>

^<tr> <td>abs(x)</td> <td>任意</td> <td>|<i>x</i>|, <i>x</i> の絶対値; 同じ型</td></tr>

^<tr> <td>abs(x)</td> <td>複素数</td> <td>length of <i>x</i>, &radic;( Re(<i>x</i>)² + Im(<i>x</i>)² )</td></tr>

^<tr> <td>acos(x)</td> <td>任意</td> <td>cos^-1 <i>x</i> (アークコサイン)</td></tr>

^<tr> <td>acosh(x)</td> <td>任意</td> <td>ラジアンでの cosh^-1 <i>x</i> (逆双曲余弦)</td></tr>

^<tr> <td>airy(x)</td> <td>任意</td> <td>エアリー (Airy) 関数 Ai(<i>x</i>)</td></tr>

^<tr> <td>arg(x)</td> <td>複素数</td> <td><i>x</i> の偏角</td></tr>

^<tr> <td>asin(x)</td> <td>任意</td> <td>sin^-1 <i>x</i> (アークサイン)</td></tr>

^<tr> <td>asinh(x)</td> <td>任意</td> <td>ラジアンでの sinh^-1 <i>x</i> (逆双曲正弦)</td></tr>

^<tr> <td>atan(x)</td> <td>任意</td> <td>tan^-1 <i>x</i> (アークタンジェント)</td></tr>

^<tr> <td>atan2(y,x)</td> <td>整数または実数</td> <td>tan^-1(<i>y/x</i>) (アークタンジェント)</td></tr>

^<tr> <td>atanh(x)</td> <td>任意</td> <td>ラジアンでの tanh^-1 <i>x</i> (逆双曲正接)</td></tr>

^<tr> <td>EllipticK(k)</td> <td>(-1:1) 内の実数 k</td> <td><i>K(k)</i> 第 1 種完全楕円積分</td></tr>

^<tr> <td>EllipticE(k)</td> <td>[-1:1] 内の実数 k</td> <td><i>E(k)</i> 第 2 種完全楕円積分</td></tr>

^<tr> <td>EllipticPi(n,k)</td> <td>実数 n&lt;1, (-1:1) 内の実数 k</td> <td> &Pi;(<i>n,k</i>) 第 3 種完全楕円積分</td></tr>

^<tr> <td>besj0(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>j</i>₀ ベッセル関数 (0 次ベッセル関数)</td></tr>

^<tr> <td>besj1(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>j</i>₁ ベッセル関数 (1 次ベッセル関数)</td></tr>

^<tr> <td>besy0(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>y</i>₀ ベッセル関数 (0 次ノイマン関数)</td></tr>

^<tr> <td>besy1(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>y</i>₁ ベッセル関数 (1 次ノイマン関数)</td></tr>

^<tr> <td>ceil(x)</td> <td>任意</td> <td>&lceil;<i>x</i>&rceil;, <i>x</i> (の実部) 以上の最小の整数</td></tr>

^<tr> <td>cos(x)</td> <td>radians</td> <td>cos <i>x</i>, <i>x</i> のコサイン</td></tr>

^<tr> <td>cosh(x)</td> <td>任意</td> <td>cosh <i>x</i>, ラジアンでの <i>x</i> のハイパボリックコサイン</td></tr>

^<tr> <td>erf(x)</td> <td>任意</td> <td>erf(Re(<i>x</i>)), <i>x</i> の実部の誤差関数</td></tr>

^<tr> <td>erfc(x)</td> <td>任意</td> <td>erfc(Re(<i>x</i>)), 1.0 - (<i>x</i> の実部の誤差関数)</td></tr>

^<tr> <td>exp(x)</td> <td>任意</td> <td><i>e^x</i>, <i>x</i> の指数関数</td></tr>

^<tr> <td>expint(n,x)</td> <td>任意</td> <td><i>E_n</i>(<i>x</i>), <i>x</i> の指数積分</td></tr>

^<tr> <td>floor(x)</td> <td>任意</td> <td>&lfloor;<i>x</i>&rfloor;, <i>x</i> (の実部) 以下の最大の整数</td></tr>

^<tr> <td>gamma(x)</td> <td>任意</td> <td>&Gamma;(Re(<i>x</i>)), <i>x</i> の実部のガンマ関数</td></tr>

^<tr> <td>ibeta(p,q,x)</td> <td>任意</td> <td>ibeta(Re(<i>p,q,x</i>)), <i>p</i>,<i>q</i>,<i>x</i> の実部の不完全ベータ関数</td></tr>

^<tr> <td>inverf(x)</td> <td>任意</td> <td><i>x</i> の実部の逆誤差関数</td></tr>

^<tr> <td>igamma(a,x)</td> <td>任意</td> <td>igamma(Re(<i>a,x</i>)), <a>a</a>,<i>x</i> の実部の不完全ガンマ関数</td></tr>

^<tr> <td>imag(x)</td> <td>複素数</td> <td>Im(<i>x</i>), <i>x</i> の虚数部分 (実数)</td></tr>

^<tr> <td>invnorm(x)</td> <td>任意</td> <td><i>x</i> の実部の逆正規分布関数</td></tr>

^<tr> <td>int(x)</td> <td>実数</td> <td><i>x</i> の整数部分 (0 に向かって丸め)</td></tr>

^<tr> <td>lambertw(x)</td> <td>実数</td> <td>Lambert W 関数</td></tr>

^<tr> <td>lgamma(x)</td> <td>任意</td> <td>lgamma(Re(<i>x</i>)), <i>x</i> の実部のガンマ対数関数</td></tr>

^<tr> <td>log(x)</td> <td>任意</td> <td>ln <i>x</i>, <i>x</i> の自然対数 (底 <i>e</i>)</td></tr>

^<tr> <td>log10(x)</td> <td>任意</td> <td>log₁₀ <i>x</i>, <i>x</i> の対数 (底 10)</td></tr>

^<tr> <td>norm(x)</td> <td>任意</td> <td>norm(<i>x</i>), <i>x</i> の実部の正規分布関数</td></tr>

^<tr> <td>rand(x)</td> <td>整数</td> <td>区間 [0:1] 内の疑似乱数</td></tr>

^<tr> <td>real(x)</td> <td>任意</td> <td>Re(<i>x</i>), <i>x</i> の実数部分</td></tr>

^<tr> <td>sgn(x)</td> <td>任意</td> <td><i>x</i> &gt; 0 なら 1, <i>x</i> &lt; 0 なら -1, <i>x</i> = 0 なら 0. <i>x</i> の虚部は無視</td></tr>

^<tr> <td>sin(x)</td> <td>任意</td> <td>sin <i>x</i>, <i>x</i> のサイン</td></tr>

^<tr> <td>sinh(x)</td> <td>任意</td> <td>sinh <i>x</i>,ラジアンでの <i>x</i> のハイパボリックサイン</td></tr>

^<tr> <td>sqrt(x)</td> <td>任意</td> <td>&radic;<i>x</i>, <i>x</i> の平方根</td></tr>

^<tr> <td>tan(x)</td> <td>任意</td> <td>tan <i>x</i>, <i>x</i> のタンジェント</td></tr>

^<tr> <td>tanh(x)</td> <td>任意</td> <td>tanh <i>x</i>, ラジアンでの <i>x</i> のハイパボリックタンジェント</td></tr>

^<tr> <td>voigt(x,y)</td> <td>実数</td> <td>ガウス関数とローレンツ関数の畳みこみ</td></tr>

^</tbody>

^</table>

^<p>&nbsp;</p>

^<table align="center" border="1" rules="groups" frame="hsides" cellpadding="3" width="90%">

^<colgroup>

^ <col align="center">

^ <col align="center">

^ <col align="left">

^</colgroup>

^<thead>

^<tr> <th colspan="3"> 文字列関数 </th></tr>

^<tr> <th>関数</th> <th>引数</th> <th>戻り値</th></tr>

^</thead>

^<tbody>

^<tr> <td>gprintf("format",x,...)</td> <td>任意</td> <td>gnuplot の書式解析器を適用した結果の文字列</td></tr>

^<tr> <td>sprintf("format",x,...)</td> <td>複数個</td> <td>C 言語の sprintf の返す文字列</td></tr>

^<tr> <td>strlen("string")</td> <td>文字列</td> <td>バイト単位での文字列の長さ (整数)</td></tr>

^<tr> <td>strstrt("string","key")</td> <td>文字列</td> <td>部分文字列 "key" が現れる先頭位置</td></tr>

^<tr> <td>substr("string",beg,end)</td> <td>複数個</td> <td>文字列 "string"[beg:end]</td></tr>

^<tr> <td>strftime("timeformat",t)</td> <td>任意</td> <td>gnuplot による時刻解析結果の文字列</td></tr>

^<tr> <td>strptime("timeformat",s)</td> <td>文字列</td> <td>文字列 s を変換した 2000 年からの秒数</td></tr>

^<tr> <td>system("command")</td> <td>文字列</td> <td>シェルコマンドの出力を持つ文字列</td></tr>

^<tr> <td>word("string",n)</td> <td>string, int</td> <td>文字列 "string" の n 番目の単語</td></tr>

^<tr> <td>words("string")</td> <td>文字列</td> <td>文字列 "string" 中の単語数</td></tr>

^</tbody>

^</table>

^<p>&nbsp;</p>

^<table align="center" border="1" rules="groups" frame="hsides" cellpadding="3" width="90%">

^<colgroup>

^ <col align="center">

^ <col align="center">

^ <col align="left">

^</colgroup>

^<thead>

^<tr> <th colspan="3"> 他の gnuplot の関数 </th></tr>

^<tr> <th>関数</th> <th>引数</th> <th>戻り値</th></tr>

^</thead>

^<tbody>

^<tr> <td>column(x)</td> <td>整数か文字列</td> <td> 入力データ中の <i>x</i> 列目の内容</td></tr>

^<tr> <td>columnhead(x)</td> <td>整数</td> <td> データファイルの最初の <i>x</i> 列目中の文字列</td></tr>

^<tr> <td>defined(X)</td> <td>変数名</td> <td> [非推奨] X が定義されていれば 1, そうでなければ 0</td></tr>

^<tr> <td>exists("X")</td> <td>文字列</td> <td> 変数名 X が定義されていれば 1, そうでなければ 0</td></tr>

^<tr> <td>stringcolumn(x)</td> <td>整数</td> <td> 文字列としての <i>x</i> 列目の内容</td></tr>

^<tr> <td>timecolumn(x)</td> <td>整数</td> <td> データファイル処理中の <i>x</i> 列目の日時データ</td></tr>

^<tr> <td>tm_hour(x)</td> <td>整数</td> <td>時</td></tr>

^<tr> <td>tm_mday(x)</td> <td>整数</td> <td>日</td></tr>

^<tr> <td>tm_min(x)</td> <td>整数</td> <td>分</td></tr>

^<tr> <td>tm_mon(x)</td> <td>整数</td> <td>月</td></tr>

^<tr> <td>tm_sec(x)</td> <td>整数</td> <td>秒</td></tr>

^<tr> <td>tm_wday(x)</td> <td>整数</td> <td>その週の何日目</td></tr>

^<tr> <td>tm_yday(x)</td> <td>整数</td> <td>その年の何日目</td></tr>

^<tr> <td>tm_year(x)</td> <td>整数</td> <td>西暦</td></tr>

^<tr> <td>time(x)</td> <td>任意</td> <td>現在のシステム時刻</td></tr>

^<tr> <td>valid(x)</td> <td>整数</td> <td> データ中の column(<i>x</i>) の正当性</td></tr>

^<tr> <td>value("name")</td> <td>文字列</td> <td> 名前 name の変数の現在の値</td></tr>

^</tbody>

^</table>

C TeX と troff 出力に関しては表は以下のヘルプセクションを置き換えます。

C HTML ヘルプに関しては表とセクションの両方が必要なので、以下のマジック

C マーカを doc2html へのこのシグナルとして使用します。

^<!-- INCLUDE_NEXT_TABLE -->

@start table

#\begin{longtable}{|ccl|} \hline

#\multicolumn{3}{|c|}{数学ライブラリ関数} \\ \hline \hline

#関数 & 引数 & 戻り値 \\ \hline

#\endhead \hline \endfoot

%c c l .

%関数@引数@戻り値

%_

4 abs

?expressions functions abs

?abs

#abs(x) & 任意 & $x$ の絶対値, $|x|$; 同じ型\\

#abs(x) & 複素数 & $x$ の長さ, $\sqrt{{\mbox{real}(x)^{2} +

#\mbox{imag}(x)^{2}}}$ \\

%abs(x)@任意@$x$ の絶対値, $|x|$; 同じ型

%abs(x)@複素数@$x$ の長さ, $sqrt{roman real (x) sup 2 + roman imag (x) sup 2}$

関数 `abs(x)` 引数の絶対値を返します。返り値の型は引数と同じです。

複素数の引数に対しては, abs(x) は複素平面における x の長さと定義されて

います [すなわち sqrt(real(x)**2 + imag(x)**2) ]。

4 acos

?expressions functions acos

?acos

#acos(x) & 任意 & $\cos^{-1} x$ (アークコサイン) \\

%acos(x)@任意@$cos sup -1 x$ (アークコサイン)

関数 `acos(x)` は引数のアークコサイン (逆余弦) を返します。`acos` の返

す値がラジアン単位かまたは度であるかは `set angles` で選択されます。

4 acosh

?expressions functions acosh

?acosh

#acosh(x) & 任意 & ラジアンでの $\cosh^{-1} x$ (逆双曲余弦)\\

%acosh(x)@任意@$ラジアンでの cosh sup -1 x$ (逆双曲余弦)

関数 `acosh(x)` は逆ハイパボリックコサイン (逆双曲余弦) の値をラジアン

で返します。

4 airy

?expressions functions airy

?airy

#airy(x) & 任意 & エアリー関数 Ai(x) \\

%airy(x)@任意@エアリー関数 Ai(x)

関数 `airy(x)` は、エアリー (Airy) 関数 Ai(x) の値を返します。関数

Ai(x) は、微分方程式 y'' - x y = 0 の、実数全体で有界な解です。引数が

複素数の場合、その虚数部分は無視されます。

4 arg

?expressions functions arg

?arg

#arg(x) & 複素数 & $x$ の偏角 \\

%arg(x)@複素数@$x$ の偏角

関数 `arg(x)` は複素数の偏角を、`set angles` の設定にしたがってラジア

ン、または度で返します。

4 asin

?expressions functions asin

?asin

#asin(x) & 任意 & $\sin^{-1} x$ (アークサイン) \\

%asin(x)@任意@$sin sup -1 x$ (アークサイン)

関数 `asin(x)` は引数のアークサイン (逆正弦) を返します。`asin` の返す

値は `set angles` の設定によってラジアン単位かまたは度になります。

4 asinh

?expressions functions asinh

?asinh

#asinh(x) & 任意 & ラジアンでの $\sinh^{-1} x$ (逆双曲正弦)\\

%asinh(x)@任意@$ラジアンでの sinh sup -1 x$ (逆双曲正弦)

関数 `asinh(x)` は逆ハイパボリックサイン (逆双曲正弦) の値をラジアンで

返します。

4 atan

?expressions functions atan

?atan

#atan(x) & 任意 & $\tan^{-1} x$ (アークタンジェント) \\

%atan(x)@任意@$tan sup -1 x$ (アークタンジェント)

関数 `atan(x)` は引数のアークタンジェント (逆正接) の値を返します。

`atan` の返す値は `set angles` の設定によってラジアン単位かまたは度に

なります。

4 atan2

?expressions functions atan2

?atan2

#atan2(y,x) & 整数または実数 & $\tan^{-1} (y/x)$ (アークタンジェント) \\

%atan2(y,x)@整数または実数@$tan sup -1 (y/x)$ (アークタンジェント)

関数 `atan2(y,x)` は引数の実数部分の比のアークタンジェント (逆正接) の

値を返します。`atan2` は `set angles` の設定によってラジアン単位か度に

なる、適切な四分円における値を返します。

4 atanh

?expressions functions atanh

?atanh

#atanh(x) & 任意 & ラジアンでの $\tanh^{-1} x$ (逆双曲正接)\\

%atanh(x)@任意@ラジアンでの $tanh sup -1 x$ (逆双曲正接)

関数 `atanh(x)` は逆ハイパボリックタンジェント (逆双曲正接) の値をラジ

アンで返します。

4 EllipticK

#EllipticK(k) & 実数 k $\in$ (-1:1) & $K(k)$ 第 1 種完全楕円積分\\