名前

       psclip - 多角形のクリップパスをセットアップします


概要

       psclip  xyfiles  -Jparameters -Rwest/east/south/north[r] [
-Btickinfo ] [ -Eaz/el ] [ -K ] [ -N ] [ -M[flag] ] [ -O ]
[ -P ] [ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy- shift ] [ -Zzlevel ] [ -ccopies ] [ -: ] [ -bi[s][n] ]

psclip -C [ -K ] [ -O ]


記述

       psclip は (x,y) ファイル[または標準入力]を読んでクリッピン
グパスとして機能する多角形を描きます。複数のファイルを読ん
で複数の接続していないセグメントからなる複雑なパスを作成す
ることもできます。オプションとして(-N)、パスの内側と外側の
定義を逆にすることができます。これらのパスによりクリップさ
れた一連のプロットの後、 psclip をもう一度 -C オプションだ
けを付けて実行することにより、クリップを無効にすることがで
きます。

xyfiles
クリップ用の多角形に対する (x,y) の値を持つアスキー
[またはバイナリ、-b参照]ファイル。ファイルが与えられ
ていないときは標準入力から読み込まれます。

-C 存在するクリップパスを終了させます。入力ファイルや投
影情報は不要です。

-J マップの投影法を選択します。スケールは UNIT/degree 、
1:xxxxx 、または UNIT 単位の幅 (オプションを大文字に
する) で指定します。 UNIT は .gmtdefaults で設定した
 MEASURE_UNIT に依存して cm 、 inch 、または m になり
ますが、 c 、 i 、または m を scale/width の値に付け
加えることによりコマンドラインで変更することができます。

円筒図法:

-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] (極 (theta,r) 座標、
随意で a を付け方向、オフセットの角度を設定 [0])
-Jxx-scale[l|ppow][/y-scale[l|ppow]] (線形、対数、
指数スケーリング)
詳細は psbasemap のマニュアルページにあります。

-R west, east, south, north は興味のある領域を特定し
ます。度と分[と秒]で境界を特定するには、dd:mm[:ss]
のフォーマットを使ってください。wesnの代わりに左下
と右上のマップ座標を使うときは r を付け加えてくださ
い。


オプション

       オプションフラッグとそれに付属する記述の間にスペースを入れ
てはいけません。


-B マップの縁のティックマークを設定します。詳細は
 psbasemap を参照してください。

-E 視点の方位角と高度を設定します[デフォルトは180/90]。

-H 入力ファイルにヘッダレコードがあります。ヘッダレコ
ードの数は .gmtdefaults ファイルを編集することによ
り変更できます。このオプションが使われた場合、 GMT
のデフォルトではヘッダレコードは1行です。

-K さらに PostScript コードが後に続きます[デフォルトで
はプロットシステムを終了します]。

-M 複数のセグメントからなるファイルであることを意味し
ます。セグメントは <flag> で始まるレコードで区切ら
れています[デフォルトは '>' です]。

-N パスの内側と外側の定義を逆にすることができます。すな
わち、クリッピングには多角形の外側が使われます。

-O 上書きプロットモードを選択します[デフォルトでは新
しいプロットシステムに初期化します]。

-P ポートレート描画モードを選択します[GMTのデフォルト
はランドスケープです。これを変更するには
 gmtdefaults を参照してください]。

-U 図に Unix システムのタイムスタンプを入れます。図の
左下隅に対するスタンプの左下隅の位置を決めることが
できます。随意でラベル、または c (コマンド文字列を
プロットします。)を付け加えることができます。 GMT
のパラメータ UNIX_TIME と UNIX_TIME_POS は外見に影
響を及ぼします; 詳細は gmtdefaults のマニュアルペ
ージを参照してください。

-V 冗長モードを選択します。標準エラー出力に経過報告を
送ります[デフォルトでは"静かに"走ります]。

-X -Y 図の原点を (x-shift,y-shift) だけ動かします。値の
前に a を付けると絶対座標を表します; デフォルト
 (r) で図の原点が元に戻ります。

-Z 3-Dマップ用のオプションです: ベースマップのzの基準を
設定します[0]。

-: 入出力の(経度,緯度)と(緯度,経度)を入れ替えます。[デ
フォルトは(経度,緯度)です]。地理座標のみに適用されま
す。

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

-bi バイナリ入力を選択します。単精度に対しては s を付け
加えます[デフォルトは倍精度です]。バイナリファイルの
列数に応じて n を付け加えてください[デフォルトは2列で
す]。


用例

       後に続くプロットを制限する複雑なクリップ領域を設定する上書き
 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)



1 May 2003 PSCLIP(l)

Man(1) output converted with man2html