Definition of “Column Vector Matrix” format

列ベクトル分解型ファイル仕様

(Definition of “Column Vector Matrix” format)

Last Update: 2021/6/28

拡張子(Extension)
cvm

拡張子の意味 (Meaning of the extension)
Column Vector Matrix

対象とする構造体の種類 (Supported structures)

struct matrix型 / struct matrix-type
struct columnvector型 / struct columnvector-type

データの保存形式 (Format of each data)
有効数字6桁の浮動小数点指数形式(%.6e)
Floating-point numbers in exponential formats with 6 decimals (%.6e)

特徴(Features)
行列を列ベクトルに分解してそれぞれを別々のファイルに書き出したディレクトリ。各列の中身を第1列から順に一定の時間間隔で図示するgnuplotのアニメーションスクリプトも合わせて出力される。行列サイズが大きい場合に、その各列の中身を1行ずつ見れる点がメリットである。反面、大きな行列ではファイルサイズが大きくなり易い。
A directory composed of separate files representing individual column vectors that constitute the matrix. A gnuplot script is also created to display the column vectors as an animation. The advantage of this format is to enable to look at the matrix contents column by column. The disadvantage is that the file size tends to become large.

仕様詳細(Detail)

ファイルではなくディレクトリとなる。その名前に「.cvm」の拡張子が付く。
Not a file but a directory, whose name ends with the extension “.cvm”.
ディレクトリ内にsize.dat,列番号.dat,gnuplot.comの3種類のファイルが出力される。但しgnuplot.comはstruct matrix型の場合のみ出力される。
In the directory, files size.dat, the column index.dat, and gnuplot.com are created. However, gnuplot.com is created only for struct matrix-type structure.
size.datは第1列に行列の行数、第2列に行列の列数を記した1行だけのファイル。
The file size.dat has only 1 line, consisting of the numbers of rows and columns in the 1st and 2nd columns, respectively.
列番号.datは各行の第1列に行番号、第2列に値を記載したファイル。並び順は行番号について昇順。
In the column index.dat, the row index is in the 1st column and the data is in the 2nd column, written in ascending order with respect to the row index.
gnuplot.comはgnuplotのアニメーションスクリプトで、これを呼び出せば第1行から順に列番号.datの中身が0.2秒間隔でプロットされる。
The file gnuplot.com is an animation script for gnuplot, by which the data in the column index.dat are shown in ascending order at an interval of 0.2 s.
各ファイルの各行における列の区切り文字としてはタブを使用する。
Tabs are used to separate the columns in each line of each file.

例(Example)
以下の2×3行列を考える。
Let us consider the 2×3 matrix given below:

\[\begin{pmatrix} 1 & 0.12 & 0.0345 \\ 6.7 & 8901 & 23.4 \end{pmatrix}\]
この行列を表現するためのディレクトリの中身は以下のようになる。ここではタブを分かりやすいように [TAB]で表す。
The directory contents to represent this matrix are as below, where tabs are shown by [TAB].

(size.dat)

2[TAB]3

(1.dat)

1[TAB]1.000000e+00
2[TAB]6.700000e+00

(2.dat)

1[TAB]1.200000e-01
2[TAB]8.901000e+03

(3.dat)

1[TAB]3.450000e-02
2[TAB]2.340000e+01

(gnuplot.dat)

set xrange [1:2]
set grid
set yrange [-8.901000e+03:8.901000e+03]
p "1.dat" u 1:2 w l
pause(0.2)
p "2.dat" u 1:2 w l
pause(0.2)
p "3.dat" u 1:2 w l
pause(0.2)

列ベクトル分解型 ファイル仕様

列ベクトル分解型ファイル仕様