C corresponding original gnuplot.doc for 5.4.6 (2023-02)

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, 5.X)

1 gnuplot

?gnuplot

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

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

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

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

^<p align="center"> Version 5 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 - 2022 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 and 5.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, 5.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`)。例:

set title "My First Plot"; plot 'data'; print "all done!"

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

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

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

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

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

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

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

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

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

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

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

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

ワードや `help` における項目名は、逆引用符 (｀)、または可能な場合には

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

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

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

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

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

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

ます。

大量のグラフサンプルが、以下の Web ページにあります。

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

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

^ </a>

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

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 ホームページは以下にあります。

^ <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>

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

他に、(バグ以外の) 特定のグラフ描画の問題に関する助言は以下でも得られ

ます。

https://stackoverflow.com/questions/tagged/gnuplot

バグの報告と、機能のリクエストは、以下のトラッキングシステムにあげてく

ださい。

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

バグの報告や質問を投稿するときは、あなたが使用している gnuplot のバー

ジョン、出力形式 (terminal)、オペレーティングシステム、といった情報を

すべて入れてください。問題を再現する自己完結型の短いスクリプトを提示す

るとなお良いでしょう。

gnuplot メーリングリストへの投稿の方法に関しては、SouceForge にある

gnuplot の開発 Web サイト

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

http://sourceforge.net/projects/gnuplot

^ </a>

を参照してください。

gnuplot メーリングリストにメールを書く前に、最初にそのメーリングリスト

に参加する必要があることに注意してください。これは、スパムの量を減らす

ことを維持するために必要です。

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

[email protected]

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

[email protected]

2 新しい機能 (New features)

3 バージョン 5.4 で導入された機能

?new

以下のセクションでは、バージョン 5.4 で導入した新しいコマンド、新しい

描画スタイルやその他の機能を紹介します。

4 64 ビット整数演算のサポート

4 Support for 64-bit integer arithmetic

#start

#b 環境がサポートしていればすべての式と関数の評価で 64 ビット整数演算を

## 使用。

#b ユーザ切り替え可能な整数オーバーフローの検出と処理。

## 以下参照 `overflow`。

#end

4 ボクセル格子データ (Voxel grids)

?new voxels

gnuplot は、現在ボクセルデータ (空間ピクセルデータ) の 3 次元格子用の

操作をサポートします。

#start

#b `set vgrid $gridname size N` はボクセルの NxNxN 格子を構成します。

#b `set vxrange [vxmin:vxmax]` は、`set vyrange` と `set vzrange` と共

## にその格子が空間のどの領域を占有するかを定義します。これは、グラフの

## xyz の範囲とは同じでも、同じでなくても構いません。

#b `voxel(x,y,z)` を個々のボクセルを読む、書くための数式として使えます。

#b `vfill DATA_SOURCE using x:y:z:radius:(<expression>)` は、それがグラ

## フを描く代わりに入力データの各点の近くのボクセル値を増加させること以

## 外は plot コマンドと同様に作用します。

#b `vclear $gridname` は存在するボクセル格子をすべて 0 にリセットします。

#b 現在の一つ、またはそれ以上のボクセル格子は、using 指定で `voxel` 関

## 数を使うことで、`splot` コマンドで色やその他の属性を割り当てるために

## 参照することができます。

## デモ `voxel.dem` を参照してください。

#b ボクセル格子は、`splot` コマンドの描画スタイル `dots`, `points`, ま

## たは `isosurface` で、その名前を使って描画できます。

## デモ `vplot.dem` を参照してください。

#end

4 新しい描画スタイルやスタイルオプション

?new plot_styles

#start

#b 3 次元描画スタイル `with polygons` は、ファイルから多面体の面データ

## を読み込みます。これは、曲面を生成したり、中身のつまったオブジェクト

## を作るのに利用できます。以下参照: `with polygons`。

#b `splot $voxelgrid with {dots|points}` は、指定した閾値レベルより上の

## 値のすべてのボクセルに印をつけます。

#b `splot $voxelgrid with isosurface` は、指定した閾値レベルより上の値

## のすべてのボクセルを包むモザイク型の 3 次元曲面を生成します。以下

## 参照: `isosurface`。

#b ボクセル格子値は、3 次元描画時に `using` 指定で参照できます。

#b `set spiderplot` は、クモの巣グラフ (レーダーチャートとも) を生成す

## る新しい描画モードを選択します。これは本質的には、軸を縦に並べる代わ

## りに放射的に配置した平行座標軸 (parallel axis) 描画です。

## 以下参照: `spiderplot`, `set style spiderplot`, `set paxis`。

#b 描画スタイル `with circles` が 3D 描画でも可能に。

#b 描画スタイル `with boxes` が 3D 描画でも可能に。

#b 2 次元描画スタイル `with arrows`。各矢印を x:y:xdelta:ydelta でなく

## x:y:length:angle で指定する以外は `with vectors` と同じ。

#b splot FOO with pm3d fillcolor <colorspec>

#b pm3d 曲面が個別の fillstyle、別々の上下の fillcolor を持てるように。

#b pm3d のオプション `noclipcb` は、cbrange 外のパレットカラー値の四辺

## 形を、cbmin か cbmax にクリップした色で塗らず、描画しません。

#b 等高線線種のカスタマイズ。以下参照: `set cntrparam`。

#end

4 新しいデータ前処理フィルタ

?new filters

#start

#b `smooth zsort` は 3 列目の値で 2 次元の点をソートします。以下参照:

## `smooth zsort`。

#end

4 新しいコマンドやコマンドオプション

?new commands

#start

#b ボクセル格子データ用コマンド。以下参照: `set vgrid`, `set vxrange`,

## `vclear`, `vfill`, `voxel`。

#b 3D グラフで xy, xz, yz 平面を表示する新しいオプション。

## 以下参照: `set walls`, `set grid vertical`。

#b `set table separator {tab|comma|"char"}` による CSV ファイルの生成。

## 以下参照: `plot with table`。

#b 新しいオプション `set view projection {xy|xy|yz}` は、3 次元 splot

## の 2 次元射影用の視角、軸の目盛りとラベルの配置を調整する

## `set view projection xy` は `set view map` と同等。

#b `set rgbmax <value>` による入力 RGB 値の解釈の制御。

#b 配列初期値を指定すればサイズは暗黙化可能に。例: `Array A = [1,2,3]`。

#b 極座標モードでの線の同心円型のクリッピング。以下参照: `set clip`。

#b `plot`, `splot` コマンドのファイル名か関数を `keyentry` で置き換える

## ことで凡例のカスタマイズ用の余分な線を追加可能に。

## これは、対応するグラフは描かずに凡例中にそれ用の 1 行を作ります。

## 以下参照: `keyentry`。

#b マウス座標変換関数をユーザ指定可に (試験段階)

## map_projection デモを参照。

#b `set datafile columnheaders` は、入力の先頭行を、データ値ではなく文

## 字列として読ませます。これは、凡例行の生成には影響を与えないことを除

## けば `set key autotitle columnheader` と同等です。このオプションの有

## 効時には、コマンド `stats` は先頭行の文字列の配列を生成します。

#b 多様な textbox style を定義できます。以下参照: `set style textbox`。

#end

4 新しい出力形式や出力形式オプション

?new terminals

#start

#b `pcl5` 出力形式は PCL5e/PCL5c プリンタと最近の gnuplot のたくさんの

##機能をサポートするように拡張。

#b `pstricks` 出力形式は、RGB カラーや透明化、多角形や箱の塗り潰しなど、

## gnuplot の最新の多くの機能をサポートするように拡張されています。

#b 新しい出力形式 `pict2e` は、LaTeX2e の pict2e 環境で使用するものです。

## これは、もはやデフォルトではビルドされない古い出力形式 `latex`,

## `emtex`, `eepic`, `tpic` に直ちに取って代わるものです。

#b `texdraw` 出力形式は、任意の方向への文字列、可変な線幅、バージョン 5

## の破線、箱や多角形の塗り潰しをサポートするように拡張されました。これ

## は現在は plain TeX でも使用できます。

#b `windows` 出力形式の、従来の試験的な Direct2D 版は、GDI 版と GDI+ 版

## を置き換えます。これは、D2D を用いた印刷やカラーフォントなどをサポー

## トしています。

#b OS/2 用の `pm` 出力形式は今風に、例えば utf8, ボールドやイタリック文

## 字、破線出力などをサポートするようになりました (5.2.7 より)。

#b `dospc` と `svga` の DOS 用出力形式は更新され、現在は対話的にキーボ

## ードやマウス入力 (svga のみ) もサポートしています。

#end

4 オブジェクトとしてのピクスマップ画像

?new pixmaps

#start

#b `set pixmap` は、標準的な形式 (png, jpeg, gif) の画像をピクスマップ

## 画像として取り込み、グラフやページの任意の位置に配置することを可能に

## します。`with image` による描画とは違い、ピクスマップオブジェクトは

## 元々のアスペクト比やサイズを軸のスケールや回転とは独立に保持します。

## 以下参照: `pixmap`。

#end

4 週曜日のサポート (Week-date time support)

?new week-date time

2020-2021 年に起きた新型コロナウィルス (Covid-19) の騒動では、疫学的デ

ータのグラフ化の関心が高まりましたが、そこでは報告の慣習として、よく

「週曜日」を使った表が示されていました。そしてこれにより、この慣習に対

する gnuplot のサポートの不足が明らかになり、日時書式の %W と %U のエ

ラーもわかりました。これらの書式は、5.4.2 より前のバージョンでは正しく

機能しません。

#start

#b 日時書式 %W は、ISO 8601 の週曜日規則に従うようになりました。

#b 日時書式 %U は、CDC/MMWR の週曜日規則に従うようになりました。

#b 新しい関数 `tm_week(time, std)` は、ISO か CDC 規則でのその年の週番

## 号を返します。

#b 新しい関数 `weekdate_iso(year, week, day)` は、ISO 規則での週曜日を

## カレンダー時刻に変換します。

#b 新しい関数 `weekdate_cdc(year, week, day)` は、CDC 規則での週曜日を

## カレンダー時刻に変換します。

#end

4 その他の新しい機能

4 Other new features

#start

#b 拡張文字列モードで \U+xxxx (xxxx は 16 進値の 4 または 5 文字) で

## Unicode コードポイントが指定できるように。それは出力時に対応する

## UTF-8 バイト文字列に変換します。

#b `using` 指定内での文字列 $# は、現在の入力データ行にある全列数と評価

## します。例えば、"plot FOO using 0:(column($# - 1))" は、各行の最後か

## ら一つ手前の列を描画します。

#b 日時データ入力時に AM/PM の処理をする %p 書式を認識

#b plot の title は、plot 実行前ではなく、実行後に評価します。これによ

## り、plot 時に計算する量を参照するタイトルを作れるようになります。

#b 組み込み変形ベッセル関数 (besi0, besi1, besin)

#b 組み込み第 1 種、2 種 N 次ベッセル関数 (besjn, besyn)

#b (5.4.2) "using" 指定内で $# は現在のデータ行の全列数を意味します。

#b (5.4.2) filledcurves 同様の "plot with fillsteps {above|below y=<value>}"

#b (5.4.3) splot の要素を dgrid3d 処理から外すフラグ "nogrid"

#b (5.4.3) "set style histogram nokeyseparators" (以下参照: `newhistogram`)

#b (5.4.5) 非一様な matrix データに対して column(0) は線形順序 (1 列の

## 通し番号) を返します。よって MxN 行列の A[i,j] 要素に対して、

## column(0) / M は行番号 i になり

## column(0) % M は列番号 j になります。

#b (5.4.5) "plot with histograms" の構成要素の箱は、種類/色の情報を示す

## 別の列の値によって色付けすることができます。以下参照:

## `lc variable`。

#b (5.4.5) 文字列から整数への変換機構が、0 につながる数字を 8 進数を意

## 味すると誤って解釈するというバージョン 5.4.4 の仕組みを後退

## させることで修正

#b (5.4.5) 凡例 (key) の箱の位置は、gnuplot が他に行う仕組みによるどん

## な位置決めに対しても、オフセットを与えることで手動で調整でき

## ます。

#b (5.4.6) 凡例の列数、幅を正確に決める `set key` の新しいオプション。

#end

4 変更点 (Changes)

?new changes

#start

#b `pm3d filled area quadrangles` は、現在の zrange に従って滑らかにク

## リッピングします。これは、pm3d 曲面、そして 3 次元の boxes, polygons

## 等にも影響を与えます。

#b `set pm3d border retrace` は、隣接する pm3d 四辺形同士を同じ色境界で

## 塗ることで、内在するアンチエイリアスの副産物を解消します。

#b 描画スタイル `with parallelaxes` の書式の改良。以下参照: `parallel`。

## histogram, parallelaxis, spiderplot スタイルでは、描画要素を繰返し出

## 力する書式を使用できます:

## `plot for [column=1:N] DATA using column`

#b `set trange` が疑似ファイル '+' が生成する標本点に影響するように。

#b `set offsets` は自動縮尺軸にのみ適用するように。マニュアルにはそう書

## いていましたが、実際にはそうなっていませんでした。

#b 2 次元描画での using 指定によって得られる複素数値 value は、その実数

## 部分 real(value) を評価するのではなく、未定義値 (NaN) として処理しま

## す。これは、関数の plot と 3 次元描画では常にそうなっていました。例え

## ば、以下の 2 つの plot は同じになります。

## plot [-1:1] sqrt(x); plot [-1:1] '+' using 1:(sqrt($1)

#b コマンド `set fontpath` は非推奨です。postscript 出力形式からの出力

## の中に埋め込まれるフォントの検索パスは改良されています。

#end

3 バージョン 5.2 で導入された機能 (Features introduced in version 5.2)

4 新しい描画スタイルやスタイルオプション

#start

#b 3 次元描画スタイル `with zerrorfill`。以下参照: `zerrorfill`,

## `fenceplots`。および

^ <a href="http://gnuplot.info/demo_5.4/zerror.html">

zerror デモ。

^ </a>

#b ビースウォームグラフ。以下参照: `set jitter`, `beeswarm`。および

^ <a href="http://gnuplot.info/demo_5.4/jitter.html">

ビースウォームグラフデモ。

^ </a>

#b グラフの点 (points) で使われる個々の記号は、データ値で制御できます。

## (以下参照: `pointtype variable`)

#end

4 データ用の新しい前処理フィルタ (New data pre-processing filters)

#start

#b データ集合内での出現回数の正規化 (以下参照: `smooth fnormal`)

#b データの階級幅割り当ての自動化 (以下参照: `bins`)

#end

4 極座標モードの改良と拡張 (Polar mode improvements and extensions)

#start

#b ラベル、矢 (arrow)、オブジェクトの定義に極座標が使えます。

#b `set [m]ttics` は極座標モードでの外周方位軸のラベルと刻みを配置しま

## す。参考:

^ <a href="http://gnuplot.info/demo_5.4/ttics.html">

極座標軸と刻みラベルデモ

^ </a>

#b `set rlabel` は動径軸 (r 軸) の上にラベルを配置します。

#b 逆向きの `rrange` (例: set rrange [90:0]) で天球地平座標 (celestial

## horizontal coordinates) が使えるようになります。参考:

## い:

^ <a href="http://gnuplot.info/demo_5.4/solar_path.html">

天体軌道デモ

^ </a>

#b `set border polar` は極座標の外周の回りに実線を描きます。

#b `set theta` は極座標グラフの外周方位軸での theta = 0 の位置と、角の

## 増加方向 (時計回りか反時計回りか) を制御します。

#end

4 非線形座標系 (Nonlinear coordinates systems)

#start

#b グラフの任意の軸に、線形の範囲への写像とその逆写像を意味する関数の組

## を割り当てることができ、それを非線形にすることも可能です (以下参照:

## `set nonlinear`)。

^ <a href="http://gnuplot.info/demo_5.4/nonlinear3.html">

非線形 x,y 軸デモ

^ </a>

#b なじみ深いコマンド `set logscale` は、現在は関数の組 log(x), exp(x)

## による非線形軸の例の一つとして再実装されました。

#end

4 新しいコマンドやコマンドオプション

#start

#b 繰り返し実行部分の中カッコ内では、`continue` は次の繰り返しにすぐに

## 移動し、`break` は繰り返しを中断します。

#b `toggle {<plotno> | "plottitle" | all}"` は、対話的に現在のグラフの

