latlon2xyコマンド マニュアル

(The documentation of latlon2xy command)
Last Update: 2023/4/24

◆機能・用途(Purpose)

緯度経度で与えられた座標を平面直角座標に変換する。 1地点の変換、および複数地点の一括変換ができる。
Convert the coordinate(s) given by the latitude and longitude to cartesian. The conversion of a single point and the simultaneous conversions of multiple points are supported.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/geography/src/latlon2xy.c


◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。 パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

このコマンドでは「-」から始まらない引数は存在しない。
This command does not have arguments not beginning with “-”.

●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。 デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.
パラメータ名
Parameter name 		意味
Meaning 		可能なパラメータ値
Allowed parameter values 		デフォルト値
Default value
N 変換したい地点の緯度(度単位または度:分:秒表記)。
The latitude (in degrees or degree:minute:second format) of the point to convert. 		-90.0以上+90.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -90.0 and less than or equal to +90.0, or its degree:minute:second representation. 		1地点の変換の場合は省略不可、 複数地点の一括変換の場合は用いられない。
Cannot be omitted for the conversion of a single point, while this parameter is not used for simultaneous conversions of multiple points.
E 変換したい地点の経度(度単位または度:分:秒表記)。
The longitude (in degrees or degree:minute:second format) of the point to convert. 		-180.0以上+180.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -180.0 and less than or equal to +180.0, or its degree:minute:second representation. 		1地点の変換の場合は省略不可、 複数地点の一括変換の場合は用いられない。
Cannot be omitted for the conversion of a single point, while this parameter is not used for simultaneous conversions of multiple points.
inputfile 入力ファイル名。
The input file name.
このファイルには1行につき1地点ずつ、変換したい地点の座標を書く。 第1列を緯度、第2列を経度、 第3列をその地点の情報を表す任意の文字列(名称や標高など)とする。 緯度経度は度単位の実数または度:分:秒表記とする。 列の区切りにはタブを使用する。 第3列には複数の情報をスペース区切りで書いても良いが、 タブを挿入して4列にしてはならない。 空行や#から後の部分はコメントとして無視される。
In this file, list the coordinates to convert; the 1st column represents the latitudes, 2nd does the longitudes, and 3rd does arbitrary string that represents the information of the point (e.g., name or altitude). Use real numbers in the degree unit or a degree:minute:second representation for the latitudes and longitudes. Use tabs to separate the columns. Multiple information separated by spaces can be written in the 3rd column; however, do not insert a tab that results in 4 columns. Empty lines and parts after # are ignored as comments.
また「>」から始まる行を自由な書式で挿入できる。 この行は座標データとは見なされず、そのまま出力ファイルにコピーされる。 Generic Mapping Toolsでのデータ区切りとしての使用を想定している。
Also, lines beginning with “>” can be inserted with arbitrary formats. These lines are not regarded as coordinate data, and copied to the output file without changes. These lines are assumed to be used to separate data sections for Generic Mapping Tools. 		ファイル名。
A file name. 		複数地点の一括変換の場合は省略不可、 1地点の変換の場合は用いられない。
Cannot be omitted for simultaneous conversions of multiple points, while this parameter is not used for the conversion of a single point.
outputfile 変換した座標リストの出力先ファイル名。
Name of the output file to which the list of coordinates converted will be written. 		ファイル名。
A file name. 		複数地点の一括変換の場合は省略不可、 1地点の変換の場合は用いられない。
Cannot be omitted for simultaneous conversions of multiple points, while this parameter is not used for the conversion of a single point.
refN 変換後の直交座標系において座標原点とすべき地点(基準点)の緯度 (度単位または度:分:秒表記)。
The latitude (in degrees or degree:minute:second format) of the point that should be the origin of the cartesian coordinate after the conversion (the reference point). 		-90.0以上+90.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -90.0 and less than or equal to +90.0, or its degree:minute:second representation. 		--zoneオプション未使用時は省略不可。
Cannot be omitted when --zone option is not used.
refE 変換後の直交座標系において座標原点とすべき地点(基準点)の経度 (度単位または度:分:秒表記)。
The longitude (in degrees or degree:minute:second format) of the point that should be the origin of the cartesian coordinate after the conversion (the reference point). 		-180.0以上+180.0以下の実数またはその度:分:秒表記。
A real number greater than or equal to -180.0 and less than or equal to +180.0, or its degree:minute:second representation. 		--zoneオプション未使用時は省略不可。
Cannot be omitted when --zone option is not used.
zone 変換後の直交座標系の系番号 ( 国土地理院の定義による)。 これを用いることで--refN, --refEオプションに代えることができる。
The zone ID of the cartesian coordinate system to use, based on the definition of Geospatial Information Authority of Japan (GSI). This option can be used instead of --refN and --refE options. 		refN, refEの組合せ番号を表す1-19の間の整数。 番号とrefN, refEの対応関係は 関数JapanCoordinateZone2refNEのマニュアル 参照。
An integer from 1 to 19 that represents an index for a combination of refN and refE. See the documentation of function JapanCoordinateZone2refNE for refN and refE corresponding to each index. 		--refN, --refEオプション未使用時は省略不可。
Cannot be omitted when --refN and --refE options are not used.


