PSHISTOGRAM

pshistogram − データを値域毎にまとめヒストグラムを描画する

pshistogram file −Jx|Xparameters −Wbin_width [ −A ] [ −B[p|s]parameters ] [ −C ] [ −Eazimuth/elevation ] [ −Gfill ] [ −H[i][nrec] ] [ −Jz|Zparameters ] [ −I[o|O] ] [ −K ] [ −Lpen ] [ −O ] [ −P ] [ −Q ] [ −Rxmin/xmax/ymin/ymax[r] ] [ −S ] [ −Tcol ] [ −U[/dx/dy/][label] ] [ −V ] [ −X[a|c|r][x-shift[u]] ] [ −Y[a|c|r][y-shift[u]] ] [ −Ztype ] [ −ccopies ] [ −bi[s|S|d|D][ncol] ] [ −f[i|o]colinfo ]

pshistogram は file [又は標準入力]を読み取ってデータ列 col を調べ、与え ら れた値域に基づいてヒストグラム用のパラメータを計算する。これらのパラ メータ、スケーリング、そして随意で範囲のパラメータを与えることにより 、 ヒ ストグラムを描画する PostScript コードを生成する。累積ヒストグラムを 作成することもできる。

file

アスキー[又はバイナリ、 −b 参照]のデータファイル。ファ イ ルが与えられていないときは、 pshistogram は標準入力から読み取る 。

−Jx

xscale[/yscale] (unit/data 単位の距離の線形スケール)。

−W

ヒストグラムの計算で用いる値域を設定する。

オプションフラグとそれに付属する引き数の間にスペースを入れないこと。

−A

ヒストグラムを x = 0 から水平方向に描画する [デフォルトでは y = 0 から垂直方向に描画する]。

−B

地 図 の 枠 の 目 盛とケバの間隔を設定する。全ての詳細は psbasemap の man ページを参照すること。

−C

値域の中心をそれぞれの値とする[デフォルトは左端]。

−E

(遠近図法用の)視点の方位角と仰角を設定する[ 180/90 ]。

−G

棒の塗りつぶしを選択する[デフォルトでは塗りつぶし無し]。 グ レ ー ス ケ ー ル (0−255)、カラー(r/g/b, それぞれ範囲は 0−255; h-s-v, 範囲は 0−360, 0−1, 0−1; c/m/y/k, それぞれ範囲は 0−100%; 有効なカラー名)を指定すること。代わりに、 −Gpdpi/pattern 、ただ し pattern には用意された模様 (1-90) 又は Sun の 1, 8, 24 ビ ッ トのラスタファイルの名前を与えることもできる。 dpi には画像の解 像度を設定すること。 1 ビットのラスタについては −GP を使うと 反 転画像になる。前景や背景の色を指定するには :Fcolor[B[color]] を 付けること (透明にするには color = - とする)。個々の模様に関 す る 情報については GMT テクニカルリファレンス & クックブックの付 録 E を参照すること。

−H

入力ファイルにヘッダ行がある時に使う。 ヘ ッ ダ 行 の 数 は .gmtdefaults4 ファイルを編集することにより変更できる。このオプ ションが使われた場合、 GMT のデフォルトではヘッダ行は 1 行で あ る。入力データだけにヘッダ行が必要な場合は −Hi を使うこと [デフ ォルトでは入力データにヘッダ行があればそれも出力される]。

−I

データを値域毎にまとめた後に x 及び y の最大、最小を調べ る 。 描画は行われない。 o を付けると結果の x,y データのアスキーテ ーブルを標準出力に出力する。代わりに、 y == 0 のときでも全て の x,y ビンデータを出力するには O を付けること。

−K

さらに PostScript コードが後に続くときに使用する [デフォル トでは描画システムを終了する]。

−L

指定した太さのペンで棒の輪郭を描く[デフォルトでは輪郭な し] 。 pen (ペン属性)はコンマで区切られた width, color, texture の リストで、それぞれはオプションである。 width (幅)は長さの単 位( ポ イ ン ト、センチメートル、インチ)又は faint, thin[ner|nest], thick[er|est], fat[ter|test], obese のいずれかで指定すること が で きる。 color (色)はグレースケール (0−255) 又はカラー (r/g/b, それぞれ範囲は 0−255; h-s-v, 範囲は 0−360, 0−1, 0−1; c/m/y/k, そ れ ぞ れ 範 囲 は 0−100%; 有効なカラー名) により指定できる。 texture (テクスチャ)はダッシュ ‘-’ と点 ‘.’ の組合せである。

−O

上書き描画モードを選択する [デフォルトでは新しい描画シス テ ムに初期化する]。

−P

縦置き描画モードを選択する [ GMT のデフォルトは横置きである 。これを変更するには gmtdefaults を参照すること]。

−Q

累積ヒストグラムを描画する。

−R