## 構成要素を表示させるか消すかを選択できます。

#b `save fit` は非推奨のコマンド `update` を置き換え

#b `set table "outfile.name" append` で、その後の table 出力を、既に存

## 在するテキストファイルを上書きせず、追加出力にします。

#b `set pm3d lighting` で、反射光ハイライトによる点光源モデルを使用しま

## す (以下参照: `lighting`)。

#b `set minussign` は、負の数でのアスキー文字 '-' を、現在のエンコード

## での特殊文字に置き換えるよう gnuplot に指示します。

#b `set micro` は、科学用接頭辞の「マイクロ」用のアスキー文字 'u' を、

## 現在のエンコードでの特殊文字に置き換えるよう gnuplot に指示します。

## micro, minussign の特殊印刷記号は、軸刻みラベルと、明示的に gprintf()

## で生成した文字列にのみ使用します。それらの文字表現のバイト列は、現在

## のエンコード設定に依存します。

#end

4 新しい配列データ型 "array" (New data type "array")

#start

#b このバージョンの gnuplot には、新しい配列データ型 `array name[size]`

## が導入されています。配列は、使用する前に宣言しなければいけません。各

## 配列要素 A[i] は、文字列、整数、実数、複素数のいずれでも構いません。

## 一つの配列が異なる型の要素を持つことも可能です。基数演算子 |A| は配