◆動作(Behaviour)

● --N, --Eオプションが指定された場合(1地点の変換) (When --N and --E options are specified; conversion of a single point)

--refN, --refEオプションで指定した地点の座標を(0,0)としたときの --N, --Eオプションで指定した地点の直交座標が標準出力に表示される。 この出力では第1列が\(x\)座標(東方向、m)、 第2列が\(y\)座標(北方向、m)であり、 区切り文字としてタブが用いられる。
The cartesian coordinate of the point specified by --N and --E options are displayed in the standard output, where (0,0) of the coordinate system refers to the point specified by --refN and --refE options. In this output, the 1st column indicates the \(x\)-coordinate (east, m) and the 2nd column does the \(y\)-coordinate (north, m); a tab is used to separate these values.

● --inputfile, --outputfileオプションが指定された場合(複数地点の一括変換) (When --inputfile and --outputfile options are specified; simultaneousconversions of multiple points)

--inputfileオプションで指定したファイルから読み込んだ座標が 直交座標に変換され、 --outputfileオプションで指定したファイルに出力される。 --refN, --refEオプションで指定した地点が出力ファイルにおける(0,0)となる。 この出力では第1列が\(x\)座標(東方向、m)、 第2列が\(y\)座標(北方向、m)であり、 第3列には入力ファイルの第3列と同じ文字列が出力される。 区切り文字としてタブが用いられる。
The coordinates given in the file specified by --inputfile option are converted to cartesian coordinates and written into the file specified by --outputfile option, where (0,0) in the output file refers to the point specified by --refN and --refE options. In the output file, the 1st column indicates the \(x\)-coordinate (east, m) the 2nd column does the \(y\)-coordinate (north, m), and the 3rd does the same string as the 3rd column of the input file. Tabs are used to separate these values.

● 上記以外の場合 (Other cases)

上記以外の場合や、 --N, --Eオプションと--inputfile, --outputfileオプションの 両方が指定された場合には プログラムをエラー終了する。
In the other cases, including cases where both --N and --E options and --inputfile and --outputfile options are specified, the program finishes as an error.

◆使用例(Example)

● 例1: 1地点の変換 (Example 1: conversion of a single point)

latlon2xy --N=35.98765 --E=137.87654 --refN=35.8928 --refE=137.4803


● 例2: 複数地点の一括変換 (Example 2: simultaneous conversions of multiple points)

latlon2xy --inputfile=latlon.dat --outputfile=xy.dat --refN=35.8928 --refE=137.4803

(latlon.dat)
# sample file
36.12345[TAB]138.23456[TAB]Station 1 (altitude = 1234 m)
36.34567[TAB]138.45678[TAB]Station 2 (altitude = 567 m)
36.56789[TAB]138.67890[TAB]Station 3 (altitude = 890 m)

ここで[TAB]はタブを表す。
Here, [TAB] indicates a tab.

● 例3: 系番号を用いる場合 (Example 3: using the zone ID)

latlon2xy --N=35.98765 --E=137.87654 --zone=8

この例は
latlon2xy --N=35.98765 --E=137.87654 --refN=36.0 --refE=138.5
と同じ。
This example is equivalent to:
latlon2xy --N=35.98765 --E=137.87654 --refN=36.0 --refE=138.5

● 例4: 度:分:秒表記を用いる場合 (Example 4: using a degree:minute:second representation)

latlon2xy --N=35:54:53.2 --E=137:43:32.1 --refN=35:53:34 --refE=137:28:49


◆使用上の注意 (Notes)

このプログラムでは火山地域で利用しやすいように \(x\)軸を東向き、\(y\)軸を上向きに取っている。 国土地理院で標準的に用いられている座標系 (\(X\)軸を北向き、\(Y\)軸を東向き)とは逆であるので留意すること。
Thid program assumes \(x\) and \(y\) to be east and north, respectively, for convenience of studies on volcanoes. Note that this is opposite from the standard coordinate system used by Geospatial Information Authority of Japan (GSI), in which \(X\) is taken north and \(Y\) is taken east.

◆追加の情報 (Additional information)