scilab/modules/fileio/help/ja_JP/save_format.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="save_format" xml:lang="ja">
   3     <refnamediv>
   4         <refname>save_format</refname>
   5         <refpurpose>"save"で作成されるファイルの形式</refpurpose>
   6     </refnamediv>
   7     <refsection>
   8         <title>概要</title>
   9         <para>本文書の目的はデータをScilabでデータ保存に使用されるHDF5形式について規定することです.
  10         </para>
  11         <para>この形式はSOD (Scilab Open Data) と呼ばれます.</para>
  12         <para>SODの最初の公開リリースは Scilab 5.4.0で行われました.</para>
  13     </refsection>
  14     <refsection>
  15         <title>動機</title>
  16         <para>
  17             相互運用性は近代的なソフトウエアの主要な特性の一つです.
  18             この特性をより改善するため, このSEPにおいて HDF5 形式の標準定義
  19             が提案されました.
  20         </para>
  21         <para>
  22             Scilab 5.2.0以降,
  23             エキスポート/インポート機能が開発され, データ交換用に管理されています.
  24             これは, 既にデータを保存および交換するためのXcosの基本要素の一つです.
  25         </para>
  26     </refsection>
  27     <refsection>
  28         <title>サポートされるデータ型</title>
  29         <para>全てのScilabデータ型がサポートされます. 例えば:</para>
  30         <informaltable border="1">
  31             <tbody>
  32                 <tr>
  33                     <td>
  34                         <emphasis role="bold">名前</emphasis>
  35                     </td>
  36                     <td>
  37                         <emphasis role="bold">Scilabにおける例</emphasis>
  38                     </td>
  39                 </tr>
  40                 <tr>
  41                     <td>
  42                         <emphasis role="bold">double</emphasis>
  43                     </td>
  44                     <programlisting>
  45                         A=32;
  46                         b=[32,2];
  47                         c=[2,2;3,4];
  48                         d=rand(10,10);
  49                     </programlisting>
  50                 </tr>
  51                 <tr>
  52                     <td>
  53                         <emphasis role="bold">string</emphasis>
  54                     </td>
  55                     <programlisting>
  56                         a="my string";
  57                         b=["string 1";"my string 2"];
  58                     </programlisting>
  59                 </tr>
  60                 <tr>
  61                     <td>
  62                         <emphasis role="bold">boolean</emphasis>
  63                     </td>
  64                     <programlisting>
  65                         a=%t;
  66                         b=[%t, %f];
  67                     </programlisting>
  68                 </tr>
  69                 <tr>
  70                     <td>
  71                         <emphasis role="bold">integer</emphasis>
  72                     </td>
  73                     <td>
  74                         <programlisting>
  75                             int8([1 -120 127 312])
  76                             x=int32(-200:100:400)
  77                         </programlisting>
  78                     </td>
  79                 </tr>
  80                 <tr>
  81                     <td>
  82                         <emphasis role="bold">polynomial</emphasis>
  83                     </td>
  84                     <td>
  85                         <programlisting>
  86                             s=poly([2 3],"s")
  87                             poly(1:4,'s','c')
  88                         </programlisting>
  89                     </td>
  90                 </tr>
  91                 <tr>
  92                     <td>
  93                         <emphasis role="bold">sparse</emphasis>
  94                     </td>
  95                     <td align="justify">
  96                         <programlisting>
  97                             sp=sparse([1,2;4,5;3,10],[1,2,3])
  98                         </programlisting>
  99                     </td>
 100                 </tr>
 101                 <tr>
 102                     <td>
 103                         <emphasis role="bold">boolean sparse</emphasis>
 104                     </td>
 105                     <td align="justify">
 106                         <programlisting>
 107                             dense=[%F, %F, %T, %F, %F
 108                             %T, %F, %F, %F, %F
 109                             %F, %F, %F, %F, %F
 110                             %F, %F, %F, %F, %T];
 111                             sp=sparse(dense)
 112                         </programlisting>
 113                     </td>
 114                 </tr>
 115                 <tr>
 116                     <td>
 117                         <emphasis role="bold">list</emphasis>
 118                     </td>
 119                     <td align="justify">
 120                         <programlisting>
 121                             l = list(1,["a" "b"])
 122                         </programlisting>
 123                     </td>
 124                 </tr>
 125                 <tr>
 126                     <td>
 127                         <emphasis role="bold">tlist</emphasis>
 128                     </td>
 129                     <td align="justify">
 130                         <programlisting>
 131                             t = tlist(["listtype","field1","field2"], [], []);
 132                         </programlisting>
 133                     </td>
 134                 </tr>
 135                 <tr>
 136                     <td>
 137                         <emphasis role="bold">mlist</emphasis>
 138                     </td>
 139                     <td align="justify">
 140                         <programlisting>
 141                             M=mlist(['V','name','value'],['a','b';'c' 'd'],[1 2; 3 4]);
 142                         </programlisting>
 143                     </td>
 144                 </tr>
 145             </tbody>
 146         </informaltable>
 147         <para>
 148             複数の"types"は,<emphasis>tlist</emphasis> または <emphasis>mlist</emphasis>
 149             に基づいています.
 150             これは,
 151             <emphasis>rational</emphasis>, <emphasis>state-space</emphasis>,
 152             <emphasis>cell</emphasis> および
 153             <emphasis>struct</emphasis>の場合です.
 154             これらは透過的に保存されます.
 155         </para>
 156         <para>
 157             <emphasis>void</emphasis>および <emphasis>undefined</emphasis>は,
 158             リスト管理において特別な場合を管理するために作成された特殊な要素です.
 159             これらはこの文書にて後述します.
 160         </para>
 161     </refsection>
 162     <refsection>
 163         <title>HDF5ファイルの構造</title>
 164         <para>Scilab HDF5 アーキテクチャは非常に簡単です. </para>
 165         <emphasis role="bold">General</emphasis>
 166         <para>
 167             各Scilab変数について, ルート位置におけるデータセットが宣言されます.
 168             データセットの名前はScilab変数の名前です.
 169         </para>
 170         <para>例, 以下のコード:</para>
 171         <programlisting>
 172             emptyuint32matrix = uint32([]);
 173             uint32scalar = uint32(1);
 174             uint32rowvector = uint32([1 4 7]);
 175             uint32colvector = uint32([1;4;7]);
 176             uint32matrix = uint32([1 4 7;9 6 3]);
 177             save("uint32.sod","emptyuint32matrix","uint32scalar","uint32rowvector","uint32colvector","uint32matrix");
 178         </programlisting>
 179         <para>produces:</para>
 180         <mediaobject>
 181             <imageobject>
 182                 <imagedata fileref="../images/img001.png"/>
 183             </imageobject>
 184         </mediaobject>
 185         <para>
 186             各ルートデータセットは<literal>SCILAB_Class</literal>と呼ばれる
 187             属性を有します.この属性は, HDF5ファイルに保持される変数の型を定義します.
 188         </para>
 189         <para>
 190             変数がプリミティブ型で関連する複合値がない場合,
 191             データは直接データセットに保存されます.
 192             それ以外の場合, データセットは実際のデータへのリファレンスを有します.
 193         </para>
 194         <para>各 SOD ファイルは2つの固有の変数を有します:</para>
 195         <itemizedlist>
 196             <listitem>
 197                 <para>
 198                     <literal>SCILAB_scilab_version</literal> ?
 199                     SODファイルに保存する際に使用された Scilabのバージョンを記述します.
 200                 </para>
 201                 <para>例えば, Scilab 5.4.0の場合, このデータは以下となります:</para>
 202                 <para>
 203                     <emphasis>SCILAB_scilab_version = scilab-5.4.0</emphasis>
 204                 </para>
 205             </listitem>
 206             <listitem>
 207                 <para>SCILAB_sod_version ?
 208                     SODファイルに保存する際に使用された SOD規約のバージョンを記述します.
 209                 </para>
 210                 <para>例えば, Scilab 5.4.0の場合, このデータは以下となります:</para>
 211                 <para>
 212                     <emphasis>SCILAB_sod_version = 2</emphasis>
 213                 </para>
 214             </listitem>
 215         </itemizedlist>
 216         <para>
 217             データがデータセット内で直線的に保存される型
 218         </para>
 219         <informaltable border="1">
 220             <tbody>
 221                 <tr>
 222                     <td align="left">
 223                         <emphasis role="bold">Scilab 型</emphasis>
 224                     </td>
 225                     <td align="left">
 226                         <emphasis role="bold">HDF5 Scilab 型属性</emphasis>
 227                     </td>
 228                     <td align="left">
 229                         <emphasis role="bold">HDF5 属性</emphasis>
 230                     </td>
 231                     <td align="left">
 232                         <emphasis role="bold">HDF データ型マッピング</emphasis>
 233                     </td>
 234                 </tr>
 235                 <tr>
 236                     <td align="left">
 237                         <para>string</para>
 238                     </td>
 239                     <td align="left">
 240                         <para>SCILAB_Class = string</para>
 241                     </td>
 242                     <td align="left">
 243
 244                     </td>
 245                     <td align="left">
 246                         <para>String</para>
 247                     </td>
 248                 </tr>
 249                 <tr>
 250                     <td align="left">
 251                         <para>boolean</para>
 252                     </td>
 253                     <td namest="c2" nameend="c3" align="left">
 254                         <para>SCILAB_Class = boolean</para>
 255                     </td>
 256                     <td align="left">
 257
 258                     </td>
 259                     <td align="left">
 260                         <para>32ビット 整数</para>
 261                     </td>
 262                 </tr>
 263                 <tr>
 264                     <td align="left">
 265                         <para>integer</para>
 266                     </td>
 267                     <td namest="c2" nameend="c3" align="left">
 268                         <para>SCILAB_Class = integer</para>
 269                     </td>
 270                     <td align="left">
 271                         <para>SCILAB_precision = {8, 16, 32, u8, u16, u32}</para>
 272                     </td>
 273                     <td namest="c1" nameend="c2" align="left">
 274                         <para>8 = 8ビット文字</para>
 275                         <para>16 = 16ビット整数</para>
 276                         <para>32 = 32ビット整数</para>
 277                         <para>u8 = 8ビット符号無し文字</para>
 278                         <para>u16 = 16ビット符号無し整数</para>
 279                         <para>u32 = 32ビット符号無し整数</para>
 280                     </td>
 281                 </tr>
 282             </tbody>
 283         </informaltable>
 284         <para>
 285             これらの型について, Scilabにおける場合と同様に,
 286             データは1次元配列に保存されます.データは列方向に保存されます.
 287         </para>
 288         <para>
 289             行列, ベクトルまたはスカラーを再構築するために,
 290             2つの属性が列と行の数を指定します.
 291         </para>
 292         <para>
 293             5.4.0リリースおよび SOD v2以降,
 294             <literal>SCILAB_cols</literal> および<literal>SCILAB_rows</literal> は
 295             double, 整数, 多項式および文字列の行列ではもはや使用されなくなりました.
 296             SOD はネーティブな多次元HDF5機能を使用します.
 297         </para>
 298         <para>
 299             <emphasis role="bold">例</emphasis>
 300         </para>
 301         <para>
 302             宣言の保存: <code>int32([1 -4 7;-9 6 -3])</code> は,hdfviewで以下のように表示されます:
 303         </para>
 304         <mediaobject>
 305             <imageobject>
 306                 <imagedata fileref="../images/img002.png"/>
 307             </imageobject>
 308         </mediaobject>
 309         <para>metadataは以下のようになります:</para>
 310         <emphasis role="italic">
 311             <para>int32matrix (800, 2)</para>
 312             <para>32-bit integer, 3 x 2 =&gt; the size of the variable</para>
 313             <para>Number of attributes = 2</para>
 314             <para>SCILAB_Class = integer</para>
 315             <para>SCILAB_precision = 32</para>
 316         </emphasis>
 317         <para>
 318             <note>
 319                 スカラー値は1行1列の行列に保存されます.
 320             </note>
 321         </para>
 322         <para>
 323             空の変数 (<literal>[]</literal>) はtrueに設定された属性<literal>SCILAB_empty</literal>を有します.
 324         </para>
 325         <para>
 326             <emphasis role="bold">データが専用のグループに保存される型</emphasis>
 327         </para>
 328         <para>
 329             Scilabデータ型の多くはグループで保存されます.
 330             これにより,値の分離を明確にでき,アクセスも容易になります.
 331         </para>
 332         <para>
 333             グループは"#"で括られた変数から命名されます.例えば,
 334             matrixofdoubleと呼ばれるdoubleの行列の場合,
 335             ルートデータセットの名前は matrixofdoubleとなり,
 336             関連するグループの名前は
 337             <emphasis role="strong">#matrixofdouble#</emphasis>となります.
 338         </para>
 339         <para>
 340             再帰的なデータ型(list, mlist, tlist, etc)の場合,
 341             サブグループの名前が以下のように構築されます:
 342         </para>
 343         <para>
 344             この <literal>#</literal> によりユニークなIDを作成できるようになります.
 345             最初の<literal>#</literal>の数は深さのレベルを示します.
 346             例えば, サブリスト <emphasis>###listnested#_#2##_#1##</emphasis>は,
 347             2番目のレベ得るに位置することを示します.
 348         </para>
 349         <para>
 350             アンダースコア "_" は深さを表す手段です.
 351             通常, "/" 文字がこのような場合に使用されますが,
 352             HDF5規約では予約済みキーワードとなっています.
 353         </para>
 354         <para>
 355             名前で使用される整数は,
 356             カレントの構造における位置と親要素に関する位置の両方の意味で
 357             データ構造における位置を表します.
 358             例えば,
 359             <emphasis>###listnested#_#2##_#1##</emphasis>,
 360             は,親要素の3番目の構造の2番目の要素として扱われることを示します
 361             (要素は0から番号付けられます).
 362         </para>
 363         <para>
 364             例えば, <emphasis>###listnested#_#2##_#1##</emphasis>という名前のグループは,
 365             以下の例では値 [32, 42] を指します:
 366         </para>
 367         <programlisting>
 368             listnested=list(2,%i,'f',ones(3,3))
 369             listnested(3) = list( %t, [32,42]);
 370         </programlisting>
 371         <para>
 372             <emphasis role="bold">疎行列</emphasis>
 373         </para>
 374         <para>
 375             <emphasis role="strong">Scilab 型:</emphasis> sparse
 376         </para>
 377         <para>
 378             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis> SCILAB_Class = sparse
 379         </para>
 380         <para>
 381             <emphasis role="strong">HDF5 属性: </emphasis>
 382         </para>
 383         <para>SCILAB_rows = &lt;int&gt;</para>
 384         <para>行数</para>
 385         <para>
 386             <emphasis>SCILAB_cols = &lt;int&gt;</emphasis>
 387         </para>
 388         <para>列数</para>
 389         <para>
 390             <emphasis>SCILAB_items = &lt;int&gt;</emphasis>
 391         </para>
 392         <para>疎行列における要素数を定義</para>
 393         <para>
 394             <emphasis role="strong">ルートデータセットの値:</emphasis>
 395         </para>
 396         <para>
 397             最初の値 (<literal>#0#</literal>):
 398             このデータ構造の各要素は各行の非ヌル要素の数を示します.
 399             つまり, 最初の要素は疎行列の最初の行の要素数を示します.
 400         </para>
 401         <para>
 402             2番目の値 (<literal>#1#</literal>):
 403             疎行列の各要素の列の位置を示します.
 404         </para>
 405         <para>
 406             3番目の値 (<literal>#2#</literal>):
 407             疎行列における要素の実際の値へのリファレンスを保存します
 408             (この値は専用のグループに保存されます).
 409         </para>
 410         <para>例えば, この行列を考えると:</para>
 411         <programlisting role="no-scilab-exec">
 412             0. 1. 0. 0. 0. 0. 0. 0. 0. 0.
 413             0. 0. 0. 0. 0. 0. 0. 0. 0. 0.
 414             0. 0. 0. 0. 0. 0. 0. 0. 0. 3.
 415             0. 0. 0. 0. 2. 0. 0. 0. 0. 0.
 416         </programlisting>
 417         <para>これは以下の関数で生成されます:</para>
 418         <programlisting role="scilab_code">
 419             sparse([1,2;4,5;3,10],[1,2,3])
 420         </programlisting>
 421         <para>
 422             これは以下となります:
 423         </para>
 424         <para>
 425             <emphasis>#0#</emphasis> は,<emphasis>1;0;1;1</emphasis>を有します
 426         </para>
 427         <para>
 428             <emphasis>#1#</emphasis> は,<emphasis>2;10;5</emphasis>を有します
 429         </para>
 430         <para>
 431             <emphasis>#2#</emphasis> は,<emphasis>1.0; 3.0; 2.0</emphasis>を有する
 432             double(この例では複素数ではありません)の行列を参照します
 433         </para>
 434         <para>
 435             <emphasis role="bold">論理値疎行列</emphasis>
 436         </para>
 437         <para>
 438             <emphasis role="strong">Scilab型:</emphasis> boolean sparse
 439         </para>
 440         <para>
 441             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis> SCILAB_Class = boolean sparse
 442         </para>
 443         <para>
 444             <emphasis>HDF5属性:</emphasis>
 445         </para>
 446         <para>
 447             <emphasis>SCILAB_rows = &lt;int&gt;</emphasis>
 448         </para>
 449         <para>行数</para>
 450         <para>
 451             <emphasis>SCILAB_cols = &lt;int&gt;</emphasis>
 452         </para>
 453         <para>列数</para>
 454         <para>
 455             <emphasis>SCILAB_items = &lt;int&gt;</emphasis>
 456         </para>
 457         <para>疎行列の要素数を定義</para>
 458         <para>
 459             <emphasis role="strong">ルートデータセットの値:</emphasis> 疎行列は3つのデータセットを有しますが,
 460             論理値疎行列は2つのみです.これは定義される値は自動的にtrueとみなされるためです.
 461         </para>
 462         <para>
 463             最初の値 (<literal>#0#</literal>): このデータ構造の各要素は各行の非ゼロ要素の数を示します.
 464         </para>
 465         <para>
 466             つまり, 最初の要素は疎行列の最初の行の要素数を示します.
 467         </para>
 468         <para>
 469             2番目の値 (<literal>#1#</literal>):
 470             疎行列の各要素の列の位置を示します.
 471         </para>
 472         <para>以下の論理値疎行列について:</para>
 473         <programlisting>
 474             dense=[%F, %F, %T, %F, %F
 475             %T, %F, %F, %F, %F
 476             %F, %F, %F, %F, %F
 477             %F, %F, %F, %F, %T];
 478         </programlisting>
 479         <para>
 480             <emphasis>#0#</emphasis> は <emphasis>1;1;0;1</emphasis>を有します.
 481         </para>
 482         <para>
 483             <emphasis>#1#</emphasis> は <emphasis>3;1;5</emphasis>を有します.
 484         </para>
 485         <para>
 486             論理値疎行列を再生するために必要な情報は2つのみです.
 487         </para>
 488         <para>HDFデータ型マッピング:</para>
 489         <para>32ビット整数</para>
 490         <para>
 491             <emphasis role="bold">Double</emphasis>
 492         </para>
 493         <para>
 494             <emphasis role="strong">Scilab 型:</emphasis> double
 495         </para>
 496         <para>
 497             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis> SCILAB_Class = double
 498         </para>
 499         <para>
 500             <emphasis role="strong">ルートデータセットの値:</emphasis>
 501             実数および複素数の値は共に<literal>#&lt;variable name&gt;#</literal>と
 502             呼ばれるグループに保存されます.
 503         </para>
 504         <para>
 505             最初の値: 実数値へのリファレンス. 名前は<literal>#0#</literal>.
 506         </para>
 507         <para>
 508             行列が複素数の場合, 2番目の値は複素数の値へのリファレンスとなります. 名前は<literal>#1#</literal>.
 509         </para>
 510         <para>
 511             <emphasis role="strong">HDF データ型マッピング:</emphasis> 64-bit floating-point
 512         </para>
 513         <para>
 514             <emphasis role="bold">多項式</emphasis>
 515         </para>
 516         <para>
 517             <emphasis role="strong">Scilab 型:</emphasis> polynomial
 518         </para>
 519         <para>
 520             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis> SCILAB_Class = polynomial
 521         </para>
 522         <para>
 523             <emphasis role="strong">HDF5 属性: </emphasis>
 524         </para>
 525         <para>SCILAB_Class = polynomial</para>
 526         <para>SCILAB_varname = &lt;string&gt;</para>
 527         <para>シンボル変数の名前</para>
 528         <para>
 529             <emphasis>SCILAB_Complex = &lt;boolean&gt;</emphasis>
 530         </para>
 531         <para>多項式が複素数の場合 (そうでない場合は設定されません)</para>
 532         <para>
 533             <emphasis role="strong">ルートデータセットの値:</emphasis>
 534         </para>
 535         <para>
 536             係数はdoubleの行列の形式で(double記憶領域の関連部分に)保存されます.
 537             係数は,複素数にできるため,複素数の行列に保存されることに注意してください.
 538             (サブ)グループとデータセットの命名規則は
 539             本章の先頭に記述されています.
 540         </para>
 541         <para>
 542             <emphasis role="strong">HDF データ型マッピング:</emphasis> Object reference
 543         </para>
 544         <para>
 545             <emphasis role="bold">list</emphasis>
 546         </para>
 547         <para>
 548             <emphasis role="strong">Scilab 型:</emphasis> list
 549         </para>
 550         <para>
 551             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis>
 552         </para>
 553         <para>SCILAB_Class = list</para>
 554         <para>
 555             <emphasis role="strong">HDF5 属性:</emphasis> SCILAB_items = &lt;リストの要素数&gt;
 556         </para>
 557         <para>
 558             <emphasis role="strong">ルートデータセットの値:</emphasis>
 559         </para>
 560         <para>
 561             ルートデータセットに関連して,このデータセットで保存される値は
 562             リストに保存された値へのリファレンスです.
 563             値は<literal>#&lt;variable name&gt;#</literal>と呼ばれるグループに保存されます.
 564             この <literal>#&lt;variable name&gt;#</literal> グループにおいて,
 565             データは任意の型とすることができます.
 566             これらはグループに直線的に保存されます.
 567             その表現は他の場合と同様で,再帰的な構造にもとづきます
 568             (種々の型のリストのリストのリストが保存および読込みできることを意味します).
 569         </para>
 570         <para>
 571             (サブ)グループとデータセットの命名規則は本章の先頭に記述されています.
 572         </para>
 573         <para>
 574             <emphasis role="strong">HDF データ型マッピング:</emphasis> Object reference
 575         </para>
 576         <para>
 577             <emphasis role="bold">tlist </emphasis>
 578         </para>
 579         <para>
 580             <emphasis role="strong">Scilab型:</emphasis> tlist
 581         </para>
 582         <para>
 583             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis>
 584         </para>
 585         <para> SCILAB_Class = tlist</para>
 586         <para>
 587             <emphasis role="strong">HDF5 属性:</emphasis> cf list
 588         </para>
 589         <para>
 590             <emphasis role="bold">mlist </emphasis>
 591         </para>
 592         <para>
 593             <emphasis role="strong">Scilab type:</emphasis> mlist
 594         </para>
 595         <para>
 596             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis>
 597         </para>
 598         <para>SCILAB_Class = mlist</para>
 599         <para>
 600             <emphasis role="strong">HDF5 attributes:</emphasis> cf list
 601         </para>
 602         <para>
 603             <emphasis role="bold">void </emphasis>
 604         </para>
 605         <para>
 606             <emphasis role="strong">Scilab型:</emphasis> void
 607         </para>
 608         <para>
 609             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis>
 610         </para>
 611         <para>SCILAB_Class = void</para>
 612         <para>
 613             void値はlist, tlistおよびmlistの非常に特殊な使用法でのみ
 614             現れます.
 615             以下の構文で作成することができます:
 616         </para>
 617         <programlisting>voidelement_ref=list(1,,3);</programlisting>
 618         <para>
 619             <emphasis role="bold">undefined </emphasis>
 620         </para>
 621         <para>
 622             <emphasis role="strong">Scilab 型:</emphasis> undefined
 623         </para>
 624         <para>
 625             <emphasis role="strong">HDF5 Scilab 型属性:</emphasis>
 626         </para>
 627         <para> SCILAB_Class = undefined</para>
 628         <para>
 629             undefined 値はリストの大きさが増加し, いくつかの要素が未定義となった
 630             場合に生成されます.
 631             これらは以下の構文で生成されます:
 632         </para>
 633         <programlisting>
 634             undefinedelement_ref=list(2,%i,'f',ones(3,3));
 635             undefinedelement_ref(6)="toto"
 636         </programlisting>
 637     </refsection>
 638     <refsection>
 639         <title>実際の例</title>
 640         <para>
 641             これらの変数全てについてサンプルファイルがScilabディストリビューションで
 642             提供されています.
 643             これらは,以下のディレクトリで入手可能です:
 644             <emphasis>SCI/modules/hdf5/tests/sample_scilab_data/</emphasis>
 645         </para>
 646         <para>
 647             本文書の編集時点で,
 648             以下のファイルがScilabディストリビューションで提供されています:
 649         </para>
 650         <emphasis role="italic">
 651             <para>
 652                 booleanmatrix.sod
 653             </para>
 654             <para>booleanscalar.sod
 655             </para>
 656             <para>booleansparse.sod
 657             </para>
 658             <para>emptymatrix.sod
 659             </para>
 660             <para>emptysparse.sod
 661             </para>
 662             <para>hypermatrixcomplex.sod
 663             </para>
 664             <para>hypermatrix.sod
 665             </para>
 666             <para>int16.sod
 667             </para>
 668             <para>int32.sod
 669             </para>
 670             <para>int8.sod
 671             </para>
 672             <para>listnested.sod
 673             </para>
 674             <para>list.sod
 675             </para>
 676             <para>matricedoublecomplexscalar.sod
 677             </para>
 678             <para>matricedoublecomplex.sod
 679             </para>
 680             <para>matricedoublescalar.sod
 681             </para>
 682             <para>matricedouble.sod
 683             </para>
 684             <para>matricestringscalar.sod
 685             </para>
 686             <para>matricestring.sod
 687             </para>
 688             <para>mlist.sod
 689             </para>
 690             <para>polynomialscoef.sod
 691             </para>
 692             <para>polynomials.sod
 693             </para>
 694             <para>sparsematrix.sod
 695             </para>
 696             <para>tlist.sod
 697             </para>
 698             <para>uint16.sod
 699             </para>
 700             <para>uint32.sod
 701             </para>
 702             <para>uint8.sod
 703             </para>
 704             <para>undefinedelement.sod
 705             </para>
 706             <para>voidelement.sod
 707             </para>
 708         </emphasis>
 709     </refsection>
 710     <refsection>
 711         <title>フォーマットの進化</title>
 712         <informaltable border="1">
 713             <tbody>
 714                 <tr>
 715                     <td align="justify">
 716                         <emphasis role="bold">SOD バージョン</emphasis>
 717                     </td>
 718                     <td align="justify">
 719                         <emphasis role="bold">Scilab バージョン</emphasis>
 720                     </td>
 721                     <td align="justify">
 722                         <emphasis role="bold">説明</emphasis>
 723                     </td>
 724                 </tr>
 725                 <tr>
 726                     <td align="center">
 727                         <para>0</para>
 728                     </td>
 729                     <td align="center">
 730                         <para>5.2.0</para>
 731                     </td>
 732                     <td align="justify">
 733                         <para>Scilab/HDF5 形式の最初のバージョン</para>
 734                     </td>
 735                 </tr>
 736                 <tr>
 737                     <td align="center">
 738                         <para>1</para>
 739                     </td>
 740                     <td align="center">
 741                         <para>5.4.0 alpha / beta</para>
 742                     </td>
 743                     <td align="left">
 744                         <para>読込み/保存のデフォルト形式</para>
 745                         <para>前の形式 (.bin) はまだサポートされます</para>
 746                     </td>
 747                 </tr>
 748                 <tr>
 749                     <td align="center">
 750                         <para>2</para>
 751                     </td>
 752                     <td align="center">
 753                         <para>5.4.0</para>
 754                     </td>
 755                     <td>
 756                         <para>
 757                             double, 整数, 多項式および文字列について,
 758                             多次元 HDF5 を使用するため,
 759                             <emphasis>SCILAB_cols</emphasis> / <emphasis>SCILAB_rows</emphasis>
 760                             が削除されました.
 761                         </para>
 762                     </td>
 763                 </tr>
 764                 <tr>
 765                     <td align="center">
 766                        3
 767                     </td>
 768                     <td align="center">
 769                         <para>6.0.0</para>
 770                     </td>
 771                     <td align="justify">
 772                         <para>.bin サポートを廃止.</para>
 773                     </td>
 774                 </tr>
 775             </tbody>
 776         </informaltable>
 777     </refsection>
 778     <refsection role="see also">
 779         <title>参照</title>
 780         <simplelist type="inline">
 781             <member>
 782                 <link linkend="save">save</link>
 783             </member>
 784             <member>
 785                 <link linkend="load">load</link>
 786             </member>
 787             <member>
 788                 <link linkend="listvarinfile">listvarinfile</link>
 789             </member>
 790             <member>
 791                 <link linkend="type">type</link>
 792             </member>
 793             <member>
 794                 <link linkend="typeof">typeof</link>
 795             </member>
 796         </simplelist>
 797     </refsection>
 798 </refentry>