## 列のサイズを返します。以下参照: `arrays`。

#end

4 新しい出力形式や出力形式オプション

#start

#b 新しい `sixelgd` 出力形式は、vt340 と互換の端末エミュレータ上で

## gnuplot を実行した場合に、グラフを出力する命令のコマンドラインの合間

## にグラフを挟むような出力をサポートします。以下参照: `sixelgd`。

#b `domterm` 出力形式は、svg を解釈する端末エミュレータ上で gnuplot を

## 実行した場合に、グラフを出力する命令のコマンドラインの合間にグラフを

## 挟むような出力をサポートします。

#b `windows` 出力形式は、現在のグラフのビットマップファイルへの保存をサ

## ポートします。

#b `windows` 出力形式は、グラフウィンドウと wgnuplot テキストウィウンド

## ウをドッキングできます。

#b `windows` 出力形式用 (試験的) Direct2D/DirectWrite 新バックエンド。

#b `wxt` 出力形式は、Windows 上では EMF ファイルへの出力とプリンタ出力

## をサポート。

#b `dumb` 出力形式は、線と領域の塗り潰しで ANSI カラーをサポート。

#b `tkcanvas` 出力形式は、新しい言語と、最近の gnuplot の多くの機能をサ

## ポートするように書き直されています (5.0.3 より)。

