PSXY

psxy − 地図上に線、多角形、記号を描画する

psxy files −Jparameters −Rwest/east/south/north[r] [ −A ] [ −B[p|s]parameters ] [ −Ccptfile ] [ −Ddx/dy ] [ −E[x|y|X|Y][cap][/pen] ] [ −Gfill ] [ −H[i][nrec] ] [ −K ] [ −L ] [ −N ] [ −M[flag] ] [ −O ] [ −P ] [ −S[symbol][size] ] [ −U[/dx/dy/][label] ] [ −V ] [ −W[pen] ] [ −X[a|c|r][x-shift[u]] ] [ −Y[a|c|r][y-shift[u]] ] [ −:[i|o] ] [ −ccopies ] [ −bi[s|S|d|D][ncol] ] [ −fcolinfo ]

psxy は (x,y) の組を files [または標準出力]から読んで、地図上のその位置 に 線、多角形、記号を描画する PostScript コードを出力する。記号を選択し てその大きさを与えなければ、 psxy は入力データの 3 列目を記号の大きさで あ ると解釈する。 size が <= 0 の記号は無視される。記号を指定しないとき には、記号コード(下の −S を参照)が入力の最後の列に存在していなければ な ら ない。複数セグメントのファイルは −M オプションを用いて描画することが できる。 −S を選択しないときは、代わりにデータ点を結ぶ線が描かれる。 閉 じ た多角形にすることを明示するには −L を用いること。塗りつぶしは −G で 選択すること。 −G を設定したときは、 −W により多角形の輪郭を引くか否 か を 決めること。記号を選択したときは、 −G と −W を用いてそれぞれ塗りつぶ しと輪郭の有無を決めること。 PostScript コードは標準出力に書き出され る 。

files

1 つ以上のファイル名を列挙すること。ファイルが与えられな いときは、 psxy は標準入力を読み込む。

−J

地図の図法を選択する。尺度は UNIT/degree 、1:xxxxx 、 又 は UNIT 単 位 の 幅 (オプションを大文字にする) である。 UNIT は .gmtdefaults4 で設定された MEASURE_UNIT によって cm 、インチ 、 又は m になるが、 c, i, m を scale/width の値に付けることによっ て、コマンドライン上で上書き変更することができる。地図の高さ 、 最 大 の大きさ、最小の大きさを指定するには、それぞれ h, +, - を width に付けること。

詳細は psbasemap の man ページを参照すること。

円筒図法:

−Jclon0/lat0/scale (カッシーニ図法)
−Jjlon0/scale (ミラー図法)
−Jmscale (メルカトル図法 - 投影中心はグリニッジ子午線と赤道)
−Jmlon0/lat0/scale (メルカトル図法 - 中心子午線と標準緯度 を 設 定)
−Joalon0/lat0/azimuth/scale (斜めメルカトル図法 - 投影中心と方 位角を設定)
−Joblon0/lat0/lon1/lat1/scale (斜めメルカトル図法 - 2 点を設定)
−Joclon0/lat0/lonp/latp/scale (斜めメルカトル図法 - 中心点と極 を設定)
−Jqlon0/scale (等距円筒図法 (Plate Carree))
−Jtlon0/scale (TM - 横メルカトル図法、赤道は y = 0)
−Jtlon0/lat0/scale (TM - 横メルカトル図法、原点を設定)
−Juzone/scale (UTM - ユニバーサル横メルカトル図法)
−Jylon0/lats/scale (基本円筒図法)

方位図法:

−Jalon0/lat0/scale (ランベルト正積方位図法)
−Jelon0/lat0/scale (正距方位図法)
−Jflon0/lat0/horizon/scale (心射図法)
−Jglon0/lat0/scale (正射図法)
−Jslon0/lat0/[slat/]scale (一般平射図法)

円錐図法:

−Jblon0/lat0/lat1/lat2/scale (アルベルス正積円錐図法)
−Jdlon0/lat0/lat1/lat2/scale (正距円錐図法)
−Jllon0/lat0/lat1/lat2/scale (ランベルト正角円錐図法)

様々な図法:

