winfile_list_channelCodesコマンド マニュアル

(The documentation of winfile_list_channelCodes command)
Last Update: 2023/11/29

◆機能・用途(Purpose)

WIN形式の波形データファイルに含まれるチャンネルを 漏れなく重複なくリストアップする。
List all channels in a waveform data file of WIN format without missing nor duplication.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/win_data/src/winfile_list_channelCodes.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 		WIN形式の波形データファイル名。
The name of a waveform data file of WIN 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
channelTableFile チャネル表ファイル名。 このパラメータを指定した場合、チャンネルコードに加えて 対応する観測点・成分コードも表示される。
The name of a channel table file. Specifying this parameter results in displaying the station and component codes for each channel in addition to the channel code. 		ファイル名を表す文字列(パスを含む)。
A string that represents a file name (including its path). 		省略時はチャンネルコードのみが表示される。
When this parameter is omitted, only the channel codes are displayed.


◆動作(Behaviour)

第1引数で指定した波形データファイルに含まれる全てのチャンネルコードを 標準出力に表示する。
Display all channel codes included in the waveform data in the file specified by the 1st argument into the standard output.

◆使用例(Example)

winfile_list_channelCodes data.win


◆補足(Additional notes)

●wckコマンドとの違い (Difference with wck command)

WIN形式の波形データファイルに含まれるチャンネルコードは WINシステムのwchコマンドを用いて表示することもできる。 しかしこの場合、最初の1秒ブロックに含まれないチャンネルは表示されない。 それに対し、winfile_list_channelCodesコマンドを用いると 波形データのいずれかの時刻に含まれる全てのチャンネルが表示される。
The channel codes included in a waveform data file of WIN format can be displayed using the wch command of the WIN system. In this case, however, channels that are not in the first 1-s block are missed. On the contrary, the winfile_list_channelCodes command displays all channels that exist in either time of the waveform data.

●チャンネルコードのリストをbashの変数に代入する場合 (Substituting the channel code list into a variable in bash)

チャンネルコードに加えて WINファイルの読み込みの進行状況が表示されることに留意する。 進行状況は標準エラー出力に表示されるので、 チャンネルコードのリストをbashの変数に代入する場合は 下の例のように標準エラー出力を読み捨てれば良い。
In addition to the channel codes, the progress of reading the WIN file is displayed. Because the progress is displayed into a standard error, only the channel codes (without the progress message texts) can be substituted into a bash variable by ignoring the standard error, as the example below shows.
channelCodes=‘winfile_list_channelCodes data.win 2> /dev/null‘