Topdrawer の履歴(No.12) - Kohda Wiki

Topdrawer†

昔作ったメモ書きはこちら。

インストール†

Ubuntu20.04で動作したので作業記録。

岡村さんのFTPサーバーからバイナリファイル td-Linux.glibc2.3.gz をダウンロードする。
展開すると td-Linux.glibc2.3 というファイルが現れる。
パーミッションを755に変更する。
```
./td-Linux.glibc2.3
```
で起動を試みる。
「libXt.so.6 がない」というエラーが出て起動できない
libXt.so.6の32bit版をインストールする
```
sudo apt install libxtst6:i386
```
":i386"を付けることで明示的に32ビット版をインストールできる
再度 ./td-Linux.glibc2.3 してみる
起動した。(なぜか白黒反転してる)

出力先†

何も記述しなければ画面に出力する。明示的に書く場合は set device xwindow と書く。(多分)
ファイルに出力する場合
```
set device postscript orientation=3 file='out.ps'
```
のようにする。出力ファイル形式は多分Postscriptしか対応してない。orientation=3 の意味は、描画方向の指定らしい。要は3以外に指定すると変な向きになるので、おまじない的に書いておくべし、ということ。
岡村さんサーバーから入手出来る改造版Topdrawerは、出力先に指定できるのはX11 (xwindow), PostScript, Tek4010 (TEKEMUL)の3種類だけらしい。現実的にはTektronix 4010を使うことはないだろう。
set device test と記述することで出力先をNULLに出来る。使いみちは後述。

データの描画の種類†

データ点を打つ (このままだと点が小さくて見えない)
```
plot
```
点の種類(シンボル)、大きさ、色を指定
```
plot symbol=CP size=3 red
```
データ点を滑らかな線で結ぶ (0は省略しても良い)
```
join 0
```
データ点を直線で結ぶ
```
join 1
```
線の幅、色、種類(solid, dots, dashes, dotdashから選ぶ)を指定
```
join 1 width=2 green dashes
```

点と線両方描く

plot symbol=CP size=3 blue
join 1 width=3 blue dots

ヒストグラムとして描く
```
histogram
```

グラフの点(シンボル)の一覧†

画像は小林さんのページより拝借。
☆をプロット点に使う場合は、
```
plot symbol=LP
```
のようにする。

マクロの例†

example.top

( 半角左括弧でコメントを記述できる。
( 処理は記述順に実行されるので、書く順番は重要。
( 出力ファイルを指定。
set device postscript orientation=3 file='out.ps'

( 出力紙面上のグラフエリアの位置を指定。インチ単位。Xは 0 - 13, Yは 0 - 10 の範囲に収める
set window x 2 7 y 2 7

( この記述を入れたらフォントがきれいになる
set font duplex

( グラフの範囲指定
set limits x 0 to 2000 y 0 to 6000

( input fileの指定。ファイル形式はn行2列でスペース区切りで数値のみを記述。
set file input='input.dat'

( 軸タイトルの設定, lines= で位置を微調整できる
title bottom "Energy (keV)"
title left lines=-0.5 "Counts / keV"

( ヒストグラムとして出力。点をつ場合はplot, 線で結ぶならjoin。
histogram

実行コマンド
```
td example.top
```

描画例†

文字列を挿入する†

タイトル以外の文字もtitleで挿入できる
```
title text 6.4,6.4 rjustify "Simulation" size=3 intensity=3
```
- "title"に続く"text"は、textかdataを指定する。textは紙面座標系、dataはグラフ上のデータ座標系。
- rjustifyは座標の基準位置の指定。ljustify, rjustify, center の中から選ぶ。文字列の ~~左端、右端~~ 、中心のどこを座標基準にするか指定。
  - ljustify, rjustifyはどうも、一番左/右の文字の中心らしい。
- "Simulation" は表示させたい文字列。
- sizeは文字の大きさ。1-7で選ぶ。デフォルトは2。intensityは文字の太さで、sizeと同じ数値を記入するのを推奨。

紙面(TEXT)座標系で直線を引く†

joinする時にオプションtextをつけるとTEXT座標系でのその位置に直線を引くことが出来る。凡例を作るときなどに使えるかも。
```
6 5
8 5
join text
```

マクロ内でシェルコマンドを実行する†

"spawn" に続けてコマンドを書くと実行する。以下はマクロ実行時に出力ファイルをPDFに変換するコマンドの例。

( set device test で今まで開いていたpostscriptファイルから抜ける
set device test
spawn ps2pdf temp.ps
spawn pdfcrop --margins 8 temp.pdf out.pdf
spawn rm -f temp.ps temp.pdf

全般的に線を太くする†

文字も、数字も、枠線も、グラフも全部太くなる。 1 - 7で設定する。デフォルトは2。
```
set intensity 7
```

指定できる色†

デフォルトで、White, Red, Green, Blue, Yellow, Magenta, Cyan, Black の8色が用意されてる。
- 岡村さんのマニュアルによると、これらは、WHITE=FFFFFF、RED=FF0000、GREEN=00FF00、BLUE=0000FF、YELLOW=FFFF00、MAGENTA=FF00FF、CYAN=00FFFF、BLACK=000000 のカラーコードで定義されている。
定義を変更することで、任意の色を使える。変え方は、出力デバイスの指定のところで
```
set device postscript orientation=3 file='out.ps "yellow=b8860b"
```
のようにする。この例では、見えにくいYellowを茶色に変更してる。色の定義を変えることは出来るが、新しい色を定義して使える色数を増やすことは出来ない。

関連リンク†