psclip − 多角形のクリップパスを構成する |
psclip xyfiles −Jparameters −Rwest/east/south/north[r] [ −B[p|s]parameters ] [ −Eazim/elev ] [ −K ] [ −N ] [ −M[flag] ] [ −O ] [ −P ] [ −U[/dx/dy/][label] ] [ −V ] [ −X[a|c|r][x-shift[u]] ] [ −Y[a|c|r][y-shift[u]] ] [ −Zzlevel ] [ −ccopies] [ −:[i|o] ] [ −bi[s|S|d|D][ncol] ] [ −fcolinfo ] psclip −C [ −K ] [ −O ] |
psclip は (x,y) ファイル[又は標準入力]を読んでクリッピングパスとして機 能する多角形を作成する。複数のファイルを読んで、複数の接続していない セ グメントからなる複雑なパスを作成することもできる。オプションとして (−N) 、パスの内側と外側の意味を逆にすることもできる。これらのパスによりク リ ップした状態で一連の描画を実行した後、オプション −C だけを付けた psclip をもう一度実行することにより、クリップ状態を無効にすることができる。 |
xyfiles |
クリップ用の多角形に対する (x,y) の値を持つアスキー[又はバイ ナ リ、 −b 参照]ファイル。ファイルが与えられないときは標準入力から 読み込まれる。 |
−C |
現在有効になっているクリップパスを終了する。入力ファイル や 地図情報は不要である。 |
||
−J |
地図の図法を選択する。尺度は UNIT/degree 、1:xxxxx 、又は UNIT 単位の幅 (オプションを大文字にする) で あ る 。 UNIT は .gmtdefaults4 で設定された MEASURE_UNIT によって cm 、インチ、 又は m になるが、 c, i, m を scale/width の値に付けることによっ て 、コマンドライン上で上書き変更することができる。地図の高さ、 最大の大きさ、最小の大きさを指定するには、それぞれ h, +, - を width に付けること。 |
詳細は psbasemap の man ページを参照すること。 円筒図法: −Jclon0/lat0/scale
(カッシーニ図法) 方位図法: −Jalon0/lat0/scale
(ランベルト正積方位図法) 円錐図法: −Jblon0/lat0/lat1/lat2/scale
(アルベルス正積円錐図法) 様々な図法: −Jhlon0/scale (ハンメル図法) 非地理的図法: −Jp[a]scale[/origin][r|z]
(極座標 (theta,r)) |
−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] の形式でなければならない 。 区切り文字を利用する場合にはその型と位置が指定どおりでなけれ ばならない(ただし入出力と描画フォーマットは変更可能である)。 |
オプションフラグとそれに付属する引き数の間にスペースを入れないこと。 |
−B |
地図の枠の目盛とケバの間隔を設定 す る 。 全 て の 詳 細 は psbasemap の man ページを参照すること。 |
||
−E |
視点の方位角と仰角を設定する[ 180/90 ]。 |
||
−H |
入 力 フ ァ イルにヘッダ行がある時に使う。ヘッダ行の数は .gmtdefaults4 ファイルを編集することにより変更できる。このオ プ シ ョンが使われた場合、 GMT のデフォルトではヘッダ行は 1 行であ る。入力データだけにヘッダ行が必要な場合は −Hi を使うこと [デフ ォルトでは入力データにヘッダ行があればそれも出力される]。 |
||
−K |
さらに PostScript コードが後に続くときに使用する [デフォル トでは描画システムを終了する]。 |
||
−M |
複数のセグメントからなるファイルであることを意味する。セ グ メントは <flag> [デフォルトは ’>’ ]で始まる行で区切られる。 |
||
−N |
パスの内側と外側の意味を逆にする。すなわちクリッピングには 多角形の外側が使われる。 |
||
−O |
上書き描画モードを選択する[デフォルトでは新しい描画システム に初期化する]。 |
||
−P |
縦置き描画モードを選択する [ GMT のデフォルトは横置きである 。これを変更するには gmtdefaults を参照すること]。 |
||
−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 |
3 次元図法用。基本図の z の高さを設定する[0]。 |
||
−: |
入出力の(経度、緯度)と(緯度、経度)を入れ替える[デフォ ル ト は(経度、緯度)]。 i を付けると入力のみが、 o を付けると出力のみ が入れ替わる[デフォルトでは両方入れ替わる]。 |
||
−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 (地理座標)の 省略形である。 |
後に続く描画を制限するための複雑なクリップ領域を設 定 す る 上 書 き 用 PostScript ファイルを作る。 psclip my_region.xy −R0/40/0/40 −Jm0.3i −O −K > clip_mask_on.ps 現在存在する描画ファイルのクリッピングを無効にする。 psclip −C −O >> complex_plot.ps |
psclip は南極や北極を含む多角形を扱うことができない。このような多角形は 2 つに分割して、それぞれに明示的に極が含まれるようにすると良い。 2 つの クリップ用の多角形が合わさって、期待される効果を得ることができる。 |
GMT(l), grdmask(l), psbasemap(l), psmask(l) |