FieldView固有の機能へのアクセスを提供するポスト処理関数について説明します。ここでは、ポスト処理関数のうち、データ入出力を行う関数について説明します。
※関数の入力引数としてリストされたテーブルの値は、必ずしも必要ではありません。ほとんどの場合、入力にフィールドが指定されていない場合、そのフィールドのデフォルト値が使用されます。

データ入出力

read_dataset(data_input_table)
この関数はデータセットの読み込みに使用します。PLOT-3D、FV-UNS（FV-UNS分割フォーマットとFV-UNS統合フォーマットフォーマットの両方）および他の多くの商用ソルバーから出力されたフォーマットをサポートしています。いくつかの例を以下に示します。入力引数はテーブルdata_input_tableです。

データセット全体の読み込みが成功した場合、dataset_info_tableを返します。それ以外の場合は、nilとエラーを説明する文字列を返します。dataset_info_table書式の記述については、print_dataset_table（dataset_info_table）を参照してください。

data_input_table形式は読み込むファイル形式に依存します。

data_formatフィールドはユーザー定義のリーダーをサポートします。ユーザーはリーダーのタイプ（統合または分割）に従って入力テーブルを作成する必要があります。data_formatの値は登録されたリーダー名（つまり、File → Data Inputメニューに表示される名前）と一致していなければなりません。リーダー名では、大文字と小文字が区別され、スペースも使用できます（例えば、“My Reader”など）。FVXの値は末尾のスペースを持つべきではありません。そのため、FieldViewはユーザー定義のリーダーが登録されるときに、その名前の末尾にスペースがあれば削除します。

次にダイレクトリーダーとFV-UNSを含む統合フォーマット（グリッドと結果を含む単一ファイル）の場合のdata_input_tableについて説明します。ダイレクトリーダーはAcuSolve、CGNS、FLOW-3D、FLUENT、GENERIC、LS-DYNA、OpenFOAM、SC/Tetra、scSTREAM、STL、VTK、XDBのデータを読み込むことができます。これらの詳細については、リファレンスマニュアルの第1章を参照してください。

data_formatフィールドは、FV-UNS統合フォーマットとFV-UNS分割フォーマットの両方とも“unstructured”と指定しますが、input_parametersサブテーブルの構造は両者で異なります。

File → Data Inputメニューには、FV-UNSファイルに加えてFV-UNSファイルを出力する商用ソルバーが並んでいます。これらの商用ソルバーにはAcusim、ANSYS-CFX、CFD++、COBALT、FLUENT、STAR-CD、STAR-CCM+が含まれます。data_formatフィールドにこれらのソルバーを明示的に指定してもdata_input_tableは機能します。あるいはdata_formatフィールドに簡単に“unstructured”と指定しても機能します。

例：

data_input_table = {

　　data_format = "unstructured",
　　input_parameters = {

　　　　-- combined grid and results file
　　　　name = "combinedfile.uns",

　　　　options = {
　　　　　　input_mode = "replace",
　　　　　　transient = "off"
　　　　}
　　}
}
read_dataset(data_input_table)

例：

data_input_table = {
　　data_format = "lsdyna",
　　input_parameters = {

　　　　name = "d3plot"
　　} -- input_parameters
}
read_dataset(data_input_table)

FVXはXDBファイルのインポートを完全にサポートします。以下にXDB読み込みのサンプルFVXを示します。

local dataset_1_info_table = read_dataset( {
　　　　data_format = "xdb_import",
　　　　input_parameters = {
　　　　　　　　name = "/usr3/xdb/spitfire.xdb",
　　　　　　　　options = {
　　　　　　　　　　　　input_mode = "replace",
　　　　　　　　　　　　boundary_only = "off"
　　　　　　　　} -- options
　　　　} -- input_parameters
} ) -- read_dataset

次に、FV-UNS分割フォーマット、NPARC/WINDおよびWIND USフォーマットを含む、分割フォーマット（グリッドと結果が別ファイル）の場合のdata_input_tableについて説明します。

data_formatフィールドは、FV-UNS統合フォーマットとFV-UNS分割フォーマットの両方とも“unstructured”と指定しますが、input_parametersサブテーブルの構造は両者で異なります。

例：

