pscoast: 陸域、水域、海岸線、行政境界、河川を描画するgmtコマンド

2018-01-312023-05-10

pscoast − 陸域、水域、海岸線、行政境界、河川を描画するコマンド

書式

pscoast −Jparameters −Rwest/east/south/north[r] [ −Amin_area[/min_level/max_level] ] [ −B[p|s]parameters ] [ −Cfill ] [ −Dresolution ] [ −Eazimuth/elevation ] [ −Gfill ] [ −Iriver[/pen] ] [ −Jz|Zparameters ] [ −K ] [ −L[f][x]lon0/lat0[/slon]/slat/length[m|n|k][:label:just][+ppen][+ffill] ] ] [ −O ] [ −M[flag] ] [ −Nborder[/pen] ] [ −O ] [ −P ] [ −Q ] [ −Sfill ] [ −T[f|m][x]lon0/lat0/size[/info][:w,e,s,n:][+gint[/mint]] ] [ −U[/dx/dy/][label] ] [ −V ] [ −Wpen ] [ −X[a|c|r][x-shift[u]] ] [ −Y[a|c|r][y-shift[u]] ] [ −Zzlevel ] [ −ccopies ] [ −bo[s|S|d|D][ncol] ]
［　］はオプション

　pscoast はグレースケール、カラー、模様付きの陸域[又は水域]を地図上に描いたり、 [随意で]海岸線、河川、行政上の境界を引いたりする。また、全ての陸域又は水域を含むようなクリップパスを作ったりそのデータをアスキーテーブルにダンプしたりすることも可能。データファイルには高解像度から低解像度に向かって５つの異なる解像度（ (f)ull, (h)igh, (i)ntermediate, (l)ow, (c)rude ）がある。陸域だけを描いて水域について何も指定しないときは水域は透明になる (すなわち前にその領域に描かれた図は上書きされない)。同様に、水域が描かれていて陸域について何も指定が無いときは陸域は透明になる。PostScript コードは標準出力に書き出される。オプションフラグとそれに付属する引き数の間にスペースを入れない。またオプションフラグには大文字を使い、その付属コードには小文字を使う。

−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 west, east, south, 及び north は対象とする領域の範囲を指定する。小数値を含む度又は [+-]dd:mm[:ss.xxx][W|E|S|N] のフォーマットでその範囲を指定可能。東西南北の代わりに地図座標の左下と右上を使うときは r を付ける。 2 つの略号 −Rg −Rd は全球領域(それぞれ経度 0/360 又は -180/+180 と緯度 -90/+90 )を表す。

オプション

−A min_area (km^2) より狭い面積の部分や、階層的にmin_level より低いレベル又は max_level より高いレベルを描画しないオプション。

−B 地図の枠の目盛ならびにケバの間隔を設定する。詳細は psbasemap の man ページを参照。

−C 湖の色をグレースケール(0−255) 、カラー(rgb) 又は模様p|Pdpi/pattern; −G 参照)に設定する [デフォルトでは「ウェット」な領域 (−S；後述) で指定された方法]。

−D 用いるデータセットの解像度((f)ull, (h)igh, (i)ntermediate, (l)ow, (c)rude )を選択するオプション。データセットを1段階落すと解像度は80%下がる[デフォルトは l ]。

−E (遠近図法用の)視点の方位角と仰角を設定する[デフォルトは180/90 ]。

−G 「ドライ（陸域）」な領域の塗りつぶし又はクリッピングを選択する。グレースケール、カラー、模様の記号又はクリッピング用の記号c を付けること。グレースケール (0−255)、カラー(rgb, それぞれ範囲は 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 = – とすればよい)。

−I 河川を描画する。河川の種類と[随意で]ペン属性を指定すること [デフォルトのペン属性は width = 1, color = 0/0/0, texture = solid ]。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 はダッシュ ‘-’ と点 ‘.’ の組合せである。以下の河川の種類から選択ができる。必要なだけオプション−I を繰り返す必要がある。
1 = 恒久的大河川
2 = その他大河川
3 = その他中河川
4 = 小河川
5 = 間欠的大河川
6 = 間欠的中河川
7 = 間欠的小河川
8 = 大運河
9 = 小運河
10 = 灌漑用運河
a = 全ての河川ならびに運河 (1-10)
r = 全ての恒久的河川 (1-4)
i = 全ての間欠的河川 (5-7)
c = 全ての運河 (8-10)

−Jz 鉛直方向のスケールを設定するオプション (3次元地図用)。設定方法は −Jx と同じ。

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