#end

4 その他の新しい機能 (Other new features)

#start

#b 3 次元グラフの向きに影響する追加回転角 `azimuth`。これは、コマンドラ

## インから (以下参照: `set view azimuth`)、または右マウスボタンのドラ

## ッグで設定できます。ホットキー `z` は azimuth を 0 にリセットします。

#b Windows 上の gnuplot では、Unicode (BMP) スクリプトの入力を、

## `set encoding` による現在のエンコード (UTF-8 を含む) に変換して解釈

## します。

#b 文字枠に境界色と背景色を指定できます (以下参照: `set style textbox`)

#b グラフの表題のカスタマイズ (以下参照: `plot title`, `set key`,

## `multiple keys`)

#b 疑似ファイル '+' でのグラフのサンプリング範囲指定にサンプリング区間

## を指定できます。例:

## plot sample [t=0:100:10] '+' using (t):(1):(label[t]) with labels

#b 疑似ファイル '++' は、x, y 軸でなく u, v 軸に沿ったサンプリングを行

## います。これは、3 次元グラフ中に、別々のデカルト座標領域を占めるよう

## な複数の媒介変数曲面を置くのに便利でしょう。

#b 相対時間 (間隔長) を処理する新しい書式指定子 tH tM tS。

##以下参照: `time_specifiers`。

