xy2latlonコマンド マニュアル

(The documentation of xy2latlon command)
Last Update: 2023/4/6

◆機能・用途(Purpose)

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

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/geography/src/xy2latlon.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
x 変換したい地点の\(x\)座標(基準点から東方向、m)。
The \(x\)-coordinate of the location convert; east (m) from the reference point. 		実数。
A real number. 		1地点の変換の場合は省略不可、 複数地点の一括変換の場合は用いられない。
Cannot be omitted for the conversion of a single point, while this parameter is not used for simultaneous conversions of multiple points.
y 変換したい地点の\(y\)座標(基準点から北方向、m)。
The \(y\)-coordinate of the location to convert; north (m) from the reference point. 		実数。
A real number. 		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列を\(x\)座標(基準点から東方向, m)、 第2列を\(y\)座標(基準点から北方向、m)、 第3列をその地点の情報を表す任意の文字列(名称や標高など)とする。 列の区切りにはタブを使用する。 第3列には複数の情報をスペース区切りで書いても良いが、 タブを挿入して4列にしてはならない。 空行や#から後の部分はコメントとして無視される。
In this file, list the coordinates to convert; the 1st column represents the \(x\)-coordinates (east (m) from the reference point), 2nd does \(y\) (north (m) from the reference point), and 3rd does arbitrary string that represents the information of the point (e.g., name or altitude). 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 変換の基準点の緯度(°)。 \((x,y)\)座標の原点となる。
The latitude (°) of the reference point, used as the origin of the \((x,y)\) coordinates. 		-90.0以上+90.0以下の実数。
A real number greater than or equal to -90.0 and less than or equal to +90.0. 		--zoneオプション未使用時は省略不可。
Cannot be omitted when --zone option is not used.
refE 変換の基準点の経度(°)。 \((x,y)\)座標の原点となる。
The longitude (°) of the reference point, used as the origin of the \((x,y)\) coordinates. 		-180.0以上+180.0以下の実数。
A real number greater than or equal to -180.0 and less than or equal to +180.0. 		--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)

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

\((x,y)\)を--refN, --refEオプションで指定した基準点からの相対位置と見なして 対応する地点の緯度経度を標準出力に表示する。 この出力では第1列が北緯(°)、第2列が東経(°)であり、 区切り文字としてタブが用いられる。
The latitude and longitude of the point specified by --x and --y options are displayed in the standard output, regarding \((x,y)\) as the relative location from the reference point specified by --refN and --refE options. In this output, the 1st column indicates the north latitude (°), and the 2nd column does the east longitude (°).

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

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

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

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

◆使用例(Example)

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

xy2latlon --x=1234.5678 --y=-901.2345 --refN=35.8928 --refE=137.4803


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

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

(latlon.dat)
# sample file
1234.5678[TAB]2345.6789[TAB]Station 1 (altitude = 1234 m)
-3456.7890[TAB]4567.8901[TAB]Station 2 (altitude = 567 m)
5678.9012[TAB]-6789.0123[TAB]Station 3 (altitude = 890 m)

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

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

xy2latlon --x=-987.6543 --y=210.9876 --zone=8

この例は
xy2latlon --x=-987.6543 --y=210.9876 --refN=36.0 --refE=138.5
と同じ。
This example is equivalent to:
xy2latlon --x=-987.6543 --y=210.9876 --refN=36.0 --refE=138.5

◆使用上の注意 (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)