−Jhlon0/scale (ハンメル図法)
−Jilon0/scale (正弦曲線図法＝サンソン図法)
−Jk[f|s]lon0/scale (エッケルト IV (f) 及び VI (s) 図法)
−Jnlon0/scale (ロビンソン図法)
−Jrlon0/scale (ヴィンケル第 3 式図法)
−Jvlon0/scale (ファン・デア・グリンテン図法)
−Jwlon0/scale (モルワイデ図法)

非地理的図法:

−Jp[a]scale[/origin][r|z] (極座標 (theta,r))
−Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (線形、対数 、 指数スケーリング)

−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] の形式でなければならない 。区切り文字を利用する場合にはその型と位置が指定どおりでなけ れ ばならない(ただし入出力と描画フォーマットは変更可能である)。

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

−A

線分を大円の弧として描かないようにする [デフォルトでは大円 の弧として描く]。

−B

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

−C

カラーパレットファイルを与える。 −S と一緒に使うと、記号の 色は 3 列目の z の値により決定される。追加の情報は 1 列づつ付け 足されていく (記号の大きさは 3 列目ではなく 4 列目等)。 −S を設 定しないときは、 psxy はユーザが複数セグメントの線又は多角形 の フ ァイルを与えていると見なし( −M が必要)、各複数セグメントのヘ ッダで −Zval の文字列を探す。この val は cpt ファイル経由で線又 は( −L が設定されていれば)多角形の色を制御する。

−D

記号の位置を与えられた dx/dy だけずらす[デフォルトではずら さない]。記号のみに適用される。

−E

エラーバーを描く。 x や y を付けてどのバーを描くのかを指 定 すること (デフォルトでは x と y の両方)。 x や y の誤差は (x,y) の組[または (x,y,大きさ) の組]の次の列に無ければならない。 cap パラメータはエラーバーの両端の短い棒の長さを示す [0.25c (または 0.1i)]。エラーバーのペン属性を設定することもできる [デフォルト: 幅 = 1, 色 = 黒, テクスチャ = 実線]。大文字の X や Y を使うと、 「箱とほおひげ」(「幹と葉」)の記号を描く。 x (または y) 座標 は 中央値と見なされ、 4 列目以降には最小値( 4 等分の 0% )、 4 等分 の 25% 、 4 等分の 75% 、最大値( 4 等分の 100% )があると見な さ れる。 25-75% の箱は −G を用いて塗りつぶすことができる。

−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 を参照すること。
−M を選択しているときは、 psxy は全てのサブヘッダより下の部分で −G 及び −W の文字列を探索して見つけた全ての値についてコマンドラ インの設定を上書きするので注意すること。

−H

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

−K

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

−L

閉じた多角形にする。線分の端の点を結んで多角形を描く。ま た 、−C, −M 及びヘッダの−Z 設定と共に多角形の塗りつぶしの色を暗に 指定する[デフォルトは多角形のペンの色]。

−M

複数のセグメントからなるファイルであることを意味する。セ グ メントは flag で始まる行で区切られる [デフォルトは ’>’ ]。

−N

地図の枠からはみ出す記号を省略しない[デフォルトでは枠内の点 のみ描画する]。線と多角形については常に地図領域にクリップされる ためこのオプションは適用されない。

−O

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

−P

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

−S

記号を描画する。もし size があれば、( c, i, m, p が付加され ない限り) .gmtdefaults4 で設定された単位による記号の大きさに な る 。記号のコード(下を参照)が与えられないときは入力データの最後 列から読まれるが、これは −b と共に使うことはできない。随意で c, i, m, p を付けて、入力データによる記号の大きさの値がそれぞれ cm 、インチ、メートル、ポイントのいずれであるかを示すことができ る [デフォルトは MEASURE_UNIT]。注意: 入力ファイル経由で大きさと記 号の両方を与えるときは、記号のサイズに使用される単位を示すの に MEASURE_UNIT を使わなければならない。

大文字の記号 A, C, D, G, H, I, N, S, T は直径 size の円と同じ面 積を持つように規格化されており、一方対応する小文字の記号は全 て 円 に内接するようになっている。以下の記号のコードの中から選ぶこ と。