data_input_table = {

　　data_format = "unstructured",
　　-- data_format = "nparc/wind",
　　input_parameters = { 　　

　　　　-- grid file information
　　　　grid_file = {
　　　　　　name = "gridfile.uns",
　　　　　　options = {
　　　　　　　　input_mode = "replace",
　　　　　　　　transient = "off"
　　　　　　}
　　　　},-- end grid file information

　　　　-- results file information
　　　　results_file = {
　　　　　　name = "resultsfile.uns",
　　　　　　options = {
　　　　　　input_mode = "replace",
　　　　　　transient = "off"
　　　　　　}
　　　　}-- end results file information

　　}-- end input parameters

}-- end data_input_table

read_dataset(data_input_table)

次に、PLOT3DとOVERFLOW-2フォーマットのdata_input_tableは以下の通りです。

例：

--set data file options
plot3d_or_overflow-2_options = {
　　format= "binary",-- default: binary
　　--format= "dp_unformatted",--double precision unformatted
　　input_mode= "replace",-- default: replace
　　coords= "3d",-- default: 3d
　　multi_grid= "on",-- default: off
　　iblanks= "on",-- default: off
　　transient= "off",-- default: off
}

--prepare argument data_input_table
data_input_table = {

　　data_format = "plot3d",
　　input_parameters = {

　　　　--xyz file information
　　　　xyz_file = {
　　　　name = "impeller3_xyz",
　　　　grid_point_increment = 1,
　　　　options = plot3d_or_overflow-2_options, 　　　　},

　　　　--q file information
　　　　q_file = {
　　　　name = "impeller3_abs.q",
　　　　options = plot3d_or_overflow-2_options,
　　　　},

　　}, --end input_parameters table

} --end data_input_table

--call function to read dataset
read_dataset(data_input_table)

例：

p3ddata= {
　　data_format = "plot3d",
　　　　input_parameters = {
　　　　　　xyz_file = {
　　　　　　name = "x.1100",
　　　　　　options = {
　　　　　　　　format="unformatted",
　　　　　　　　multi_grid = “on”,
　　　　　　　　iblanks = "on",
　　　　　　} -- options
　　　　　　},--xyz file
　　　　　　q_file = {
　　　　　　name = "q.1100",
　　　　　　options = {
　　　　　　　　format="unformatted",
　　　　　　　　multi_grid = "on",
　　　　　　　　iblanks = "on",
　　　　　　} -- options
　　　　　　},--q file
　　　　}--input_parameters
}-- p3ddata
read_dataset(p3ddata)

次にOVERFLOW-2データセット読み込みの例を示します。

--Set data file options
plot3d_or_overflow-2_options = {
　　format = "unformatted",
　　input_mode = "replace",
　　coords = "3d",
　　multi_grid = "off",
　　iblanks = "on",
　　transient = "off",
}

--Prepare argument data_input_table
data_input_table = {
　　data_format = "overflow-2",

　　input_parameters = {
　　　　--xyz file information
　　　　xyz_file = {
　　　　　　name = "grid.in",
　　　　　　grid_point_increment = 1,
　　　　　　options = plot3d_or_overflow-2_options,
　　　　},

　　　　--q file information
　　　　q_file = {
　　　　name = "q.gaminf",
　　　　options = plot3d_or_overflow-2_options,
　　　　},

　　}, --end input_parameters table

} --end data_input_table

--Call function to read dataset
read_dataset(data_input_table)

最後に、データセットサンプリングツールを使用して作成されたデータセットを読み込むためのdata_input_tableについて説明します（Help → Working with FieldViewより、データセットサンプリングの項をご参照ください）。

サンプリングされたデータセットを追加できるようにするには、元となるグリッドターゲットをまずFieldViewで読み込む必要があります。これを説明する簡単な例を以下に示します。

grid_target_table = read_dataset( {
　　data_format = "unstructured",
　　input_parameters = {
　　　　name = "./catheter_mod.fv",
　　　　options = {
　　　　　　input_mode = "replace",
　　　　　　boundary_only = "off"
　　　　} -- options
　　} -- input_parameters
} ) -- read_dataset

sampled_dataset_table = read_dataset( {
　　data_format = "append_sampled_data",
　　input_parameters = {
　　　　name = "./base_to_mod_sampled.uns"
　　} -- input_parameters
} ) -- read_dataset

print_dataset_table(dataset_info_table)
read_dataset（）関数が返すdataset_info_tableのテキスト出力をするための関数です。stdoutにデータセットの内容が出力されます。

例：

--get dataset table
t = read_dataset(data_input_table)

--call print function with handle "t"
print_dataset_table(t)