xmin, xmax, ymin, ymax は対象とする領域を指定する。地理的領 域 に対しては、これらの境界は西、東、南、北に対応し、小数値を含 む度又は [+-]dd:mm[:ss.xxx][W|E|S|N] のフォーマットで指定できる 。東西南北の代わりに地図座標の左下と右上を使うときは r を付ける こと。 2 つの略号 −Rg −Rd は全球領域(それぞれ経度 0/360 又 は -180/+180 と緯度 -90/+90 )を表す。暦時間座標系に対しては相対時 間(選択された TIME_EPOCH に対して相対的で、選択された TIME_UNIT を単位とする。 t を −JX|x に付けること)又は [date]T[clock] 形式 の絶対時刻(T を −JX|x に付けること)のどちらかを与えることができ る。少なくとも date と clock のどちらかが存在していなければなら ない。 T は常に必要である。 date の文字列は [-]yyyy[-mm[-dd]] ( グレゴリオ暦)又は yyyy[-Www[-d]] (ISO 週暦)の形式でなければなら ない。 clock の文字列は hh:mm:ss[.xxx] の形式でなければならない 。 区切り文字を利用する場合にはその型と位置が指定どおりでなけれ ばならない(ただし入出力と描画フォーマットは変更可能である)。 こ のオプションを与えないときは pshistogram はこの領域に適切な値を 自動的に見つける。

−S

ヒストグラムの代わりに階段ステップダイアグラムを描画する。

−T

ヒストグラムデータに使用する列を指定する。最初の列は 0 [0] 。

−U

図に Unix システムのタイムスタンプを入れる。図の左下隅に対 するスタンプの左下隅の相対的な位置を決めることができる。随意 で ラ ベ ル又は c (コマンドの文字列を入れる)を付けることができる。 GMT のパラメータ UNIX_TIME と UNIX_TIME_POS は外見に影響を及 ぼ す。詳細は gmtdefaults の man ページを参照すること。

−V

冗長モードを選択する。標準エラー出力に経過報告を送る [デフ ォルトでは「黙って」実行する]。

−X −Y

図の原点を現在の原点に対して (x-shift,y-shift) だけ動 か す 。随意で長さの単位 (c, i, m, p) を付けることができる。値の前 に a を付けると描画後に原点を元の位置に戻し、値の前に r [デフォ ルト]を付けると現在の原点を新しい位置として再設定する。 −O を使 うとデフォルトの (x-shift,y-shift) が (0,0) になり、そうでな い ときは (r1i, r1i) 又は (r2.5c, r2.5c) になる。代わりに、 c は現 在のページサイズに基づくページの中心を使って図を中央の座 標 (x 又は y) に動かす。

−Z

6 種類のヒストグラムの中から選択する。 0 = 個数[デフォルト]、 1 = 頻度パーセント 2 = log (1.0 + 個数) 、 3 = log (1.0 + 頻度パーセント)、 4 = log10 (1.0 + 個数)、 5 = log10 (1.0 + 頻度パーセント)。

−c

図のコピー枚数を指定する[デフォルトは 1 ]。

−bi

バイナリ入力を選択する。単精度に対しては s を付けること[デ フォルトは d (倍精度)]。大文字の S (又は D) にするとバイトス ワ ッ プを行う。随意で、バイナリファイルの列数がこのプログラムで必 要な列数を越えるときは、バイナリファイルの列数 ncol を付ける こ と[デフォルトは 2 列]。

−f

入 出 力列の特殊フォーマットを使う(時間又は地理データ)。 i(nput) 又は o(utput) を指定すること [デフォルトでは入力と出 力 の 両方]。コンマ区切りで 1 列以上(又は列の範囲)を与えること。各 列又は列の範囲の項目に対して T (絶対暦時刻)、 t (選 択 さ れ た TIME_EPOCH に対する相対時間)、 x (経度)、 y (緯度)、 f (小数) のいずれかを付けること。 −f[i|o]g は −f[i|o]0x,1y (地理座標) の 省略形である。

値域を 250 メートル、棒の位置を中央、棒の輪郭を描くように設定し、海底の 深さを含むデータ v3206.t のヒストグラムを描画する。

pshistogram v3206.t −JXh −W250 −C −L0.5p −V > plot.ps

データの分布がわかっているときは、範囲とスケールを明示的に特定するこ と ができる。例えば、値域を 1 メートル、範囲を -10 から +10 メートルまで、 スケールを 0.75 cm/m、目盛りを 2 m 及び 100 カウント間隔、バーの色を 黒 とし、ファイル errors.xy の y の値( 2 列目)のヒストグラムを描画する。

pshistogram errors.xy −W1 −R-10/10/0/0 −Jx0.75c/0.01c −B2:Error:/100:Counts: −Gblack −T1 −V > plot.ps

y の範囲が指定されていないので、 pshistogram は ymax を 100 の偶数倍 ご とに計算する。

−W オプションは時系列データ(例えば −f0T )にはまだ正しく機能しない。その ため、月や年のような変数は計算されない。その代わりに、現在の TIME_UNIT の設定と同じ単位で間隔を指定すること。

GMT(l), psbasemap(l), psrose(l), psxy(l)