−S-

x-ダッシュ。 size は短い水平の線分の長さ。

−Sa

星( star )。 size は外接する円の直径。

−Sb

base から y まで伸びる棒( bar )。 size は棒の幅。 size が x と同じ単位のときは u を付けること [デフォルトでは図上の長さの 単位]。デフォルトでは base = 0 。この値を変えるときは bbase を 付けること。

−Sc

円( circle )。 size は円の直径。

−Sd

菱形( diamond )。 size は外接する円の直径。

−Se

楕円( ellipse )。方向(水平から反時計回りの角度)、長軸の長 さ、短軸の長さが 3, 4, 5 列目になければならない。

−SE

方向の代わりに方位(北から時計回りの角度)を与える他 は −Se と 同じ。方位は選んだ図法に基づいた角度になる( −Se では方向は不 変)。さらに、軸の長さは図上の単位ではなく km で与えなければなら な い。ただし −R と同じ単位で楕円の軸を与えた線形図法ではこの限 りではない。

−Sf

前線( front )。 −Sfgap/size[dir][type][:offset] 。記号間の 隙間の距離と記号の大きさを与えること。 gap が負のときは、代わり に前線に沿ってその数だけ記号を描画するという意味に解釈される 。 記 号を前線の左側( left )又は右側( right )に描画するには dir を 付けること [デフォルトは中心]。箱( box )、円( circle )、 断 層( fault )、横ずれ断層( slip )、三角( triangle )のうちいずれの記号 を描画するか指定するには type を付けること[デフォルトは断層] 。 横ずれ断層とは、左横ずれまたは右横ずれの矢印のことである(中央は オプションに無い)。前線の開始点から最初の記号の位置までのずれを 指定するには offset を指定すること[デフォルトは 0 ]。

−Sh

六角形( hexagon )。 size は外接する円の直径。

−Si

逆三角形( inverted triangle )。 size は外接する円の直径。

−Sj

回転した長方形。方向(水平から反時計回りの角度)、 x 方向の 長さ、 y 方向の長さが 3, 4, 5 列目になければならない。

−SJ

方向の代わりに方位(北から時計回りの角度)を与える他 は −Sj と 同じ。方位は選んだ図法に基づいた角度になる( −Sj では方向は不 変)。さらに、軸の長さは図上の単位ではなく km で与えなければなら な い。ただし −R と同じ単位で楕円の軸を与えた線形図法ではこの限 りではない。

−Sk

カスタム記号( kustom symbol )。 <name>/size を付ける と 、 <name>.def という定義ファイルを (1) カレントディレクトリ、 (2) ~/.gmt 又は (3) $GMTHOME/share/custom の中から探す。そのファ イ ルで定義された記号はデフォルトで大きさ 1.0 になる。記号の大きさ は付加された size に応じてスケールされる。ユーザは独自のカス タ ム *.def ファイルを追加できる。下の「カスタム記号」を参照。

−Sl

文字( letter )あるいは文字列( 64 字以内)。大きさを与え、そ の後に /string を付けること。大きさはおよそなので注意。文字毎に 個別にはスケールされない。 * のような特別な文字は避けること。随 意で %font を付けて特定のフォントを選択することができる [デフォ ルトは ANNOT_FONT_PRIMARY ]。

−Sg

八角形( octagon )。 size は外接する円の直径。

−Sn

五角形( pentagon )。 size は外接する円の直径。

−Sp

点( point )。大きさを指定する必要は無い( 1 ピクセルが用い られる)。

−Sq

説明付きの線( quoted line )、すなわち等値線のような目盛 付 きの線。 [d|f|n|l|x]info[:labelinfo] を付けること。この記述によ り説明付きの線に沿ったラベルの配置を制御する。以下の 5 通りの制 御アルゴリズムの中から選ぶこと。

ddist[c|i|m|p] 又は Ddist[d|e|k|m|n]

小 文字の d は描画上のラベルの間隔を c (cm), i (インチ), m (メートル), p (ポイント)のいずれかの単位によって示すも のである。一方、大文字の D は e (m), k (km), m (マイル), n (海里), d (度)のいずれかの地図上の単位によって示すもの である[デフォルトは 10c 又は 4i ]。