#b ^R で、組み込み readline (Windows でも使われている) の履歴の逆向き検

## 索を開始します。以下参照: `command-line-editing`。

#b Windows での `set output "PRN"` による印刷の改良。以下参照:

## `windows printing`。

#end

3 バージョン 5.0 で導入された機能 (Features introduced in version 5.0)

#start

#b 線の点線/破線パターンは、現在は線の他の属性と独立に指定できます。以

## 下参照: `dashtype`, `set dashtype`, `set linetype`。

#b 一つの plot での連続した要素に使用されるデフォルトの色の巡回列は、色

## 弱者により容易に区別できるものになりました。その色の巡回列は、ユーザ

## が制御できます (以下参照: `set colorsequence`)。この仕組みは、白黒の

## グラフを生成することでも行えます (以下参照: `set monochrome`)。なお、

## 従来の gnuplot のバージョンでは `monochrome` は、現在の出力形式を

## `set temrinal` で変更するときにのみにしか選択できませんでした。

#b 新しい描画スタイル `with parallelaxes`、`with table`、および等高線の

## ラベル付け。

#b 単調 3 次スプラインによるデータの新しい前処理フィルタ (以下参照:

## `smooth mcsplines`)

#b 文字の書式制御は、下付き、上付き、フォントサイズ、その他以前有効だっ