−L lon0/lat0 を中心とする位置に簡単な地図スケールを描画する。代わりに −Lx を使うと x/y の位置で設定できる。スケールは緯度 slat で計算され(斜め投影のために随意で経度 slon を与えることもできる[デフォルトは中心子午線])、 length は km 単位である[ m を付けるとマイル、 n を付けると海里になる]。「装飾された」スケールを描くには −Lf を使うこと[デフォルトは簡素なスケール]。デフォルトのラベルは距離の単位( km 、マイル、海里)と等しくスケールの上端 [t] に配置される。独自のラベル(あるいは – でデフォルトを維持)と配置( l (左端)、 r (右端)、 t (上端)、 b (下端)、 u (単位) – スケールに沿った全ての位置の目盛へ付加された単位としてラベルを用いる) を与えることによりこれを変えることができる。スケールの後ろに長方形を置きたいときは、 +p と +f によりペン属性や塗りつぶしのパラメータを指定すること。

−M 複数セグメントを含む単一のアスキー(又はバイナリ、−bo参照) ファイルを標準出力にダンプする。描画は行わない。 −W, −I, −N のいずれかの組合せを指定すること。随意で各セグメントヘッダの先頭に flag [’>’] という文字列を入れることができる。

−N 行政上の境界を描く。境界の種類と[随意で]ペン属性を指定できる[デフォルトは幅 = 1 、色 = 黒、テクスチャ = 実線]。 pen (ペン属性)はコンマで区切られた width, color, texture のリストで、それぞれはオプションである。 width (幅)は長さの単位(ポイント、センチメートル、インチ)又は faint, thin[ner|nest], thick[er|est], fat[ter|test], obese のいずれかで指定することができる。 color ( 色)はグレースケール (0−255) 又はカラー (rgb, それぞれ範囲は 0−255; h-s-v, 範囲は 0−360, 0−1, 0−1; c/m/y/k, それぞれ範囲は 0−100%; 有効なカラー名) により指定できる。 texture (テクスチャ) はダッシュ ‘-’ と点 ‘.’ の組合せである。
以下の境界のリストから選ぶこと。必要なだけオプション −N を繰り返すこと。
1 = 国境
2 = 米国の州の境界
3 = 海上国境
a = 全ての境界 (1-3)
−O 上書き描画モードを選択する [デフォルトでは新しい描画システムに初期化する]。

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

−Q 存在するクリップパスを終了する。投影情報は不要である。

−S 「ウェット」な領域の塗りつぶし又はクリッピングを選択する。グレースケール (0−255) 、カラー (r/g/b) 、模様( −G 参照)の記号又はクリッピング用の記号 c を付けること。

−T lon0/lat0 を中心とする簡素な方位円盤を描く。 x/y の位置を指定するには −Tx を使うこと。 size は円盤の直径であり、オプションのラベル情報を指定してデフォルトの W, E, S, N の値へ上書きすることもできる (全てのラベルを消すには :: を与えること)。デフォルトの[簡素な]円盤では北のみ表示される。「装飾された」円盤を表示するためには−Tf を用い、描きたい円盤のkind (種類)を指定する。デフォルト [1] では 2つの主要な E-W, N-S方向が描かれ、 2にした場合、中間の2つの NW-SE と NE-SW の方向が追加され、 3 にした場合、主要でないWNW-ESE, NNW-SSE, NNE-SSW, ENE-WSW を加えた 8つの方向が描かれる。羅針盤のような円盤を描くには−Tm を指定する。このときの info は dec/dlabel でなければならない。ここでdec は磁気偏角、 dlabel は羅針盤の針に付けるラベルである (dec をラベルに使うためには ’-’ を指定すること)。このとき地理的な北と磁北の両方が表示される[デフォルトでは地理的な北のみ]。北のラベルを*にすると北のラベルの代わりに北極星が描かれる。地理方位と磁気方位の目盛と 2 つのレベルのケバの間隔はそれぞれ 10/5/1 度と 30/5/1 度になる。 +gints[/mints] を付けることにでこれらの設定を上書き可能。色とペン属性はCOLOR_BACKGROUND と TICK_PEN にそれぞれ依存しており、ラベルのフォントとサイズは通常の目盛、ラベル、ヘッダフォントの設定に準拠する。

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

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

−W 海岸線を描く[デフォルトでは描かない]。ペン属性を設定すること [デフォルト: 幅 = 1, 色 = 0/0/0, テクスチャ = 実線]。

−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]。

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

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