fffile.d

ア スキーファイル ffile.d を読んで説明付きの線に沿った位 置に合うファイルの位置にラベルを配置する。不正確な位置や 領域外の点は飛ばされる。

l|Lline1[,line2,...]

1 つ以上のコンマで区切られた直線セグメントの start (開 始)と stop (終了)の座標を与える。これらの線が説明付き の 線と交差する位置にラベルは配置される。それぞれの line の フォーマットは start/stop であり、 start と stop は特 定 の点 lon/lat (経度/緯度)又は pstext で地図上の点を示すの に使われる [LCR][BMT] で与えられる 2 文字の XY のキー の いずれかである。 L は点の組を大円として解釈する[デフォル トは直線]。

nn_label

説明付きの線に対する等距離なラベルの数を指定する[ 1 ] 。 大 文字の N は線の開始点ちょうどからラベルの配置を開始す る[デフォルトでは線の中央に配置する]。 N-1 は説明付き の 線 の開始点にラベルを配置し、一方 N+1 は説明付きの線の終 了点にラベルを配置する。随意で /min_dist[c|i|m|p] を付け ると連続するラベルの最小間隔が保たれる。

x|Xxfile.d

複 数 セ グメントファイル xfile.d を読んで説明付きの線と xfile.d の線の交差点にラベルを配置する。 X にすると最 初 に大円に沿って線をサンプルし直す。

オ プションの labelinfo はラベルの書式を制御するためのもので、制 御のための記述を結合した以下の文字列で構成される。

+aangle

目盛の角度を固定する。 +an とすると線に垂直に、 +ap とす ると線に平行[デフォルト]になる。

+cdx[/dy]

ラベルとオプションのテキストボックスの間の間隔を設定する 。 c|i|m|p を付けて単位を指定するか、 % を付けてラベルの フ ォントサイズ [15%] のパーセンテージを指定することがで きる。

+ffont

希望するフォントを設 定 す る[ デ フ ォ ル ト は ANNOT_FONT_PRIMARY]。

+g[color]

不透明なテキストボックスを選ぶ[デフォルトは透明]。随意で 色を指定できる[デフォルトは PAGE_COLOR]。

+jjust

ラベルの位置を設定する[デフォルトは CM]。

+kcolor

テキストラ ベ ル の 色 を 設 定 す る[ デ フ ォ ル ト は COLOR_BACKGROUND ]。

+llabel

一定のラベルテキストを設定する。

+Lflag

以下の指定されたフラグによるラベルテキストを設定 する。

+Lh

現在の複数セグメントのヘッダからラベルを採用 する (セグメントフラグに続く最初の単語を使わない ときは、最初に埋め込まれた −Llabel オプション か ら読み取られる)。

+Ld

線に沿ったカルテジアン座標上の距離をラベルに 用いる。単位として c|i|m|p を付けること[デフォル トは MEASURE_UNIT ]。

+LD

実 際の地図上の距離を計算する。単位として d|e|k|m|n を付けること [デフォルトはラベルの配置 がそのアルゴリズムで指定されたのと同じ単位を使っ た線に沿った地図上の距離に基づいていない限り d ( 度)]。

+Lf

固定ラベル位置ファイルの 2 列目の後のテキス トをラベルとして使う。固定ラベル位置設定が必要。

+Lx

xfile.d のヘッダを使う以外は +Lh と同じ。交 差ファイルオプションが必要。

+o

角の丸い長方形のテキストボックスを選ぶ[デフォルト は

普 通の長方形]。曲がった文字列 (+v) 適用できないし、不透 明なテキストボックスでしか意味が無い。

+p[pen]

テキストボックスの枠を描く[デフォルトは枠無し]。随意で枠 の ペン属性を指定できる[デフォルトは幅 = 0.25p 、色 = 黒 、テクスチャ = 実線]。 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 (テクスチャ)はダッシュ ‘-’ と 点 ‘.’ の組合せである。

+rmin_rad

線の曲率半径が min_rad [デフォルトは 0 ]より小さな場所に はラベルを配置しない。

+ssize

