-
Notifications
You must be signed in to change notification settings - Fork 5
Expand file tree
/
Copy pathgnuplot-ja.doc
More file actions
14239 lines (12345 loc) · 568 KB
/
gnuplot-ja.doc
File metadata and controls
14239 lines (12345 loc) · 568 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
C RCS $Id: gnuplot-ja.doc,v 1.54 2014/07/05 00:05:58 sfeam Exp $
C corresponding original gnuplot.doc revision: 1.896
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 下の 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.0 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éter Juhász,<br>
^ Thomas Koenig, David Kotz,<br>
^ Ed Kubaitis, Russell Lang,<br>
^ Timothée Lecomte, Alexander Lehmann,<br>
^ Alexander Mai, Bastian Märkisch,<br>
^ Ethan A Merritt, Petr Mikulí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 - 2014 various authors</p>
^<p align="center"> Mailing list for comments: <tt>gnuplot-info@lists.sourceforge.net</tt><br>
^ Mailing list for bug reports: <tt>gnuplot-bugs@lists.sourceforge.net</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 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>
を参照してください。
メーリングリストメンバーへのメールアドレス:
gnuplot-info@lists.sourceforge.net
バグリポート、ソースの改良等は以下の trackers に upload してください:
http://sourceforge.net/projects/gnuplot/support
ただし、リポートを送る前に、あなたがリポートしようとしているバグが、よ
り新しい版で既に修正されていないかチェックしてください。
開発版に関するメーリングリスト:
gnuplot-beta@lists.sourceforge.net
何か質問を投稿するときは、あなたが使用している gnuplot のバージョン、
出力形式、オペレーティングシステム、といった全ての情報を含むようにして
ください。その問題を引き起こす「小さい」スクリプトがあればなお良いです。
その場合、データファイルのプロットよりも関数のプロットの方がより良いで
す。
2 バージョン 5 での新しい機能 (New features in version 5)
?new-features
* 線の点線/破線パターンは、現在は線の他の属性と独立に指定できます。以
下参照: `dashtype`, `set dashtype`, `set linetype`。
* 文字の書式制御は、下付き、上付き、フォントサイズ、その他以前有効だっ
たものに加え、今は太字体 (bold) と斜体 (italic) フォント設定もサポート
しています。このモード (拡張文字処理) は、現在はデフォルトで有効となっ
ています。以下参照: `enhanced text`。
* 対話型出力形式は、ハイパーテキストラベルをサポートしていますが、これ
はマウスがそのラベルのリンク点上にあるときにのみ現れるものです。
* 新しい座標系 (度、分、秒)。以下参照: `set xdata geographic`。
* 軸の見出しのデフォルト書式用の "% h" (LaTeX 系出力形式では "$%h$")。
この書式は C の標準書式の %g に似ていますが、指数部分がある場合には、
それが上付き文字として書かれることが違います。例えば、1.2E05 でなく、
1.2 x 10^5 となります。
* スクリプト内で、インラインデータを名前付きのデータブロックとして保存
し繰り返し描画できるように。以下参照: `inline data`。
* 32-bit のアルファ値 + RGB 色表記 (#AARRGGBB) をサポート。以下参照:
`colorspec`。
* hsv2rgb(H,S,V) という変換関数により HSV 色空間をサポート。
* 第 2 軸 (x2, y2) は、対応関数により、第 1 軸に固定できます。最も単純
なのは、これにより第 1 軸と 2 軸の軸の範囲を一致させることです。より一
般に、これにより非線形な軸を定義できるようになりますが、これまではその
ようなことは対数軸しかできませんでした。以下参照: `set link`。
* plot コマンドの各関数にオプションとして描画範囲を前置指定できます。
これは、plot 全体の範囲には影響せず、その関数のデータをサンプリングす
る範囲でしかありません。以下参照: `plot`, `piecewise.dem`。
* 外部ライブラリ libcerf が利用可能であれば、それは複素数学関数 cerf,
cdawson, erfi, faddeeva, および Voigt プロファイル VP(x,sigma,gamma)
を提供するのに使われます。
* コマンド `import` は、外部共有オブジェクト (サポートはオペレーティン
グシステム依存) が提供する関数にユーザ定義関数名を割り当てます。適当な
外部共有オブジェクトを作るためのテンプレートヘッダファイル、サンプルソ
ース、makefile などが demo の中にあります。
* 対話作業の履歴一覧内の直前のコマンドは、番号で再実行できます。例えば
`history !5` は、`history` の一覧内の 5 番のコマンドを再実行します。
* ビットシフト演算子 >> と <<。
* 新しい描画スタイル `with parallelaxes`、`with table`、および等高線の
ラベル付け。
* gnuplot のシェル呼び出しで gnuplot スクリプトにパラメータを渡せます。
gnuplot -c scriptfile.gp ARG1 ARG2 ARG3 ...
3 新しいコマンド (New commands)
#start
# import f(x) from "plugin.so" # 共有ライブラリから関数を読み込み
# set history {quiet|numers} {full|trim} # history コマンド出力の制御
# history !N # 以前のコマンドを番号で再実行
# plot <datafile> skip N # テキストデータ先頭数行をスキップ
# plot ... smooth mcsplines # データに沿う単調 3 次スプライン
# reset session # 現在の作業の初期状態を復帰
# set arrow <tag> from <start> length <len> angle <ang>
# set colorsequence default|classic|podo # 以後の描画要素で使用する色
# set dashtype <tag> <dash-spec> # ユーザ定義破線パターン
# set link x2 via f(x) inverse g(x) # 非線形軸スケールを可能に
# set fit quiet|results|brief|verbose # fit 出力量の制御
# set multiplot next|previous # 自動配置内の順序の変更
# set contours; splot ... with labels # 数値での等高線のラベル
# set style textbox # 文字列要素に外枠をつける
# set view map {scale} # 3D 射影描画のリサイズが可能に
# set multiplot {next|previous} # 自動レイアウト格子内での移動
#end
2 バージョン 5 での変更 (Changes in version 5)
?changes
バージョン 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 [axis]range` のキーワード `reverse` は、自動縮尺
(autoscaling) にのみ影響し、`set xrange [0:1]` のようなコマンドの意味
を逆にしたり他の変更を行ったりはしません。このような場合に x 軸の方向
を逆向きにしたければ、代わりに `set xrange [1:0]` としてください。
* コマンド `call` は、変数群 ARGC, ARG0, ..., ARG9 を提供するよう実装
されています。ARG0 は、実行するスクリプト名を指します。ARG1 から ARG9
は文字列変数になるので、直接参照するか、または例えば @ARG1 のようにマ
クロ展開させたものを参照することができます。call の古いパラメータ参照
形式 $0 ... $9 は現在は非推奨です。
* オプション smooth の kdensity の、bandwidth の追加指定では、データ列
からでなく 1 つのキーワードとして値を取ります。以下参照:
`smooth kdensity`。
* `unset xrange` (および他の軸の範囲も) は、元のデフォルトの範囲を復帰
します。
* `unset terminal` は、gnuplot 開始時の出力形式を復帰します。
2 非推奨な書式 (Deprecated syntax)
?deprecated syntax
?backwards compatibility
?compatibility
以前の版で使われていたいくつかの書式は gnuplot 4 で非推奨となりました
が、後方互換性を持たせるためのコンパイル時のオプションが用意されていま
す。古い書式のサポートは現在は削除されています。
gnuplot 4 では非推奨で、バージョン 5 では削除:
set title "Old" 0,-1
set data linespoints
plot 1 2 4 # y=1 での水平線
現在の同等の機能:
TITLE = "New"
set title TITLE offset char 0, char -1
set style data linespoints
plot 1 linetype 2 pointtype 4
バージョン 5 では --enable-backwards-compatibility で構築された場合を
除き非推奨 (だがまだ使える):
if (defined(VARNAME)) ...
set style increment user
plot 'file' thru f(x)
call 'script' 1.23 ABC
(in script: print $0, "$1", "number of args = $#")
現在の同等の機能:
if (exists("VARNAME")) ...
set linetype
plot 'file' using 1:(f(column(2)))
call 'script' 1.23 "ABC"
(in script: print ARG1, ARG2, "number of args = ", ARGC
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` を使用することはバージョン 4.2 で非推奨となり、現在はほとん
どの出力形式が以下のルールに従います:
`set term <terminal_type> size <XX>, <YY>` は、出力ファイルのサイズ、
または "キャンバス" のサイズを制御します。デフォルトでは、グラフはその
キャンバス全体に描画されます。
`set size <XX>, <YY>` は、描画自体をキャンバスのサイズに対して相対的に
伸縮させます。1 より小さい伸縮値を指定すると、グラフはキャンバス全体を
埋めず、1 より大きい伸縮値を指定すると、グラフの一部分のみがキャンバス
全体に合うように描画されます。1 より大きい伸縮値を指定すると、ある出力
形式では問題が起こるかもしれないことに注意してください。
このルールに沿わない主な例外は PostScript ドライバで、デフォルトでは以
前の版のと同じ振舞いをしますが、将来は 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` は整数表記も
認めていて、その場合その整数は 1970 年 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)
以下参照: `labels`, `using xticlabels`, `plot title`, `using`。
2 拡張文字列処理モード (Enhanced text mode)
?enhanced text
?enhanced
?text_markup
?markup
多くの出力形式が、拡張文字列処理モード (enhanced text mode) をサポート
しています。これは、文字列に追加の書式情報を埋めこみます。例えば "x^2"
は x の自乗を、通常我々が見る上付きの 2 がついた形で書き出します。この
モードは、出力形式の設定時にデフォルトとして選択されますが、その後で
"set termoption [no]enhanced" を使ってその機能を有効/無効にもできます
し、"set label 'x_2' noenhanced" のように個々の文字列に適用することも
できます。
@start table - まずは対話型テキスト形式
制御記号 例 説明
^ a^x 上付き文字
_ a_x 下付き文字
@ @x, a@^b_{cd} 空ボックス (幅がない)
& &{space} 指定した長さのスペースを挿入
~ ~a{.8-} 'a' の上に '-' を、現在のフォントサ
イズの .8 倍持ち上げた位置に重ね書き
{/Times abc} Times フォント、今のサイズで abc を出力
{/Times*2 abc} Times フォント、今の倍のサイズで abc
{/Times:Italic abc} TImes フォント、イタリック体で abc
{/Arial:Bold=20 abc} Arial フォント、太字、サイズ 20 で abc
#\begin{tabular}{|clll|} \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 倍持ち上げた位置に重ね書き\\
#\verb| | & \verb|{/Times abc}| & {\rm abc} & Times フォント、今のサイズで abc を出力\\
#\verb| | & \verb|{/Times*2 abc}| & \Large{\rm abc} & Times フォント、今の倍のサイズで abc\\
#\verb| | & \verb|{/Times:Italic abc}| & {\it abc} & Times フォント、イタリック体で abc\\
#\verb| | & \verb|{/Arial:Bold=20 abc}| & \Large\textsf{\textbf{abc}} & Arial フォント、太字、サイズ 20 で abc\\
%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> &</tt></td> <td><tt> &{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>
書式制御文字は、それに続く 1 文字、または中カッコで囲まれたものに適用
されます。中カッコ内には、例えば 2^{10} のような追加の書式文字列のない
文字列か、またはフォントの属性を変更する追加制御文字列を入れることがで
きます。以下の例はその中カッコの入れ子を示していて、ボールド体の A に
イタリック体の下付きの添字 i がついたものが、いずれも現在のフォントで
描かれます。この例の :Normal を取ると、下付きの添字はボールド体でかつ
イタリック体になります。
{/:Bold A_{/:Normal{/:Italic i}}}
フォント指定は、開き中カッコ '{' の直後に続く '/' のすぐ次に書かなけれ
ば「いけません」。
空ボックス (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} は、Adobe Symbol フォントの無限大の記号です。しかし、こ
れは、 UTF-8 のようなマルチバイトエンコーディングではうまくいきません。
UTF-8 環境では、タイプ打ち、そうでなければあなたが望む文字を選ぶような
方法で、マルチバイト列を間接的に入力できるようにすべきです。
制御文字は、 \\ や \{ などのように \ を使ってエスケープできます。
二重引用符内の文字列は単一引用符内の文字列とは異なって解釈されることに
注意してください。主な違いは、二重引用符内の文字列ではバックスラッシュ
は 2 つ重ねる必要があることです。
gnuplot ソース配布物内の /docs/psdoc サブディレクトリにあるファイル
"ps_guide.ps" に、拡張された書式に関する例が載っています。同様のものが
デモ
^ <a href="http://www.gnuplot.info/demo/enhanced_utf8.html">
`enhanced_utf8.dem`
^ </a>
にもあります。
2 環境変数 (Environment)
?environment
`gnuplot` は多くのシェル環境変数を認識します。必須のものはありませんが、
使えば便利になるかも知れません。
GNUTERM は、それが定義されていれば、起動時のデフォルト出力形式として使
われます。これは、~/.gnuplot (またはそれに相当する) 初期化ファイル (以
下参照: `startup`) による指定や、もちろんその後の明示的な `set term`
コマンドによる指定で変更できます。
GNUHELP にヘルプファイル (gnuplot.gih) のパス名を定義しておくことがで
きます。
VMS では、論理名 GNUPLOT$HELP を `gnuplot` のヘルプライブラリの名前と
して定義します。`gnuplot` のヘルプは任意の VMS システムのヘルプライブ
ラリに入れることができます。
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` の数学関数の引数は整数、実数、複素数の値
を取ることができます。角を引数や戻り値とする関数 (例えば sin(x)) は、
その値をラジアンとして扱いますが、これはコマンド `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>, √( Re(<i>x</i>)<sup>2</sup> + Im(<i>x</i>)<sup>2</sup> )</td></tr>
^<tr> <td>acos(x)</td> <td>任意</td> <td>cos<sup>-1</sup> <i>x</i> (アークコサイン)</td></tr>
^<tr> <td>acosh(x)</td> <td>任意</td> <td>ラジアンでの cosh<sup>-1</sup> <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<sup>-1</sup> <i>x</i> (アークサイン)</td></tr>
^<tr> <td>asinh(x)</td> <td>任意</td> <td>ラジアンでの sinh<sup>-1</sup> <i>x</i> (逆双曲正弦)</td></tr>
^<tr> <td>atan(x)</td> <td>任意</td> <td>tan<sup>-1</sup> <i>x</i> (アークタンジェント)</td></tr>
^<tr> <td>atan2(y,x)</td> <td>整数または実数</td> <td>tan<sup>-1</sup>(<i>y/x</i>) (アークタンジェント)</td></tr>
^<tr> <td>atanh(x)</td> <td>任意</td> <td>ラジアンでの tanh<sup>-1</sup> <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<1, (-1:1) 内の実数 k</td> <td> Π(<i>n,k</i>) 第 3 種完全楕円積分</td></tr>
^<tr> <td>besj0(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>J</i><sub>0</sub> ベッセル関数 (0 次ベッセル関数)</td></tr>
^<tr> <td>besj1(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>J</i><sub>1</sub> ベッセル関数 (1 次ベッセル関数)</td></tr>
^<tr> <td>besy0(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>Y</i><sub>0</sub> ベッセル関数 (0 次ノイマン関数)</td></tr>
^<tr> <td>besy1(x)</td> <td>整数または実数</td> <td>ラジアンでの <i>Y</i><sub>1</sub> ベッセル関数 (1 次ノイマン関数)</td></tr>
^<tr> <td>ceil(x)</td> <td>任意</td> <td>⌈<i>x</i>⌉, <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<sup>x</sup></i>, <i>x</i> の指数関数</td></tr>
^<tr> <td>expint(n,x)</td> <td>任意</td> <td><i>E<sub>n</sub></i>(<i>x</i>), <i>x</i> の指数積分</td></tr>
^<tr> <td>floor(x)</td> <td>任意</td> <td>⌊<i>x</i>⌋, <i>x</i> (の実部) 以下の最大の整数</td></tr>
^<tr> <td>gamma(x)</td> <td>任意</td> <td>Γ(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 <i>W</i> 関数</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<sub>10</sub> <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> > 0 なら 1, <i>x</i> < 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>√<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> </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">libcerf (利用可能な場合のみ) による特殊関数</th></tr>
^<tr> <th>関数</th> <th>引数</th> <th>戻り値</th></tr>
^</thead>
^<tbody>
^<tr> <td>cerf(z)</td> <td>複素数</td> <td>複素誤差関数</td></tr>
^<tr> <td>cdawson(z)</td> <td>複素数</td> <td>複素 Dawson 積分</td></tr>
^<tr> <td>faddeeva(z)</td> <td>複素数</td> <td>再スケール化複素誤差関数 <i>w</i>(<i>z</i>) = exp(-<i>z</i><sup>2</sup>) × erfc(-i<i>z</i>)</td></tr>
^<tr> <td>erfi(x)</td> <td>実数</td> <td>虚誤差関数 erfi(<i>x</i>) = -i × erf(i<i>x</i>)</td></tr>
^<tr> <td>VP(x,sigma,gamma)</td> <td>実数</td> <td>Voigt プロファイル</td></tr>
^</tbody>
^</table>
^<p> </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>