## たものに加え、今は太字体 (bold) と斜体 (italic) フォント設定もサポー

## トしています。このモード (拡張文字処理) は、現在はデフォルトで有効と

## なっています。以下参照: `enhanced text`。文字列要素は枠で囲むことも

## できます (以下参照: `set style textbox`)。

#b 対話型出力形式は、ハイパーテキストラベルをサポートしていますが、これ

## はマウスがそのラベルのリンク点上にあるときにのみ現れるものです。

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

#b 軸の見出しのデフォルト書式用の "% h" (LaTeX 系出力形式では "$%h$")。

## この書式は C の標準書式の %g に似ていますが、指数部分がある場合は、

## それが上付き文字として書かれることが違います。例えば、1.2E05 でなく

## 1.2 x 10^5 となります。

#b スクリプト内で、インラインデータを名前付きのデータブロックとして保存

## し繰り返し描画できるように。以下参照: `inline data`。

#b 32-bit のアルファ値 + RGB 色表記 (#AARRGGBB) をサポート。以下参照:

## `colorspec`。

#b hsv2rgb(H,S,V) という変換関数による HSV 色空間のサポート。

#b 第 2 軸 (x2, y2) は、対応関数により、第 1 軸に固定できます。最も単純

## なのは、これにより第 1 軸と 2 軸の軸の範囲を一致させることです。より

## 一般に、これにより非線形な軸を定義できるようになりますが、これまでは

## そのようなことは対数軸しかできませんでした。以下参照: `set link`。

#b plot コマンドの各関数にオプションとして描画範囲を前置指定できます。

## これは、plot 全体の範囲には影響せず、その関数のデータをサンプリング

## する範囲でしかありません。以下参照: `plot`, `piecewise.dem`。

#b 外部ライブラリ libcerf が利用可能であれば、それは複素数学関数 cerf,

## cdawson, erfi, faddeeva, および Voigt プロファイル VP(x,sigma,gamma)

## を提供するのに使われます。

#b コマンド `import` は、外部共有オブジェクト (サポートはオペレーティン

## グシステム依存) が提供する関数にユーザ定義関数名を割り当てます。適当

## な外部共有オブジェクトを作るためのテンプレートヘッダファイル、サンプ

## ルソース、makefile などが demo の中にあります。

#b 対話作業の履歴一覧内の直前のコマンドは、番号で再実行できます。例えば

## `history !5` は、`history` の一覧内の 5 番のコマンドを再実行します。

#b ビットシフト演算子 >> と <<。

#b gnuplot のシェル呼び出しで gnuplot スクリプトにパラメータを渡せます。

## gnuplot -c scriptfile.gp ARG1 ARG2 ARG3 ...

#end

2 バージョン 4 と 5 との違い (Differences between versions 4 and 5)

?changes

?differences

バージョン 5 で導入されたいくつかの変更は、前の版の gnuplot 用のスクリ

プトの挙動を変える可能性があります。

* NaN や、正しくないデータ列数、または他の予期しないものを含む入力デー

タの処理の改良。例 (や図) については、以下参照: `missing`。

* 時間座標は、標準的な Unix エポック (1970 年 1 月 1 日) からの秒数と