希望するフォントサイズをポイント単位で設定す る[ デフォルトは 9 ]。

+uunit

全ての線のラベルに unit (単位)を付ける。 unit の 頭にハイフン (-) が付けるとラベルの値と単位の間の隙間 が なくなる。 unit が付いていないときはグリッドファイルの中 にある単位が用いられる [デフォルトでは単位は付かない]。

+v

線に沿って曲がったラベルにする[デフォルトではまっ す ぐなラベルになる]。

+w

ラベルの角度を推定するのに使われる (x, y) の点数を指 定する[デフォルトは 10 ]。

+=prefix

prefix を全ての線のラベルの前に付ける。 prefix の頭に ハ イ フン (-) が付けるとラベルの値と単位の間の隙間がなくな る [デフォルトでは付かない]。

−Sr

長方形( rectangle )。大きさを指定する必要はないが、 3 列目 と 4 列目に x 方向及び y 方向の長さが必要である。

−Ss

正方形( square )。 size は外接する円の直径。

−St

三角形( triangle )。 size は外接する円の直径。

−Sv

ベクトル( vector )。方向(水平から反時計回りの角度)と長さが 3 列目及び 4 列目に必要である。 size が指定されていれば、矢印の 幅/ 頭 の 長 さ/ 頭 の 幅 で あ る と 解 釈される [デフォルトは 0.075c/0.3c/0.25c (又は 0.03i/0.12i/0.1i )]。デフォルトでは矢印 の 属性は矢印の長さに対して不変である。ベクトルが短くなったとき にベクトルのスケールも小さくするには nnorm を付けること。すると 、ベクトルが norm より短いときには、矢印の属性は length/norm に よってスケールされる。ベクトルの均衡点を中心にするには −Svb を 使 うこと。ベクトルの先端の位置を揃えるには −Svh を使うこと。ベ クトルの末端の位置を揃えるには −Svt [デフォルト]を使うこと。 方 向 と長さの代わりに先端の位置を与えるには −Svs を使うこと。大文 字 B, H, T, S により両端に頭の付いたベクトルを描くことができる[ デフォルトは片方のみ]。

−SV

方向の代わりに方位(北から時計回りの角度)を与える他は −Sv と同じ。方位は選んだ図法に基づいた角度になる( −Sv では方向は 不 変)。

−Sw

扇形( pie wedge )。開始と終了の方向(水平から反時計回りの角 度)と長さが 3 列目及び 4 列目に必要である。

−SW

2 つの方向の代わりに方位(北から時計回りの角度)を与える他は −Sw と同じ。方位は選んだ図法に基づいた角度になる( −Sw では方向 は不変)。

−Sx

十字形。 size は外接する円の直径。

−Sy

y-ダッシュ。 size は短い垂直の線分の長さ。

−U

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

−V

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

−W

線又は記号の輪郭のペン属性を指定する[デフォルトは幅 = 1 、 色 = 黒、テクスチャ = 実線]。 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 (テクスチャ)はダッシュ ‘-’ と点 ‘.’ の組合せである。

−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) に動かす。

−:

入出力の(経度、緯度)と(緯度、経度)を入れ替える[デフォルト は(経度、緯度)]。 i を付けると入力のみが、 o を付けると出力のみ が入れ替わる[デフォルトでは両方入れ替わる]。

−bi

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

−c

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

−f

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

範 囲 150E から 154E 、 18N から 23N 、 5 cm/度 のメルカトル図に、 1 度 間隔のケバと 15 分間隔の格子線を付けて、赤い円(直径 = 0.25 cm )をファイ ル DSDP.xy にリストされた位置に描画する。

psxy DSDP.xy −R150/154/18/23 −Jm5c −Sc0.25c −Gred −B1g15m | lpr

ファイル quakes.xyzm の中の xyz の値を、 4 列目のマグニチュードで与えら れる大きさとカラーパレット cpt を用いて、 3 列目の深さに基づいた色の 円 で線形図に描画する。

psxy quakes.xyzm −R0/1000/0/1000 −JX6i −Sc −Ccpt −B200 > map.ps

