名前

       psmask - マップ上のデータのない範囲をクリップすなわちマスク
します


概要

       psmask    [xyzfile]    -Idx[m|c][/dy[m|c]]    -Jparameters
       -Rwest/east/south/north[r] [ -Btickinfo ] [ -Ddumpfile ] [
-Eazimuth/elevation ] [ -F ] [ -Gfill ] [ -H[nrec] ] [ -K ] [ -M[flag] ] [ -N ] [ -O ] [ -P ] [ -Sradius[k] ] [ -T ]
[ -U[/dx/dy/][label] ] [ -V ] [ -Xx-shift ] [ -Yy-shift ]
[ -ccopies ] [ -: ] [ -bi[s][n] ]

psmask -C [ -K ] [ -O ]


記述

       psmask は (x,y,z) ファイル[または標準入力]を読み取り、この
情報を用いて有効なグリッドセルを探します。1つ以上のデータを
 含むグリッドセルだけが有効であると見なされます。オプション
として、影響の及ぶ半径を指定することができます。その場合、
 データ点から半径 radius 以内にあるすべてのグリッドセルが有
効であると見なされます。さらに、オプションによりこれとは逆
のセンスにすることができます。有効または無効な点を探しなが
ら、 psmask はこれらのノードをマスクするタイルを描く(-T
用いて)か、興味の対象でない領域をクリップするような多角形の
輪郭を作成します。クリッピングを開始したときは、もう一度
 psmask-C オプション付きで呼び出すまでその効果が継続し
ます。

xyzfile (x,y,z)の値を持つファイルです(例えば、 surface を実
行するのに使われたものです)。ファイルが与えられてい
ないときは、標準入力を読み取ります。バイナリファイル
の場合は -b を参照してください。

-I x_inc [および随意で y_inc] はグリッド間隔です。分
を示すには m を、秒を示すには 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 を参照してください。

-C 存在するクリップパスを終了させます。入力ファイルや投
影情報は不要です。 必ず -O を設定しなければなりませ
ん。

-D クリップのために作成された多角形をディスクに落としま
す。 -T が設定されているときは無視されます。ダンプ
ファイルの接頭辞がないときは mask が用いられます(ファ
イルは mask_*.d という名前になります)。

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

-F ブロックの中心をピクセルレジストレーションにします
 [デフォルト: グリッドレジストレーション]。

-G クリップ用の多角形[またはタイル]を選択した色で塗りつ
ぶします[デフォルトでは塗りつぶしません]。グレースケ
ール(0-255)またはカラー(r/g/b、それぞれ0-255で)を選
択します。

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

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

-M 複数のセグメントからなるファイルであることを意味し
ます。セグメントは特別なレコードで区切ら
れています。アスキーファイルでは最初の文字は flag
 [デフォルトは '>' ]でなければなりません。バイナリ
ファイルではすべてのフィールドが NaN でなければなり
ません。

-N テストの意味を逆にします。すなわち、データがある範
囲がクリップ領域になります。

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

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

-S 影響半径を設定します。データ点から半径 radius 以内の
グリッドノードが有効であると見なされます[デフォルト
では0であり、これはデータを含むグリッドセルのみが有
効であることを意味します]。 k を付けると km の意味に
なり、また -R-I の単位が度であることを示します。

-T 多角形のクリップパスの代わりにタイルをプロットします
(-Jx, -Jj, -Jm, -Jq, -Jyを指定したときだけ利用でき
ます)。

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

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

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

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

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

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

用例

       多角形のクリップパスを用いてコンター図の支配データがない領
域をマスクするオーバレイ PostScript ファイルを作成します。

psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -O -K >
mask.ps

同じ例で今度はタイルを使います。

psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -T -O -K > mask.ps

関連事項

       gmt(l), grdmask(l), surface(l), psbasemap(l), psclip(l)



1 May 2003 PSMASK(l)

Man(1) output converted with man2html