して内部で保存します。以前の版の gnuplot では、別のエポック (2000 年

1 月 1 日) を内部で使用していました。この変更は、gnuplot の外で作られ

た秒単位のデータによって矛盾がもたらされる問題を解決します。インストー

ルされている個々の gnuplot がどちらのエポックを使用しているかについて

は、コマンド `print strftime("%F",0)` で知ることができます。現在は、時

間は少なくともミリ秒の精度で保存されます。

* 関数 `timecolumn(N,"timeformat")` は、現在は 2 つの引数を持ちます。

新しい 2 つ目の引数はどのデータ軸とも関連しておらず、よってこれにより

関数 `timecolumn` を、x や y 軸に指定するのとは違う形式の日時データの

読み込みに使えるようになります。この機能は、次のコマンド列に取って変わ

ります: `set xdata time; set timefmt "timeformat"`。これは、複数のファ

イルから異なる書式の日時データを読んで、それらを組み合わせて 1 つのグ

ラフにすることを可能にします。

* コマンド `set [axis]range` のキーワード `reverse` は、自動縮尺

(autoscaling) にのみ影響し、`set xrange [0:1]` のようなコマンドの意味

を逆にしたり他の変更を行ったりはしません。このような場合に x 軸の方向

を逆向きにしたければ、代わりに `set xrange [1:0]` としてください。

* コマンド `call` は、変数群 ARGC, ARG0, ..., ARG9 を提供します。ARG0

は、実行するスクリプト名を指します。ARG1 から ARG9 は文字列変数になる

ので、直接参照するか、または例えば @ARG1 のようにマクロ展開させたもの

を参照することができます。ARG0 ... ARG9 の内容は、他にも配列変数 ARGV

の要素 ARGV[0] ... ARGV[ARGC] としても取得できます。古い gnuplot での

call のパラメータ参照形式 $0 ... $9 は現在は非推奨です。

* オプション smooth の kdensity の、bandwidth の追加指定では、データ列

からでなく 1 つのキーワードとして値を取ります。以下参照:

`smooth kdensity`。

2 非推奨な書式 (Deprecated syntax)

?deprecated syntax

?backwards compatibility

?compatibility

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

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

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

gnuplot 4 では非推奨で、バージョン 5 では削除:

set title "Old" 0,-1

set data linespoints

plot 'file' thru f(x)

plot 1 2 4 # y=1 での水平線

update

現在の同等の機能:

TITLE = "New"

set title TITLE offset char 0, char -1

set style data linespoints

plot 'file' using 1:(f(column(2)))

plot 1 linetype 2 pointtype 4

バージョン 5.0 では非推奨:

if (defined(VARNAME)) ...

set style increment user

call 'script' 1.23 ABC

(in script: print $0, "$1", "number of args = $#")

set fontpath

set clabel

fit control variables FIT_*

現在の同等の機能:

if (exists("VARNAME")) ...

set linetype

call 'script' 1.23 "ABC"

