GSIdem2latlonDataコマンドマニュアル

(The documentation of GSIdem2latlonData command)

Last Update: 2022/3/25

◆機能・用途(Purpose)

国土地理院の数値標高モデル(DEM)を緯度経度と標高の一覧表に変換する。
Convert a digital elevation model (DEM), provided by Geospatial Information Authority of Japan (GSI), to a table of longitudes, latitudes, and elevations.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/geography/src/GSIdem2latlonData.c

◆使用方法(Usage)

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

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

引数 Argument	与える値 Quantity to be given
第1引数 1st argument	国土地理院のホームページからダウンロードした DEMデータのxmlファイル。 An xml file of the DEM data downloaded from the website of GSI.
第2引数 2nd argument	出力ファイル名。拡張子は何でも良い。 The output file name. The extension is arbitrary.

●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”)

このコマンドでは「--パラメータ名=パラメータ値」の形式の引数存在しない。
This command does not have arguments of a form “--Parameter name=Parameter Value”.

◆動作(Behaviour)

第1引数で指定したファイルからDEMデータを読み込み、第2引数で指定したファイルに出力する。入出力ファイルのフォーマットは以下の通り。
A DEM data is read from the file specified by the 1st argument, and written into the file specified by the 2nd argument. The formats of the input and output files are described below.

●想定する入力ファイルフォーマット (Assumed input file format)

このプログラムでは入力ファイルとして国土地理院の基盤地図情報(数値標高モデル)からダウンロードした 5A, 5B, 5C, 10A, 10Bのいずれかのファイルを用いることを想定している。これらのファイルにおいて以下の条件が満たされることを想定している。
This program assumes the input file to be either 5A, 5B, 5C, 10A, or 10B files downloaded from the basis map information (digital elevation model) of GSI. The following requirements are assumed to be satisfied in these files.

一定間隔の緯度・経度ごとに与えられた格子状の標高データである。
The elevations are given on grid nodes deployed at constant intervals along the latitude and longitude.
ファイルには「<gml:lowerCorner>緯度経度</gml:lowerCorner>」と書かれた行が存在し、一番南西の格子点の緯度・経度を表す。
The file consists of a line written as “gml:lowerCorner> latitude longitude </gml:lowerCorner>”, which represents the latitude and longitude of the most south-west grid node.
ファイルには「<gml:upperCorner>緯度経度</gml:upperCorner>」と書かれた行が存在し、一番北東の格子点の1つ外側の格子点の緯度・経度を表す。
The file consists of a line written as “gml:upperCorner> latitude longitude </gml:upperCorner>”, which represents the latitude and longitude at by one grid outside of the most north-east grid node.
ファイルには「<gmt:low>整数1 整数2</gml:low>」と書かれた行が存在し、この整数1, 2がそれぞれ経度方向・緯度方向の最小の格子点番号を表す。
The file consists of a line written as “<gmt:low> integer1 integer2 </gml:low>”, where the integer1 and integer2 represent the lowest grid indices along longitude and latitude directions, respectively.
ファイルには「<gmt:high>整数1 整数2</gml:high>」と書かれた行が存在し、この整数1, 2がそれぞれ経度方向・緯度方向の最大の格子点番号を表す。
The file consists of a line written as “<gmt:high> integer1 integer2 </gml:high>”, where the integer1 and integer2 represent the highest grid indices along longitude and latitude directions, respectively.
ファイルには「<gml:tupleList>」と書かれた行が存在し、それ以降の行に標高が書かれている。標高は1行につき1つの格子点での値であり、登場順としては北から南へ向かうループの内側に西から東へ向かうループが入った入れ子構造である。標高を表す各行の書式は「データの種類,標高値(m)」である。
The file consists of a line written as “<gml:tupleList>”, followed by lines where the elevations are given. The elevation on each grid node is given in a line, with an order from north to south (outer loop) and from west to east (inner loop). In each line, the elevation is given in a format “data type,elevation (m)”.
標高の未定義値は「-9999.」で与えられている。
An undefined elevation is expressed with “-9999.”.

●出力ファイルフォーマット (Output file format)

出力ファイルには1行につき1つの格子点の緯度、経度、標高が書かれている。
Each line of the output file consists of the latitude, longitude, and elevation at a grid node.
各行の第1列が格子点の緯度を表し、「dd:mm:ss.ss」の書式である。ここでddは緯度の「度」(整数)、mmは緯度の「分」(整数)、 ss.ssは緯度の「秒」(小数点以下2桁の実数(∗))を表す。
The 1st column of each line represents the latitude of a grid node, with a format “dd:mm:ss.ss”. Here, dd represents the degree (an integer), mm does the minute (an integer), and ss.ss does the second (a real number with 2 digits in the decimal part (∗)).
各行の第2列が格子点の経度を表し、「ddd:mm:ss.ss」の書式である。ここでdddは経度の「度」(整数)、mmは経度の「分」(整数)、 ss.ssは経度の「秒」(小数点以下2桁の実数(∗))を表す。
The 2nd column of each line represents the longitude of a grid node, with a format “ddd:mm:ss.ss”. Here, ddd represents the degree (an integer), mm does the minute (an integer), and ss.ss does the second (a real number with 2 digits in the decimal part (∗)).
各行の第3列が格子点の標高を表す。小数点以下3桁(∗∗)の実数値(単位:m)で与えられる。
The 3rd column of each line represents the elevation on a grid node, given by a real number with 3 digits (∗∗) in the decimal part (in meter unit).
標高が未定義の格子点においては第3列に「undefined」と出力する。
On grid nodes where the elevation is undefined, the 3rd column is “undefined”.
列の区切りにはタブが用いられる。
Tabs are used to separate the columns.

(∗) 基盤地図情報のDEMでは10mメッシュと呼ばれるものが0.4秒刻み、 5mメッシュと呼ばれるものが0.2秒刻みであるので「秒」は小数点以下1桁で足りるが、将来より細かいメッシュのデータが登場した場合への拡張性を考えて小数点以下2桁としている。
(∗) As the mesh intervals of DEMs of the basis map information are 0.4 s for so-called “10-m mesh”, and 0.2 s for so-called “5-m mesh”, only one digit is enough for the decimal part of second. However, the two digits are used for the output to support finer mesh data that may become available in the future.

(∗∗) 標高についても現在は小数点以下2桁で与えられているが、将来3桁目まで提供されるようになった場合を想定して小数点以下3桁としている。
(∗∗) The elevation is given with two digits in the decimal part. However, three digits are used for the output to support a case where the three digits are given in the future.

◆使用例(Example)

GSIdem2latlonData FG-GML-5236-57-dem10a-20161001.xml 5236-57-latlon.dat

GSIdem2latlonDataコマンド マニュアル