辺の長さ 0.25 インチの白い三角形を線の左側に 0.8 インチ間隔で付けた断層 で、ファイル trench.xy をメルカトル図に描画する。

psxy trench.xy −R150/200/20/50 −Jm0.15i −Sf0.8i/0.1ilt −Gwhite −W −B10 | lpr

ファイル misc.d のデータを、最終列のコードで定義される記号、 4 列目の大 きさで与えられるサイズ、 3 列目からカラーパレット cpt 経由で得られる 色 で線形図に描画する。

psxy misc.d −R0/100/-50/100 −JX6i −S −Ccpt −B20 > t.ps

−N オプションは BoundingBox の情報を調整しない。これは、 PostScript の 出力に対して epstool 又は ps2epsi を用いて正しい BoundingBox を得る処理 を後ですることができるようにするためである。
psxy は南極や北極を含む多角形の塗りつぶしを扱うことができない。このよう な多角形については、コピーを作り 2 つに分割してそれぞれに明示的に極が含 まれるようにすること。 2 つの多角形が合わさることにより塗りつぶしたとき に希望する効果がもたらされる。輪郭を描くには元の多角形を使うこと。

psxy 及び psxyz ではユーザが独自のカスタム記号を定義し描画することが で き る。これは以下に記述する単純な描画コードを使って記号をコード化するこ とにより実現される。新しい記号の描画コードを全てファイルに記述するこ と 。 そのファイルの拡張子は .def でなければならない。そうすることによりそ の記号を拡張子無しで呼び出すことができるようになる (例、記号フ ァ イ ル tsunami.def は −Sktsunami/size と指定することにより使われる)。定義ファ イルは任意の数の描画コードの列の他、空行と( # で始まる)コメント行を含む こ とができる。 psxy 及び psxyz は定義ファイルを (1) カレントディレクト リ、 (2) ~/.gmt ディレクトリ、及び (3) $GMTHOME/share/custom ディレ ク トリの順で探す。 (直線セグメントと円弧からなる)自由形状の多角形をデザイ ンすることができ、このような多角形は色付けしたり模様で埋めたりするこ と が できる。その他の標準的な幾何学的な記号も使うことができる。円を除いて 、このような記号は色付けができるだけで、模様で埋めることはできない ( 自 由形状の多角形を用いて模様で埋めることができる三角形を含めること)。自由 形状の多角形 (ペン及び塗りつぶしの属性を指定するには [ −Wpen ] 及 び [ −Gfill ] を付けること) を作成するには固定点
x0 y0 M
から開始し、現在の点から次の点まで
x y D
により直線を引くか、
xc yc r dir1 dir2 A
に より円弧を追加する。 D や A 以外の行になると、多角形は閉じて終了した と見なされる。オプションのペンと塗りつぶしの設定により、特定の値がこ の 図 形の特徴として組み込まれる。それらが存在しないときは、その特徴はペン と塗りつぶしに対するコマンドラインからの設定により決定される。与えら れ た 多角形の塗りつぶしや輪郭を無効にするには、 −G− 又は −W− を与えること 。他の幾何学的な形をカスタム記号に追加するには、以下の描画コードを追 加 す ること(それぞれ [ −Wpen ] 及び [ −Gfill ] を最後に追加することができ る)。

星: x y size a
円: x y size c
十字形: x y size x
菱形: x y size d
楕円: x y dir major minor e
六角形: x y size h
逆三角形: x y size i
文字: x y size string l
八角形: x y size g
五角形: x y size n
長方形: x y xwidth ywidth r
正方形: x y size s
三角形: x y size t
扇形: x y radius dir1 dir2 w

記号をデザインするとき、 x, y 及び他の長さは大きさ 1 の記号に対して相対 的 にであり、実行時に選択された実際の記号の大きさにスケールされる。記号 をデザインするために、 psbasemap −R-0.5/0.5/-0.5/0.5 −JX4i −Ba0.1g0.05 −P > grid.ps により方眼紙を作成してから (0,0) を中心とする記号を描くと 良い。記号の例は、 GMT と共に $GMTHOME/share/custom に与えられている セ ットを参照すること。

GMT(l), psbasemap(l), psxyz(l)