(in script: print ARG1, ARG2, "number of args = ", ARGC

set cntrlabel

set fit <option> <value>

バージョン 5.4 では非推奨:

# 繰り返しを行うために `reread` を含むファイルを使用

N = 0; load "file-containing-reread";

file content:

N = N+1

plot func(N,x)

pause -1

if (N<5) reread

現在の同等の機能:

do for [N=1:5] {

plot func(N, x)

pause -1

}

2 デモ、ネット上のサンプル (Demos and Online Examples)

?demos

?online examples

?examples

`gnuplot` の配布物の `demo` ディレクトリ内には、多くのサンプルが収めら

れています。これらのサンプルの png, svg, canvas 出力形式による出力を、

以下のネット上で見ることもできます:

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

http://gnuplot.info/demos

^ </a>

そこでは、各デモを作成するコマンドがグラフの隣りに表示されますし、その

gnuplot スクリプトをダウンロードすることもできますので、それを保存し同

様のグラフを作成することができます。

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

?batch/interactive

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

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

コマンドライン引数は、プログラムへのオプション (以下参照:

`command-line-options`) か、`gnuplot` コマンドを含むファイルの名前であ

ると解釈されます。各ファイルとコマンド文字列は、指定した順に実行されま

す。特別なファイル名 "-" は、コマンドを標準入力から読み込むことを意味

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

せるファイル、およびコマンド文字列を指定しなかった場合は、`gnuplot` は

標準入力からの対話型の入力を受け付けます。

3 コマンドラインオプション (command line options)

?command-line-options

?batch/interactive command-line-options

gnuplot は、コマンドラインで以下のオプションを受けつけます:

-V, --version

-h, --help

-p, --persist

-d, --default-settings

-s, --slow

-e "command1; command2; ..."

-c scriptfile ARG1 ARG2 ...

-p は、プログラムの終了時に、残っている対話型グラフウィンドウを一切閉

じないよう gnuplot に指示します。

-d は、各ユーザ用、およびシステム用の初期化 (以下参照: `initialization`)

を一切行わないよう gnuplot に指示します。

-s は、起動時のフォントの初期化をゆっくり待つように指示します。そうで

ないと、エラーを表示し、不正なフォントサイズ情報で動作を継続します。

-e "command" は、次に進む前に指定した単一のコマンドを実行するよう

gnuplot に指示します。

-c は、-e "call scriptfile ARG1 ARG2 ..." と同等です。以下参照: `call`。

3 例 (Examples)

?batch/interactive examples

対話を開始する:

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

ここの文書で使用する "canvas" という用語は、グラフやそれに関連するラベ

ルやタイトル、凡例などを配置するのに利用可能な描画領域全体を意味します。

注意: HTML5 canvas 出力形式に関する情報を知りたい場合は、以下参照:

`set term canvas`。

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

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

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

`set size` を使用することはバージョン 4 で非推奨となり、現在はほとんど

の出力形式が以下のルールに従います:

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

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

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

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

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

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

全体に合うように描画されます。1 より大きい伸縮値を指定すると、問題が起

こるかもしれないことに注意してください。

例:

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 壊れた表示の行を再表示

^U 行全体の削除

^W 直前の単語を削除

^V この次のキーを編集コマンドと見なさない

TAB ファイル名補完動作

`履歴`:

^P 前の履歴へ移動

^N 次の履歴へ移動

^R 後方検索を開始

#\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~ & 壊れた表示の行を再表示\\

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

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

#\verb~^V~ & この次のキーを編集コマンドと見なさない\\

#\verb~TAB~ & ファイル名補完動作\\ \hline

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

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

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

#\verb~^R~ & 後方検索を開始\\

%c l .

%文字@機能

%_

%@行編集

%^B@1 文字前へ戻す

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

%^A@行の先頭に移動

%^E@行の最後に移動

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

%DEL@現在の文字を削除

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

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

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

%^U@行全体の削除

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

%_

%^V@この次のキーを編集コマンドと見なさない

%TAB@ファイル名補完動作

%_

%@履歴

%^P@前の履歴へ移動

%^N@次の履歴へ移動

%^R@後方検索を開始

@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</tt></td> <td>壊れた表示の行を再表示</td></tr>

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

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

^<tr> <td><tt>^V</tt></td> <td>この次のキーを編集コマンドと見なさない</td></tr>

^<tr> <td><tt>TAB</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>

^<tr> <td><tt>^R</tt></td> <td>後方検索を開始</td></tr>

^</tbody>

^</table>

2 コメント (Comments)

?comments

コメント記号 `#` は、コマンド行中のほとんどどこにでも書くことができま

す。このとき `gnuplot` は、その行の残りの部分を無視します。ただし、記

号 `#` は引用符内ではこの効果がありません。コメント行が '\' で終わって

いる場合、次の行もコメントの一部として扱われることに注意してください。

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

`set datafile commentschars`。

2 座標系 (Coordinates)

?coordinates

=axes

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

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

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

各座標系指定 <system> には、`first`, `second`, `polar`, `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` 座標は主にずれを指定

するのに使用し、絶対的な位置を示すものではありません。`character` の水

平、垂直サイズは、現在使用しているフォントに依存します。

`polar` は、最初の 2 つの値を、x, y ではなく、角 theta と半径 r である

と解釈します。これは、例えば 2 次元の極座標、あるいは 3 次元円柱座標で

のグラフにラベルを配置するのに役に立つでしょう。

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` は整数表記も

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

す。

2 文字列データ (Datastrings)

?datastrings

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

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

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