selectChannelTable_timeコマンドマニュアル

(The documentation of selectChannelTable_time command)

Last Update: 2022/3/25

◆機能・用途(Purpose)

有効期間入りのチャンネルテーブル(ymaeda_opentools拡張)を元に指定した日時範囲において有効なチャンネルテーブルを作成する。
Create a channel table that is effective in a specified time period from a channel table that consists of effective periods (an extension of ymaeda_opentools).

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/win_data/src/selectChannelTable_time.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	読み込むチャンネルテーブルファイル名。有効期間が書かれたymaeda_opentools拡張形式 ( WINファイルのデータフォーマット参照) を用いる。 The name of the channel table file to read, in which effective periods are written (an extension of ymaeda_opentools; see The data format of a WIN file).
第2引数 2nd argument	出力するチャンネルテーブルファイル名。第1引数で指定したチャンネルテーブルから指定した期間において有効な行のみを抜き出し、標準フォーマットに変換(有効期間の情報を削除) したデータが出力される。 The output channel table file name. Data written into this file are selected information of the channel table from the 1st argument; only lines that are effective in a specified period are written, and the information of the effective period is removed to make the file the standard format.

●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
start	対象とする期間の先頭。 The beginning of the time period to extract.	「YYYY/MM/DD_hh:mm:ss」形式の文字列。ここでYYYYは年(西暦4桁)、MMは月(2桁)、DDは日(2桁)、 hhは時(2桁)、mmは分(2桁)、ssは秒(2桁)で、値が1桁のときは頭に0を付けて2桁にする。 A string of a format “YYYY/MM/DD_hh:mm:ss”, where YYYY is year (4-digits in AD), MM is month (2-digits), DD is day (2-digits), hh is hour (2-digits), mm is minute (2-digits), and ss is second (2-digits); 0 is appended for 1-digit numbers (0-9).	省略不可 Cannot be omitted
end	対象とする期間の末尾。 The end of the time period to extract.	「YYYY/MM/DD_hh:mm:ss」形式の文字列。ここでYYYYは年(西暦4桁)、MMは月(2桁)、DDは日(2桁)、 hhは時(2桁)、mmは分(2桁)、ssは秒(2桁)で、値が1桁のときは頭に0を付けて2桁にする。 A string of a format “YYYY/MM/DD_hh:mm:ss”, where YYYY is year (4-digits in AD), MM is month (2-digits), DD is day (2-digits), hh is hour (2-digits), mm is minute (2-digits), and ss is second (2-digits); 0 is appended for 1-digit numbers (0-9).	省略不可 Cannot be omitted

◆動作(Behaviour)

第1引数で指定したチャンネルテーブルファイルを元に、パラメータstart, endで指定した期間に有効な行を抜き出し、標準フォーマット(有効期間情報無し)に変更したチャンネルテーブルを第2引数で指定したファイル名で出力する。
From the channel table file specified by the 1st argument, lines that are effective in the period specified by parameters start and end, the format is changed to that of the standard channel table (i.e., not including the effective period), and the result is written into the file specified by the 2nd argument.

◆使用例(Example)

selectChannelTable_time channels.tbl.original channels.tbl.selected --start=2022/03/22_08:00:00 --end=2022/03/22_09:00:00

(channels.tbl.original)

# NU.NGY1 (-2022/03/20 12:00:00)
9991 1 0 NU.NGY1 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15490 136.96912 56 0 0 --end=2022/03/20_12:00:00
9992 1 0 NU.NGY1 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15490 136.96912 56 0 0 --end=2022/03/20_12:00:00
9993 1 0 NU.NGY1 E 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15490 136.96912 56 0 0 --end=2022/03/20_12:00:00

# NU.NGY1 (2022/03/20 13:00:00-)
9991 1 0 NU.NGY1 U 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0 --start=2022/03/20_13:00:00
9992 1 0 NU.NGY1 N 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0 --start=2022/03/20_13:00:00
9993 1 0 NU.NGY1 E 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0 --start=2022/03/20_13:00:00

# NU.NGY2
999A 1 0 NU.NGY2 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0
999B 1 0 NU.NGY2 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0
999C 1 0 NU.NGY2 E 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0

この例ではファイルchanels.tbl.originalから 2022/03/22 08:00:00 - 2022/03/22 09:00:00 の期間に有効な行が抽出され、ファイルchannels.tbl.selectedに標準フォーマット(有効期間情報無し)で出力される。結果は以下のようになる。
In this file, lines that are effective during 2022/03/22 08:00:00 - 2022/03/22 09:00:00 are extracted from the file channels.tbl.original, and the result is written into the file channels.tbl.selected with the standard format (i.e., no information for the effective period). The result is as below.

(channels.tbl.selected)

9991 1 0 NU.NGY1 U 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0
9992 1 0 NU.NGY1 N 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0
9993 1 0 NU.NGY1 E 6 24 400 m/s 1.0 0.7 0 5.961e-07 35.15490 136.96912 56 0 0
999A 1 0 NU.NGY2 U 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0
999B 1 0 NU.NGY2 N 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0
999C 1 0 NU.NGY2 E 7 24 800 m/s 1.0 0.7 20 2.4445e-06 35.15503 136.96908 56 0 0

selectChannelTable_timeコマンド マニュアル