matrixfile_convertコマンド マニュアル

(The documentation of matrixfile_convert command)

Last Update: 2022/3/25


◆機能・用途(Purpose)

行列のファイル形式を変換する。
Convert the file format of a matrix.


◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/matrix/src/matrixfile_convert.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
変換を行う行列のファイル名から拡張子を除いたもの。
The name of the matrix file to convert excluding the extension.
第2引数
2nd argument
変換前のファイル形式(拡張子)。
The file format (extension) before the conversion.
第3引数
3rd argument
変換後のファイル形式(拡張子)。
The file format (extension) after the conversion.


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

1つの「-」から始まる引数は自由な順番で指定できる。 「-」から始まらない引数の間に挿入しても良い。 相反する指定がなされた場合には後の指定が優先される。
Arguments beginning with a single “-” 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.

引数
Argument
動作
Behaviour
-o 下記「--overwrite=yes」と同じ。
Same as “--overwrite=yes” below.
-e 下記「--erase_old_file=yes」と同じ。
Same as “--erase_old_file=yes” below.


●「--パラメータ名=パラメータ値」の形式の引数 (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
overwrite 変換後のファイル(出力ファイル)と同名のファイルが既に存在する場合に 確認無しで上書きするか否か。
Whether to overwrite an existing file without warning or not if a file with the name same as the converted (output) file already exists.
  • yes
    確認無しで上書きする。
    Overwrite without warning.

  • no
    上書きしても良いかユーザに確認する。
    Consult the user whether to proceed (overwrite) or not.

no
erase_old_file 変換前のファイル(入力ファイル)を削除するか否か。
Whether to remove the input file used for the conversion or not.
  • yes
    削除する。
    Remove.

  • no
    削除しない。
    Do not remove.

no


◆動作(Behaviour)

行列のファイル形式を変換する。 入力ファイル名は第1引数の後に第2引数で指定した拡張子を付けた名前とし、 拡張子が示す形式で書かれているものと想定して読み込む(チェックは行われる)。 出力ファイル名は第1引数の後に第3引数で指定した拡張子を付けた名前とし、 拡張子が示す形式で出力される。
The file format of a matrix is converted. The input file name is the value of the 1st argument followed by the extension specified by the 2nd argument; the file format is assumed to be consistent with the extension (checks for this requirement are conducted). The output file name is the value of the 1st argument followed by the extension specified by the 3rd argument; the output data format is consistent with the extension.


◆使用例(Example)

matrixfile_convert data 3dm bdm -o -e

この例ではファイルdata.3dmをbdm形式に変換してdata.bdmという名前で出力する。 既にdata.bdmが存在した場合には確認無しで上書きする(-oオプション)。 変換後、data.3dmを自動的に削除する(-eオプション)。
In this example, a file data.3dm is converted to bdm format and written to data.bdm. If the output file data.bdm already exists, it is automatically overwritten without warning (-o option). After the conversion, data.3dm is automatically removed (-e option)


◆追加の情報(Additional information)

行列のファイル形式については 独自のファイル形式参照。
For the file formats of a matrix, see Special file formats.