Definition of “3 Dimensional Z-divided data” format”

3次元データz分割型ファイル仕様

(Definition of “3 Dimensional Z-divided data” format)

Last Update: 2021/6/28

拡張子(Extension)
3dz

拡張子の意味 (Meaning of the extension)
3 Dimensional Z-divided data

対象とするデータと構造体 (Supported data and structures)
3次元データ(struct _3d_data型)
A 3-D data given by struct _3d_data-type

データの保存形式 (Format of each data)
断面ごとの行列(3db形式)から成るディレクトリ。
A directory composed of matrices (3db format) for individual sections.

特徴(Characteristics)
データを

z

の値ごとに分割して別々の行列ファイルとして出力したディレクトリ。

z

軸に直交する平面内での空間分布を見るのに適している。
A directory composed of files for matrices, each of which represent the data on a section of each

z

value. This format is suited to look at the spatial distribution of data on a plane orthogonal to

z

-axis.

仕様詳細(Detail)

ファイルではなくディレクトリとなる。その名前に「.3dz」の拡張子が付く。
Not a file but a directory, whose name ends with the extension “.3dz”.
ディレクトリ内に「header.txt」および「断面番号.3db」のファイルが出力される。 断面番号は0から始まる連番とする。
The directory consists of “header.txt” and “the index of section.3db”, where the index of section is a sequential number starting from zero.
「header.txt」の中身は以下の通り。
The format of “header.txt” is as follows.
- 第1行: $x$ , $y$ , $z$ 方向の格子点数(タブ区切り)。
  Line 1: The numbers of grid nodes in $x$ -, $y$ -, and $z$ -directions, separated by tabs.
- 第2行: $x$ , $y$ , $z$ 方向の座標の初期値(タブ区切り)。
  Line 2: The initial values of $x$ -, $y$ -, and $z$ -coordinates, separated by tabs.
- 第3行: $x$ , $y$ , $z$ 方向の座標の増分(タブ区切り)。
  Line 3: The increments of $x$ -, $y$ -, and $z$ -coordinates, separated by tabs.
$z$ の初期値を $z_{0}$ 、増分を $Δ z$ とするとき、「 $k$ .3db」( $k$ :断面番号)には $z = z_{0} + k Δ z$ の断面でのデータが行列として出力される。この行列は $x$ 方向の格子点番号が行方向、 $y$ 方向の格子点番号が列方向となるように作成される。
Let $z_{0}$ and $D e l t a z$ be the initial value and increment of $z$ -coordinate, respectively. Then the file “ $k$ .3db”, where $k$ is the index of section, consists of data on a section $z = z_{0} + k Δ z$ as a matrix form. In this matrix, the grid node indices in $x$ - and $y$ -directions are oriented to the raw and column directions, respectively.

例(Example)

$x$ 方向の格子点座標: 0.1, 0.3, 0.5
$y$ 方向の格子点座標: -1.0, -0.5, 0.0
$z$ 方向の格子点座標: 12.3, 12.0, 11.7, 11.4
各格子点での値: $x + y + z$

の3次元データを考える。これを表現するためのファイルの中身は以下のようになる。ここではタブを分かりやすいように [TAB]で表す。
Let us consider the 3-D data below:

$x$ -coordinates of the grid nodes: 0.1, 0.3, 0.5
$y$ -coordinates of the grid nodes: -1.0, -0.5, 0.0
$z$ -coordinates of the grid nodes: 12.3, 12.0, 11.7, 11.4
Values of each grid node: $x + y + z$

The file to represent this data is as follows, where tabs are shown by [TAB].

header.txt

3[TAB]3[TAB]4
0.1[TAB]-1.0[TAB]12.3
0.2[TAB]0.5[TAB]-0.3
0.bdmが表す行列 (The matrix represented by 0.bdm)
$(\begin{matrix} 11.4 & 11.9 & 12.4 \\ 11.6 & 12.1 & 12.6 \\ 11.8 & 12.3 & 12.8 \end{matrix})$
1.bdmが表す行列 (The matrix represented by 1.bdm)
$(\begin{matrix} 11.1 & 11.6 & 12.1 \\ 11.3 & 11.8 & 12.3 \\ 11.5 & 12.0 & 12.5 \end{matrix})$
2.bdmが表す行列 (The matrix represented by 2.bdm)
$(\begin{matrix} 10.8 & 11.3 & 11.8 \\ 11.0 & 11.5 & 12.0 \\ 11.2 & 11.7 & 12.2 \end{matrix})$
3.bdmが表す行列 (The matrix represented by 3.bdm)
$(\begin{matrix} 10.5 & 11.0 & 11.5 \\ 10.7 & 11.2 & 11.7 \\ 10.9 & 11.4 & 11.9 \end{matrix})$

3次元データz分割型 ファイル仕様

3次元データz分割型ファイル仕様