Definition of “Row Vector Matrix” format

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

(Definition of “Row Vector Matrix” format)

Last Update: 2021/6/28

拡張子(Extension)
rvm

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

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

struct matrix型 / struct matrix-type
struct rowvector型 / struct rowvector-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 row vectors that constitute the matrix. A gnuplot script is also created to display the row vectors as an animation. The advantage of this format is to enable to look at the matrix contents row by row. The disadvantage is that the file size tends to become large.

仕様詳細(Detail)

ファイルではなくディレクトリとなる。その名前に「.rvm」の拡張子が付く。
Not a file but a directory, whose name ends with the extension “.rvm”.
ディレクトリ内にsize.dat,行番号.dat,gnuplot.comの3種類のファイルが出力される。但しgnuplot.comはstruct matrix型の場合のみ出力される。
In the directory, files size.dat, the row 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 row index.dat, the column index is in the 1st column and the data is in the 2nd column, written in ascending order with respect to the column index.
gnuplot.comはgnuplotのアニメーションスクリプトで、これを呼び出せば第1行から順に行番号.datの中身が0.2秒間隔でプロットされる。
The file gnuplot.com is an animation script for gnuplot, by which the data in the row 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]1.200000e-01
3[TAB]3.450000e-02

(2.dat)

1[TAB]6.700000e+00
2[TAB]8.901000e+03
3[TAB]2.340000e+01

(gnuplot.dat)

set xrange [1:3]
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)

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

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