Definition of “3 Dimensional Selected data” format”

3次元選択データ型ファイル仕様

(Definition of “3 Dimensional Selected data” format)

Last Update: 2021/6/28

拡張子(Extension)
3ds

拡張子の意味 (Meaning of the extension)
3 Dimensional Selected data

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

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

特徴(Characteristics)
ヘッダ(格子点数、座標の初期値、増分)と各格子点の座標およびデータの値を書いたテキストファイルである。座標とデータ値の対応関係が分かりやすいのが長所である。データ値がノンゼロの要素のみを記載することにより、ゼロが多いデータにおいてファイルサイズが小さくなる。
A text file composed of headers (the numbers of grid nodes, initial values and increments of coordinates) followed by the coordinate and data value of each grid node. Using this format, it is easy to relate the coordinate and data value of each grid node. Only the components with non-zero data values are written, by which the file size becomes small for data with many zeroes.

仕様詳細(Detail)

第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.
第4行: 文字列「===」
Line 4: A string “===”.
第5行以降: 各格子点での座標とデータ値の組。第1列に\(x\)座標、第2列に\(y\)座標、第3列に\(z\)座標、第4列に値を記載する。
Lines 5 and later: The coordinate and data value of each grid node; \(x\)-, \(y\)-, and \(z\)-coordinates are in 1st to 3rd columns, respectively, and the data value is in the 4th column.
データの値が0の要素は省略される。
Components for which the data value is zero are omitted.
データの順番は自由である。
There is no restriction for the order of data.
同じ格子点での値が複数回書かれている場合には最後の値が用いられる。
If the value of same grid node appears twice or more, the final value is used.
各行における列の区切り文字としてはタブを使用する。
Tabs are used to separate the columns in each line.

例(Example)

\(x\)方向の格子点座標: \(-500.0,-499.0,-498.0,\cdots,499.0\)
\(y\)方向の格子点座標: \(-400.0,-399.5,-399.0,\cdots,599.5\)
\(z\)方向の格子点座標: \(-300.0,-299.8,-299.6,\cdots,299.8\)

で定義された3次元データを考える。これは\(1000\times 2000\times 3000\)個の格子点を持つ大きなデータであるが、以下の値のみがノンゼロであるとする。
Let the data be defined at the following grid nodes:

\(x\)-coordinates: \(-500.0,-499.0,-498.0,\cdots,499.0\)
\(y\)-coordinates: \(-400.0,-399.5,-399.0,\cdots,599.5\)
\(z\)-coordinates: \(-300.0,-299.8,-299.6,\cdots,299.8\)

This is a large data with \(1000\times 2000\times 3000\) grid nodes. However, assumed that only the values below are non-zero:

\(x\)	\(y\)	\(z\)	値 Value
0.0	0.0	0.0	1.2
0.0	0.0	0.2	3.4
0.0	0.0	-0.2	5.6
0.0	0.5	0.0	7.8
0.0	-0.5	0.0	9.0
1.0	0.0	0.0	12.3
-1.0	0.0	0.0	45.6

このデータを表現するためのファイルの中身は以下のようになる。ここではタブを分かりやすいように [TAB]で表す。
The file to represent this data is as follows, where tabs are shown by [TAB].

1000[TAB]2000[TAB]3000
-500.0[TAB]-400.0[TAB]-300.0
1.0[TAB]0.5[TAB]0.2
===
0.0[TAB]0.0[TAB]0.0[TAB]1.2
0.0[TAB]0.0[TAB]0.2[TAB]3.4
0.0[TAB]0.0[TAB]-0.2[TAB]5.6
0.0[TAB]0.5[TAB]0.0[TAB]7.8
0.0[TAB]-0.5[TAB]0.0[TAB]9.0
1.0[TAB]0.0[TAB]0.0[TAB]12.3
-1.0[TAB]0.0[TAB]0.0[TAB]45.6

3次元選択データ型 ファイル仕様

3次元選択データ型ファイル仕様