japanese translation updated for xcos module. 97/14497/2
Rui Hirokawa [Sun, 4 May 2014 10:16:39 +0000 (19:16 +0900)]
Change-Id: I7cba6b4d1b41bbaffe9da487291fd8be45d64ce1

scilab/modules/xcos/help/ja_JP/batch_functions/lincos.xml
scilab/modules/xcos/help/ja_JP/batch_functions/scicos_simulate.xml
scilab/modules/xcos/help/ja_JP/batch_functions/steadycos.xml
scilab/modules/xcos/help/ja_JP/scilab_data_structures/blocks/scicos_graphics.xml
scilab/modules/xcos/help/ja_JP/scilab_data_structures/blocks/scicos_model.xml
scilab/modules/xcos/help/ja_JP/xcos.xml
scilab/modules/xcos/help/ja_JP/xcos_debug_gui.xml [new file with mode: 0644]
scilab/modules/xcos/help/ja_JP/xcos_menu_entries.xml

index d2242b1..f97ce6c 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scicos
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="lincos">
+    
     <refnamediv>
+        
         <refname>lincos</refname>
-        <refpurpose>xcosダイアグラムにより記述された一般的な動的システムから
+        
+        <refpurpose>
+            
+            Xcosダイアグラムにより記述された一般的な動的システムから
+            
             線形化により定義された線形状態空間モデル
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>sys= lincos(scs_m [,x0,u0 [,param] ])</synopsis>
+        
+        <synopsis>sys = lincos(scs_m [,x0,u0 [,param] ])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection id="Module_lincos">
+        
         <title>モジュール</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Description_lincos">
+        
         <title>説明</title>
+        
         <para>
-            xcosダイアグラムで指定されたモデルを線形化することにより
+            
+            Xcosダイアグラムで指定されたモデルを線形化することにより
+            
             線形状態空間システムを構築します.
+            
+            この処理は,<link linkend="SUPER_f">サブダイアグラム</link> 
+            
+            を線形状態空間モデルに変換するものです.
+            
+            サブダイアグラムは, <link linkend="IN_f">入力</link> および
+            
+            <link linkend="OUT_f">出力</link>を有している必要があります.
+            
         </para>
+        
         <para>
+            
             出力は,連続時間状態空間線形システム型のScilabデータ構造体です.
+            
         </para>
-        <para>
-        </para>
-        <programlisting role="example"><![CDATA[ 
-sys= lincos(scs_m [,x0,u0 [,param] ])
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+// loading data
+exec("SCI/modules/xcos/tests/unit_tests/PENDULUM_ANIM.sci");
+exec("SCI/modules/xcos/tests/unit_tests/anim_pen.sci");
+
+loadXcosLibs(); loadScicos();
+importXcosDiagram("SCI/modules/xcos/tests/unit_tests/pendulum_anim45.zcos");
+
+// specific context data
+M  = 10;
+m  = 3;
+l  = 3;
+ph = 0.1;
+z0 = -4;
+th0 = .02;
+
+// looking for the Superblock to linearize
+for i=1:length(scs_m.objs)
+    if typeof(scs_m.objs(i))=="Block" & scs_m.objs(i).gui=="SUPER_f" then
+        scs_m = scs_m.objs(i).model.rpar;
+        break;
+    end
+end
+
+sys = lincos(scs_m);
+
+bode(sys);
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection id="Parameters_lincos">
+        
         <title>パラメータ</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">scs_m :</emphasis>xcosデータ構造体
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">x0 :</emphasis> 列ベクトル.連続時間状態変数で,
+                    
                     この近傍で線形化が行われます (デフォルト: 0)
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">u0 :</emphasis> 列ベクトル. 
+                    
                     入力で,この近傍で線形化が行われます (デフォルト: 0)
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">param :</emphasis> param: 
+                    
                     2つの要素を有するリスト (デフォルト: list(1.d-6,0)).
+                    
                     param(1): スカラー. 線形化用の擾乱の大きさ; 以下の変動が使用されます
+                    
                     del([x;u])_i = param(1)+param(1)*1d-4*abs([x;u])_i. 
+                    
                     param(2): スカラー. 時刻 t.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">sys :</emphasis> 状態空間システム
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
-    <refsection id="Filecontent_lincos">
-        <title>ファイルの内容</title>
-        <itemizedlist>
-            <listitem>
-                <para> SCI/modules/scicos/macros/scicos_auto/lincos.sci</para>
-            </listitem>
-        </itemizedlist>
-    </refsection>
+    
     <refsection id="SeeAlso_lincos">
+        
         <title>参照</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="steadycos">steadycos - 
+                        
                         xcosダイアグラムで記述された一般の動的システムの状態変数の定常値を見つけます
+                        
                         (Scilab関数)
+                        
                     </link>
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="scicos_simulate">scicos_simulate - 
+                        
                         xcosシミュレーションをバッチモードで実行する関数 (Scilab 関数)
+                        
                     </link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+
index d2c7b9c..5dfd0fa 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scicos
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="scicos_simulate">
+    
     <refnamediv>
+        
         <refname>scicos_simulate</refname>
+        
         <refpurpose>シミュレーションをバッチモードで実行する関数</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>Info=scicos_simulate(scs_m)</synopsis>
+        
         <synopsis>Info=scicos_simulate(scs_m,Info)</synopsis>
+        
         <synopsis>Info=scicos_simulate(scs_m,context)</synopsis>
+        
         <synopsis>Info=scicos_simulate(scs_m,flag)</synopsis>
+        
         <synopsis>Info=scicos_simulate(scs_m ,Info [, context] [,flag])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection id="Parameters_scicos_simulate">
+        
         <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>scs_m</term>: ダイアグラムデータ構造体 (<link linkend="scicos_diagram">scs_m 構造体</link>参照).
+                
                 <para/>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Info</term>: リスト.
+                
                 初回コール時は<literal>list()</literal>,次回コール以降は
+                
                 <literal>Info</literal>出力を<literal>Info</literal>入力として
+                
                 指定してください.
+                
                 <literal>Info</literal>にはコンパイルおよびシミュレーション関連情報
+                
                 が含まれ,不要な再コンパイルを避けるために使用されます.
+                
                 <para/>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>ContextValues</term>: 
+                
                 Scilab構造体で,コンテキストおよびxcosブロックで使用されるシンボル変数の値を有します.
+                
                 <para/>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>flag</term>: 文字列. 
+                
                 'nw' (no window)の場合, グラフィックウインドウを使用するブロックは実行されません.
+                
                 このようなブロックのリストは,新規ブロック追加時に更新する必要があることに注意してください.
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection id="Module_scicos_simulate">
+        
         <title>モジュール</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Description_scicos_simulate">
+        
         <title>説明</title>
+        
         <para>
+            
             この関数はバッチモードで xcos ダイアグラムをシミュレートする際に使用されます.
+            
             この関数には,<literal>.zcos</literal>ファイルをScilabにロードした際に
+            
             得られる <link linkend="scicos_diagram">scs_m構造体</link>を指定します
+            
             (<link linkend="importXcosDiagram">importXcosDiagram</link>参照).
+            
         </para>
+        
         <para>
+            
             <literal>ContextValues</literal>は,主ダイアグラムコンテキストで
+            
             設定される主要なパラメータの値を変更する際に使用することができます.
+            
             例: 変数 <literal>A</literal> がダイアグラムの主コンテキストで
+            
             1に設定された場合, <literal>A</literal> の値を
+            
             <literal>scicos_simulate</literal> シミュレーション時に
+            
             以下のように設定することにより変更することができます.
+            
             <programlisting role="example"><![CDATA[
     ContextValues.A=2 
     ]]></programlisting>
+            
         </para>
+        
         <para>
+            
             <literal>ContextValues</literal>引数を使用せずに
+            
             Scilab内部で定義された変数を直接使用することも可能ですが,
+            
             このような用途の場合,コンテキストの定義でこれが可能である
+            
             ことが必要です: 例えば,パラメータ<literal>A</literal>として
+            
             Scilab変数<literal>A</literal>の値を
+            
             使用するシミュレーションを可能としたい場合,
+            
             ダイアグラムコンテキストの定義に以下を記述する必要があります:
+            
             <programlisting role="example"><![CDATA[
    if ~exists('A') then  A=1,end
     ]]></programlisting> 
+            
             この第二の手法は,Scilabで定義された<literal>A</literal>のカレントの値に依存するという
+            
             弱点があることに注意してください.
+            
         </para>
+        
     </refsection>
+    
     <refsection id="Filecontent_scicos_simulate">
+        
         <title>ファイルの内容</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para> SCI/modules/scicos/macros/scicos_auto/scicos_simulate.sci</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Examples_scicos_simulate">
-        <title>例</title><literal>SCI/modules/xcos/demos/batch_simulation.zcos</literal>のxcosダイアグラム
-        <mediaobject>
-            <imageobject>
-                <imagedata align="center" fileref="../../../demos/batch_simulation.zcos"/>
-            </imageobject>
-        </mediaobject>
+        
+        <title>例</title>
+        
+        <para>
+            
+            xcos diagram は,
+            
+            <link type="scilab" linkend="scilab.xcos/xcos/demos/batch_simulation.zcos">SCI/modules/xcos/demos/batch_simulation.zcos</link>にあります.
+            
+            <mediaobject>
+                
+                <imageobject>
+                    
+                    <imagedata align="center" fileref="../../../demos/batch_simulation.zcos"/>
+                    
+                </imageobject>
+                
+            </mediaobject>
+            
+        </para>
+        
         <programlisting role="example"><![CDATA[ 
 importXcosDiagram("SCI/modules/xcos/demos/batch_simulation.zcos")
 typeof(scs_m) //ダイアグラムデータ構造体
@@ -141,28 +247,54 @@ scicos_simulate(scs_m,list(),Context,'nw');
 // "from workspace block"で作成された変数を取得
 counter 
     ]]></programlisting>
+        
     </refsection>
+    
     <refsection id="SeeAlso_scicos_simulate">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="scicos_diagram">scs_m構造体</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="importXcosDiagram"> importXcosDiagram</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="scicosim">scicosim: xcosバッチシミュレーション関数</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="xcos">xcos: ブロックダイアグラムエディタおよびハイブリッドシミュレータのGUI</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="steadycos">steadycos: xcosダイアグラムの定常値を求める</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lincos">lincos: xcosダイアグラムから線形状態空間モデルを線形化により構築</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 6f41f92..cedb563 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scicos
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="steadycos">
+    
     <refnamediv>
+        
         <refname>steadycos</refname>
-        <refpurpose>xcosダイアグラムで記述された一般の動的システムの状態変数の
+        
+        <refpurpose>
+            
+            xcosダイアグラムで記述された一般の動的システムの状態変数の
+            
             定常値を見つける
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[X,U,Y,XP]=steadycos(scs_m,X,U,Y,Indx,Indu,Indy [,Indxp [,param ] ])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection id="Module_steadycos">
+        
         <title>モジュール</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Description_steadycos">
+        
         <title>説明</title>
+        
         <para>
-            この関数はxcosダイアグラムにより記述されたシステムの状態変数の定常値を見つけます.
-            ダイアグラムは一般に入力および出力ポートブロックを有するスーパーブロックから
-            構成されます.
+            
+            この関数は,xcosダイアグラムまたは
+            
+            <link linkend="SUPER_f">サブダイアグラム</link>
+            
+            により記述されたシステムの状態変数の定常値を見つけます.
+            
+            ダイアグラムは
+            
+            <link linkend="IN_f">入力</link> と <link linkend="OUT_f">出力</link>
+            
+            を有している必要があります.
+            
             状態変数の定常値は連続時間ダイナミクスのみを考慮します.
+            
         </para>
-        <para>
-        </para>
-        <programlisting role="example"><![CDATA[ 
-[X,U,Y,XP]=steadycos(scs_m,X,U,Y,Indx,Indu,Indy [,Indxp [,param ] ])
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+// loading data
+exec("SCI/modules/xcos/tests/unit_tests/PENDULUM_ANIM.sci");
+exec("SCI/modules/xcos/tests/unit_tests/anim_pen.sci");
+importXcosDiagram("SCI/modules/xcos/tests/unit_tests/pendulum_anim45.zcos");
+
+// configure the context
+M  = 10;
+m  = 3;
+l  = 3;
+ph = 0.1;
+z0 = -4;
+th0 = .02;
+
+// look for the specific sub-diagram to work on
+for i=1:length(scs_m.objs)
+    if typeof(scs_m.objs(i))=="Block" & scs_m.objs(i).gui=="SUPER_f" then
+        scs_m = scs_m.objs(i).model.rpar;
+        break;
+    end
+end
+
+[X,U,Y,XP] = steadycos(scs_m,[],[],[],[],1,1:$);
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection id="Parameters_steadycos">
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">scs_m :</emphasis> a xcos データ構造体
+                    
+                    <emphasis role="bold">scs_m :</emphasis> xcosデータ構造体
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">X:</emphasis> 列ベクトル. 連続時間状態変数. 
+                    
                     0の場合には [] を指定可能.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">U:</emphasis> 列ベクトル. 入力. 0の場合には [] を指定可能.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Y:</emphasis> 列ベクトル. 出力. 0の場合には [] を指定可能.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Indx :</emphasis> 固定しないXのエントリの添字.
+                    
                     全て変化する場合, 1:$ としてください:
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Indu :</emphasis> 固定しないUのエントリの添字.
+                    
                     全て変化する場合, 1:$ としてください
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Indy :</emphasis> 固定しないYのエントリの添字.
+                    
                     全て変化する場合, 1:$ としてください
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Indxp :</emphasis> ゼロにする必要がないXP (xの微係数))のエントリの添字. 
+                    
                     全て変化する場合, 1:$ としてください. デフォルト: [].
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">param :</emphasis> 
+                    
                     2つの要素を有するリスト  (デフォルト: list(1.d-6,0)). 
+                    
                     param(1): スカラー. 線形化用の擾乱の大きさ; 以下の変動が使用されます
+                    
                     del([x;u])_i = param(1)+param(1)*1d-4*abs([x;u])_i. 
+                    
                     param(2): スカラー. 時刻 t.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">X:</emphasis> 状態変数 Xの定常値
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">U:</emphasis> 入力 Uの定常値
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">Y:</emphasis> 計算した定常状態に対応する出力
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">XP :</emphasis> 計算した定常状態に対応する状態変数の微係数
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Filecontent_steadycos">
+        
         <title>ファイルの内容</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para> SCI/modules/scicos/macros/scicos_auto/steadycos.sci</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="SeeAlso_steadycos">
+        
         <title>参照</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="lincos">lincos - xcosダイアグラムで記述された一般の動的システムから線形化により線形状態空間モデルを構築する (Scilab 関数)</link>
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="scicos_simulate">scicos_simulate - xcosシミュレーションをバッチモードで実行する関数 (Scilab 関数)</link>
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos - ブロックダイアグラムエディタおよびハイブリッドシミュレータのGUI (Scilab 関数)</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+
index d8df776..20b86d6 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scicos
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="scicos_graphics">
+    
     <refnamediv>
+        
         <refname>scicos_graphics</refname>
+        
         <refpurpose>graphics構造体を定義</refpurpose>
+        
     </refnamediv>
+    
     <refsection id="Module_scicos_graphics">
+        
         <title>Module</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="graphics_scicos_graphics">
+        
         <title>graphics</title>
+        
         <para>
+            
             ブロックの機能に関するグラフィック情報を有するScilabオブジェクト.
+            
         </para>
+        
         <para>
+            
         </para>
+        
         <para>
+            
         </para>
+        
         <para>
+            
             大きさ : 14.
+            
         </para>
+        
         <para>
+            
             型 : scilabリスト.
+            
         </para>
+        
         <para>
+            
+            
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">orig</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル [xo,yo], ただし, xo はブロック原点のx座標,
+                    
                     yoはブロック原点のy座標です.
+                    
                 </para>
+                
                 <para> 
+                    
                     [xo,yo] はブロック外形の左下の点の座標です.
+                    
                 </para>
+                
                 <para>
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 2.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数行ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">sz</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル [w,h], ただし, w はブロックの幅,hはブロックの高さです.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 2.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数行ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">flip</emphasis>
+                    
                 </para>
+                
                 <para> ブロックの向きを設定します. trueの場合,
+                    
                     入力ポートがボックスの左側,出力ポートが右側となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     trueの場合,
+                    
                     入力ポートがボックスの左側,出力ポートが右側となります.
+                    
                     falseの場合,
+                    
                     入力ポートがボックスの右側,出力ポートが左側となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 1.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 論理値.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">theta</emphasis>
+                    
                 </para>
+                
                 <para> Scicosオブジェクトの角度を設定します.</para>
+                
                 <para> この値の単位は度で,[-360,360]の範囲です.</para>
+                
                 <para> 
+                    
                     大きさ : 1.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : real.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">exprs</emphasis>
+                    
                 </para>
+                
                 <para> ブロックのダイアログボックスで使用されるformal式を有する文字列.</para>
+                
                 <para> 
+                    
                     大きさ : formal式の数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">pin</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル. pin(i) はi番目の標準入力ポートに接続された
+                    
                     リンクの数(1から開始)です. このポートに接続されていない場合, 0となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 標準入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">pout</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル. pout(i) はi番目の標準出力ポートに接続された
+                    
                     リンクの数(1から開始)です. このポートに接続されていない場合, 0となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 標準出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">pein</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル. pein(i) はi番目のイベント入力ポートに接続された
+                    
                     リンクの数(1から開始)です. このポートに接続されていない場合, 0となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : イベント入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">peout</emphasis>
+                    
                 </para>
+                
                 <para> ベクトル. peout(i) はi番目のイベント出力ポートに接続された
+                    
                     リンクの数(1から開始)です. このポートに接続されていない場合, 0となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : イベント出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">gr_i</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     ブロックのグラフィック表現をカスタマイズするScilabグラフィック式を
+                    
                     有する文字列.このフィールドはIcon sub_menuで設定できます.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : -.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">id</emphasis>
+                    
                 </para>
+                
                 <para> ブロックのIDを有する文字列. この文字列はダイアグラムの
+                    
                     ブロックの下に表示されます.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 1.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">in_implicit</emphasis>
+                    
                 </para>
+                
                 <para>'E'または'I'を要素とする文字列ベクトル.
+                    
                 </para>
+                
                 <para> 'E' および 'I' はそれぞれ
+                    
                     陽的(explicit),陰的(implicit)を意味し,このベクトルは
+                    
                     各入力ポートの特性を示します.
+                    
                     (陰的でない)標準ブロックの場合,このブロックは
+                    
                     空または"E"のみとなります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : NULLまたは標準入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">out_implicit</emphasis>
+                    
                 </para>
+                
                 <para>'E'または'I'を要素とする文字列ベクトル.</para>
+                
                 <para>'E' および 'I' はそれぞれ
+                    
                     陽的(explicit),陰的(implicit)を意味し,このベクトルは
+                    
                     各出力ポートの特性を示します.
+                    
                     (陰的でない)標準ブロックの場合,このブロックは
+                    
                     空または"E"のみとなります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : NULLまたは標準出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">in_style</emphasis>
+                    
+                </para>
+                
+                <para> JGraphX キー/値形式プロパティを含む文字列ベクトル.</para>
+                
+                <para>
+                    
+                    これらのスタイルは, テキストを配置または
+                    
+                    ポートの外観(例: 丸み, 緑のポート)を変更する際に使用できます.
+                    
+                    セミコロンで区切った キー=値 の集合で設定します.
+                    
+                    例えば, 丸く緑のポートの場合, 
+                    
+                    <literal>"shape=ellipse;fillColor=green"</literal>
+                    
+                </para>
+                
+                <para> 
+                    
+                    大きさ : ヌルまたは標準入力ポートの数.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列の列ベクトル.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">out_style</emphasis>
+                    
+                </para>
+                
+                <para> JGraphX キー/値形式プロパティを含む文字列ベクトル.</para>
+                
+                <para>
+                    
+                    これらのスタイルは, テキストを配置または
+                    
+                    ポートの外観(例: 丸み, 緑のポート)を変更する際に使用できます.
+                    
+                    セミコロンで区切った キー=値 の集合で設定します.
+                    
+                    例えば, 丸く緑のポートの場合, 
+                    
+                    <literal>"shape=ellipse;fillColor=green"</literal>           
+                    
+                </para>
+                
+                <para> 
+                    
+                    大きさ : ヌルまたは標準出力ポートの数.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列の列ベクトル.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">in_label</emphasis>
+                    
+                </para>
+                
+                <para> ポートラベルを含む文字列ベクトル.</para>
+                
+                <para>これらのラベルはテキストを更新または情報をトレースする際に使用できます.</para>
+                
+                <para> 
+                    
+                    大きさ : ヌルまたは標準入力ポートの数.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列の列ベクトル.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">out_label</emphasis>
+                    
+                </para>
+                
+                <para> ポートラベルを含む文字列ベクトル.</para>
+                
+                <para>これらのラベルはテキストを更新または情報をトレースする際に使用できます.</para>
+                
+                <para> 
+                    
+                    大きさ : ヌルまたは標準出力ポートの数.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列の列ベクトル.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">style</emphasis>
+                    
+                </para>
+                
+                <para> 文字列.</para>
+                
+                <para> JGraphX キー/値形式のプロパティを有する文字列ベクトル.</para>
+                
+                <para>
+                    
+                    これらのスタイルは,テキストを配置したり,ブロックの外観(例: 外形, 画像, テキスト)
+                    
+                    を変更する際に使用できます.
+                    
+                    セミコロンで区切った キー=値 の集合で設定します.
+                    
+                    例えば, 丸く緑のブロックの場合, 
+                    
+                    <literal>"shape=ellipse;fillColor=green"</literal>
+                    
+                </para>
+                
+                <para> 
+                    
+                    大きさ : ヌルまたは 1.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列.
+                    
+                </para>
+                
+            </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Filecontent_scicos_graphics">
+        
         <title>ファイルの実体</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para> SCI/modules/scicos/macros/scicos_scicos/scicos_graphics.sci</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+
index 81a64de..3b95eff 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scicos
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="scicos_model">
+    
     <refnamediv>
+        
         <refname>scicos_model</refname>
+        
         <refpurpose>モデルの構造を定義</refpurpose>
+        
     </refnamediv>
+    
     <refsection id="Module_scicos_model">
+        
         <title>モジュール</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="model_scicos_model">
+        
         <title>モデル</title>
+        
         <para>
+            
             コンパイル時に使用されるブロックの機能を有するScilabリスト.
+            
         </para>
+        
         <para>
+            
         </para>
+        
         <para>
+            
         </para>
+        
         <para>
+            
             大きさ : 23.
+            
         </para>
+        
         <para>
+            
             型 : Scilabリスト.
+            
         </para>
+        
         <para>
+            
+            
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">sim</emphasis>
+                    
                 </para>
+                
                 <para>
+                    
                     2つの要素を有するリスト.最初の要素は計算する関数((C, Fortran,または Scilab))の名前を有する文字列です.2番目の要素は計算する関数の型を指定する整数です.
+                    
                     現在,型4および5が使用されていますが,下位互換性を維持するためにより古い型も使用可能です.
+                    
                 </para>
+                
                 <para> 
+                    
                     過去のケースの中には, sim は文字列とすることができ,この場合typeは0と仮定されます.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 2.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : Scilabリスト.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">in</emphasis>
+                    
                 </para>
+                
                 <para>
+                    
                     標準入力ポートの最初の次元の数と大きさを指定するベクトル.添字は最上位から最下位.
+                    
                     入力ポートが存在しない場合 in==[] とします.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさは負,0または正とすることができます:
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>大きさが負の場合, コンパイラが適当な大きさを設定します.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>大きさが0の場合,コンパイラは
+                            
                             当該ベクトルの正の大きさを加算した次元に変更します
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>大きさが正の場合,その大きさが明示的に指定されます.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">in2</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     標準入力ポートの2番目の次元を指定するベクトル.添字は最上位から最下位.
+                    
                 </para>
+                
                 <para> 
+                    
                     in2が指定された場合,標準入力の大きさは行列となります.
+                    
                 </para>
+                
                 <para> 互換性維持のため,この次元は空([])を指定することができます.
+                    
                 </para>
+                
                 <para> これは入力ポートの次元を in,1 とすることを意味します.
+                    
                     大きさは負,0または正とすることができます:
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>大きさが負の場合,コンパイラが適当な大きさを設定します.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>大きさが0の場合,コンパイラがベクトル内の正の大きさを
+                            
                             加算した次元に変更します.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>大きさが正の場合,その大きさが明示的に使用されます.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">intyp</emphasis>
+                    
                 </para>
+                
                 <para> 標準入力ポートの型を指定するベクトル.</para>
+                
                 <para> 大きさはinの大きさと同じです.</para>
+                
                 <para> 標準入力ポートの型は以下のどれかとします :
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>1  実数行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>2  複素行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>3  int32 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>4  int16 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>5  int8 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>6  uint32 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>7  uint16 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>8  uint8 行列.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準入力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">out</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     標準出力ポートの最初の次元の数と大きさを指定するベクトルで,
+                    
                     ブロックの上から下方向に添字がふられます.
+                    
                     出力ポートがない場合, out == [] となります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ(size)は負,ゼロまたは正とすることができます:
+                    
+                    
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>ある大きさが負の場合, コンパイラが適当な大きさを指定します.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             ある大きさがゼロの場合, コンパイラが
+                            
                             このベクトルに存在する
+                            
                             大きさが正の要素を加算したものに修正します.
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>ある大きさが正の場合,その大きさが
+                            
                             明示的に指定されます.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型: 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">out2</emphasis>
+                    
                 </para>
+                
                 <para>
+                    
                     通常の出力ポートの2番目の次元を指定するベクトルで,ブロックの最上位から最下位に添字が付けられます.
+                    
                 </para>
+                
                 <para> 
+                    
                     out2が作成されて出力された後,
+                    
                     通常の出力の大きさを表す行列が作成されます.
+                    
                 </para>
+                
                 <para> 互換性のため, この次元は空 ([]) のままとすることも可能です.
+                    
                     これは,出力ポートの次元が out,1 となることを意味します.
+                    
                     この次元を負,ゼロまたは正とすることが可能です:
+                    
+                    
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>ある大きさ負の場合, コンパイラは適当な大きさを見つけようとします.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             ある大きさがゼロの場合, コンパイラは
+                            
                             このベクトルにあった全ての正の大きさを加算したもので
+                            
                             この次元を更新します.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             サイズがゼロより大きい場合, サイズは明示的に指定されています.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">outtyp</emphasis>
+                    
                 </para>
+                
                 <para> 標準出力ポートの型を指定するベクトル.</para>
+                
                 <para> 大きさは出力サイズに等しくなります.</para>
+                
                 <para> 標準出力ポートの型は以下のいずれかとなります :
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>1  実数行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>2  複素数行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>3  int32 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>4  int16 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>5  int8 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>6  uint32 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>7  uint16 行列,
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>8  uint8 行列.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 標準出力ポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">evtin</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     アクティベーション入力の数と大きさを指定するベクトル.
+                    
                     現在,アクティベーションポートは大きさ1に限定されています.
+                    
                 </para>
+                
                 <para> イベント入力ポートが存在しない場合, evtin を [] とする
+                    
                     必要があります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 入力イベントポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">evtout</emphasis>
+                    
                 </para>
+                
                 <para> アクティベーション出力の数と大きさを指定するベクトル.</para>
+                
                 <para> 現在,アクティベーションポートは大きさ1に限定されています.</para>
+                
                 <para> イベント出力ポートが存在しない場合, evtout を [] とする必要があります.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 出力イベントポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">state</emphasis>
+                    
                 </para>
+                
                 <para> 連続時間状態量の初期値を有するベクトル.</para>
+                
                 <para> 連続時間状態量がない場合, [] とする必要があります.</para>
+                
                 <para> 
+                    
                     大きさ : 連続時間状態量の数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">dstate</emphasis>
+                    
                 </para>
+                
                 <para> 離散時間状態量の初期値を有するベクトル.</para>
+                
                 <para> 離散状態量がない場合, [] とする必要があります.</para>
+                
                 <para> 
+                    
                     大きさ : 離散時間状態量の数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">odstate</emphasis>
+                    
                 </para>
+                
                 <para>オブジェクト状態量の初期値を有するリスト.</para>
+                
                 <para> オブジェクト状態量がない場合, list() を指定します.</para>
+                
                 <para> 
+                    
                     オブジェクト状態量は任意の型のScilab変数とすることができます.
+                    
                 </para>
+                
                 <para>
+                    
                     4型 (Cブロック)の計算用関数の場合,
+                    
                     実数, 複素数, int32, int16 ,int8 ,uint32, uit16 および uint8
+                    
                     の行列を含む要素のみが正しく読み書きされます.
+                    
                 </para>
+                
                 <para>
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : オブジェクト状態の数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : scilabオブジェクトのscilabリスト.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">rpar</emphasis>
+                    
                 </para>
+                
                 <para> 浮動小数点ブロックパラメータのベクトル.</para>
+                
                 <para> 浮動小数点パラメータがない場合は [] を指定します.</para>
+                
                 <para> 
+                    
                     大きさ : 実数パラメータの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ipar</emphasis>
+                    
                 </para>
+                
                 <para> 整数ブロックパラメータのベクトル.</para>
+                
                 <para> 整数パラメータがない場合は [] を指定します.</para>
+                
                 <para> 
+                    
                     大きさ : 整数パラメータの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">opar</emphasis>
+                    
                 </para>
+                
                 <para> オブジェクトブロックパラメータのリスト. オブジェクトパラメータがない場合, list() を指定します.
+                    
                 </para>
+                
                 <para> 
+                    
                     オブジェクトパラメータは任意のscilab変数とすることができます.
+                    
                 </para>
+                
                 <para>
+                    
                     4型 (Cブロック)の計算用関数の場合,
+                    
                     実数, 複素数, int32, int16 ,int8 ,uint32, uit16 および uint8
+                    
                     の行列を含む要素のみが正しく読み込みされます.
+                    
                 </para>
+                
                 <para>
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : オブジェクトパラメータの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : scilabオブジェクトのリスト.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">blocktype</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     標準ブロックの場合,文字  'c' または 'd' を指定できます. 
+                    
                     シミュレーション時にコールされる計算用関数として指定する場合は,
+                    
                     このブロックが状態量の微係数の計算に寄与しない場合でも,'x' を使用します.
+                    
                 </para>
+                
                 <para> 'l', 'm' および 's' は予約されており,使用できません.</para>
+                
                 <para> 
+                    
                     大きさ : 1.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">firing</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     アクティベーション出力ポート(evout参照)の数と等しい大きさの
+                    
                     初期化イベントの起動時間のベクトル.
+                    
                     出力初期化イベント(何らかの入力イベントが発生する前に生成されたイベント)の日付を有します.
+                    
                     負の値は対応するポートに初期化イベントが設定されないことを意味します.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 出力イベントポートの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 実数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">dep_ut</emphasis>
+                    
                 </para>
+                
                 <para> 論理値ベクトル [dep_u, dep_t].</para>
+                
                 <para> 
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>
-                            <emphasis role="bold">dep_u</emphasis>
+                            
+                            <emphasis role="bold">dep_t</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             ブロックが常にアクティブな場合に true.
+                            
                         </para>
+                        
                         <para>
-                            (出力は時間の連続性に依存)
-                        </para>
+                            
+                            出力は時間の連続性に依存します.
+                            
+                            例えば, GENSIN_f ブロックは<code>y=sin(t)</code>を計算するため,
+                            
+                            <code>dep_ut=[%f %t]</code>.
+                            
+                        </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
-                            <emphasis role="bold">dep_t</emphasis>
+                            
+                            <emphasis role="bold">dep_u</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             ブロックが直達項を有する,
+                            
                             つまり,少なくとも1つの出力が(状態量を通じてではなく)直接入力に依存している,
+                            
                             場合にtrue.
+                            
                             言い換えると,計算用関数がフラグ1を指定してコールされた場合,
+                            
                             ある入力の値は出力の計算に使用されます.
+                            
+                            例えば, SUM_f ブロックは <code>y=u1+u2</code> を計算するため,
+                            
+                            <code>dep_ut=[%t %f]</code>.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 2.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 論理値ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">label</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     ラベルを定義する文字列.
+                    
                     シミュレーション時にパラメータにアクセスまたは修正する際に特定のブロックを指定するために
+                    
                     使用できます.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : 1.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 文字列.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">nzcross</emphasis>
+                    
                 </para>
+                
                 <para> ゼロと交差する面の数.</para>
+                
                 <para> 
+                    
                     大きさ : ゼロと交差する面の数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">nmode</emphasis>
+                    
                 </para>
+                
                 <para> 
+                    
                     モードレジスタの長さ.これはベクトルモードの大きさを指定するもので,
+                    
                     ブロックが動作可能なモードの総数ではないことに注意してください.
+                    
                     あるブロックが3個のモードを有し,各モードが2つの値をとることができると,
+                    
                     このブロックは最大 2^3=8個のモードを有します.
+                    
                 </para>
+                
                 <para> 
+                    
                     大きさ : モードの数.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : 整数の列ベクトル.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">equations</emphasis>
+                    
                 </para>
+                
                 <para> 陰的なブロックで使用される.</para>
+                
                 <para> 
+                    
                     modelicaコードの説明を有するmodelica型のデータ構造体.
+                    
                     このリストは以下の4個のエントリを有します:
+                    
+                    
+                    
                 </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             <emphasis role="bold">model</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             modelica関数を有するファイルの名前を指定する文字列.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             <emphasis role="bold">inputs</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             入力として使用されるmodelica変数の名前を有する文字列の列ベクトル.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             <emphasis role="bold">outputs</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             出力として使用されるmodelica変数の名前を有する文字列の列ベクトル.
+                            
                         </para>
+                        
                         <para>
+                            
+                            
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>
+                            
                             <emphasis role="bold">parameters</emphasis>
+                            
                         </para>
+                        
                         <para>
+                            
                             2個のエントリのリスト. 最初のエントリはパラメータとして使用されるmodelica変数の
+                            
                             名前の文字列のベクトル,2番目のエントリはパラメータの値を有するリストです.
+                            
                         </para>
+                        
                         <para>
+                            
                             パラメータとしても使用できるmodelica状態量の名前.
+                            
                             この場合,パラメータと状態量を区別するために
+                            
                             3番目のエントリが使用されます.
+                            
                         </para>
+                        
                         <para>
+                            
                             例 :
+                            
                             mo.parameters=list(['C','v'],list(C,v),[0,1])
+                            
                             は,'C' が 値Cの parameter(0) , 'v'が初期値vの
+                            
                             state(1)であることを意味します.
+                            
                         </para>
+                        
                         <para>
+                            
                         </para>
+                        
                         <para>           
+                            
                         </para>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
                 <para> 
+                    
                     大きさ : 5.
+                    
                 </para>
+                
                 <para>
+                    
                     型 : scilabリスト.
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">uid</emphasis>
+                    
+                </para>
+                
+                <para>
+                    
+                    ブロックの文字列のユニークなID (ホストあたり 2^16)
+                    
+                </para>
+                
+                <para>
+                    
+                    このIDは, Xcos GUIでのみ設定されます.
+                    
+                    ブロック作成時に特定の値を設定するには,
+                    
+                    以下のコードを使用します :
+                </para>
+                
+                <programlisting role="example">
+                    
+                    jimport("java.rmi.server.UID");
+                    
+                    juid =  jnewInstance("java.rmi.server.UID");
+                    
+                    uid = juid.toString()
+                    
+                </programlisting>
+                
+                <para> 
+                    
+                    大きさ : 1x1.
+                    
+                </para>
+                
+                <para>
+                    
+                    型 : 文字列.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Filecontent_scicos_model">
+        
         <title>ファイルの実体</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para> SCI/modules/scicos/macros/scicos_scicos/scicos_model.sci</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+
index 3db409b..1330674 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Copyright (C) DIGITEO - Scilab Consortium (XML Docbook version)
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="xcos">
+    
     <refnamediv>
+        
         <refname>xcos</refname>
+        
         <refpurpose>ハイブリッドシミュレータ用のブロック図エディタおよびGUI</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>xcos(filename)
+        
+        <synopsis>
+            
+            xcos()
+            
+            xcos(filename)
+            
             xcos(scs_m_list)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection id="Module_xcos">
+        
         <title>モジュール</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <link linkend="xcos">xcos</link>
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
-    <refsection id="Description_xcos">
-        <title>説明</title>
-        <para>Xcos はハイブリッド動的システムのモデル構築用の
-            ビジュアルエディタです.
-        </para>
-        <para>引数を指定せずにXcosを起動すると空のXcosウインドウがオープンされます.
-            ここで,XcosのGUIを用いてモデルを作成,読み込み,保存,コンパイルすることができます.
-            Xcosは様々なブロックダイアグラムコンパイラおよびハイブリッドシミュレータ scicosim
-            へのインターフェイスとして動作します.
-        </para>
-        <programlisting role="example"> 
-            xcos('mydiagram.zcos')
-        </programlisting>
-    </refsection>
+    
     <refsection id="Parameters_xcos">
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">filename : </emphasis> 
-                    図形ファイル(拡張子: .cos, .cosf または .zcos)のパスを有する文字列.
-                    入力引数を指定しない場合,空のダイアグラム(デフォルト名:Untitled)がオープンされます.
+                    
+                    ダイアログファイル (拡張子: .cos, .cosf または .zcos)のパスを有する文字列.
+                    
+                    入力引数が使用されない場合,
+                    
+                    空のダイアグラムがオープンされます
+                    
+                    (デフォルト名: Untitled).
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">scs_m_list : </emphasis>
-                    編集後のXcos図の構造体.
+                    
+                    編集後の<emphasis>Xcos</emphasis>ダイアグラム構造体.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
-    <refsection id="Example_xcos">
-        <title>例</title>
-        <programlisting role="example"> 
-            // 新しいダイアグラムをオープン
-            xcos();
-            xcos
-            // ダイアグラムを読み込む
-            xcos SCI/scicos/demos/bounce.cosf; 
-            // 構造体を読み込む
-            load('mondiagr.cos'); 
-            xcos(scs_m);
-        </programlisting>
-    </refsection>
-    <refsection id="SeeAlso_xcos">
-        <title>参照</title>
+    
+    <refsection id="Description_xcos">
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <emphasis>Xcos</emphasis>はハイブリッド動的システムのモデル構築用の
+            
+            ビジュアルエディタです.
+            
+            モデルは, <emphasis>Xcos</emphasis> のGUIにより,
+            
+            結合, 読み込み, 保存, コンパイル, シミュレートできます.
+            
+            <emphasis>Xcos</emphasis>は様々なブロックダイアグラムコンパイラおよびハイブリッドシミュレータ
+            
+            <link linkend="scicosim">scicosim</link>へのインターフェイスとして動作します.
+            
+        </para>
+        
+        <para>
+            
+            <emphasis>Xcos</emphasis>環境には以下の要素があります:
+            
+        </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">エディタ</emphasis>
+                    
+                </para>
+                
                 <para>
-                    <link linkend="scicosim">scicosim - Scicos (バッチ) シミュレーション関数
-                        (Scilab 関数)
-                    </link>
+                    
+                    エディタにより,パレットで定義されたブロックから動的システムを表す
+                    
+                    フローチャートを設計することが可能となります.
+                    
+                    ユーザは標準ブロックをカスタマイズして, 新しいブロックを定義できます.
+                    
                 </para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">パレットブラウザ</emphasis>
+                    
+                </para>
+                
                 <para>
-                    <link linkend="scicos_simulate">scicos_simulate - 
-                        xcosシミュレーションをバッチモードで実行するための関数
-                        (Scilab関数)
-                    </link>
+                    
+                    パレットブラウザは, 全ての Xcos 標準ブロックを
+                    
+                    カテゴリ(信号処理, 電気, 水力, 微分, 積分, 等)によりグループ化して一覧を示します.
+                    
+                    以下の図を参照ください.
+                    
                 </para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <link linkend="xcos_menu_entries">メニューエントリ</link>
+                    
+                    <emphasis role="bold">コンパイラ/シミュレータ</emphasis>
+                    
                 </para>
+                
+                <para>
+                    
+                    Xcos 環境により, 
+                    
+                    離散, 連続, シンボル方程式(Modelica)により定義された,等, および
+                    
+                    上記の機能を組み合わせた混合システムの
+                    
+                    複雑なシステムのモデル構築からシミュレーションまでが可能になります.
+                    
+                    シミュレーションの結果のデータはリアルタイムでグラフィック表示でき,
+                    
+                    Scilabでポスト処理に使用することができます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        <para/>
+        
+        <para>
+            
+            ツールバーアイコンでxcosを起動するには,
+            
+            <inlinemediaobject>
+                
+                <imageobject>
+                    
+                    <imagedata fileref="../../../gui/images/icons/32x32/apps/utilities-system-monitor.png"/>
+                    
+                </imageobject>
+                
+            </inlinemediaobject>
+            
+            Scilabメインウインドウの<emphasis>アプリケーション</emphasis>の
+            
+            <emphasis>Xcos</emphasis>メニュー要素,または,
+            
+            空の<emphasis>Xcos</emphasis>ウインドウをオープンする以下の例のようにします.
+            
+        </para>
+        
+        <para/>
+        
+        <programlisting role="example">
+            
+            xcos
+            
+        </programlisting>
+        
+        <para/>
+        
+        <mediaobject>
+            
+            <imageobject>
+                
+                <imagedata fileref="../gui/xcos/en_US/xcos_gui.png"/>
+                
+            </imageobject>
+            
+        </mediaobject>
+        
+        <para>
+            
+            既存のダイアグラムをオープンするには,この例のように
+            
+            有効なファイル名を指定する必要があります:
+            
+        </para>
+        
+        <para/>
+        
+        <programlisting role="example"><![CDATA[xcos("SCI/modules/xcos/demos/bounce.zcos")]]></programlisting>
+        
+        <para>
+            
+            この例では,<emphasis>Xcos</emphasis>ウインドウがオープンされ,
+            
+            <emphasis>bounce.zcos</emphasis>デモのダイアグラムが表示されます.
+            
+        </para>
+        
+        <para/>
+        
+        <para>
+            
+            あるダイアグラム構造体が <emphasis>Scilab</emphasis>ワークスペースに存在する場合,
+            
+            この例のようにオープンすることができます:
+            
+        </para>
+        
+        <para/>
+        
+        <programlisting role="example"><![CDATA[
+loadXcosLibs();
+
+// define diagram structure
+scs_m = scicos_diagram();
+scs_m.props.title = "Imported diagram";
+scs_m.objs(1) = SUMMATION("define");
+scs_m.objs(1).graphics.sz = [30 50];
+
+xcos(scs_m);]]></programlisting>
+        
+        <para>
+            
+            ただし,<emphasis>scs_m</emphasis> は<emphasis>bounce.zcos</emphasis>のダイアグラム構造体です.
+            
+        </para>
+        
+        <para>
+            
+            <emphasis>Xcos</emphasis> エディタと同時に開いた
+            
+            パレットブラウザで提供されるブロックを結合することにより
+            
+            モデルを構築します.
+            
+            このウインドウは以下のような外観になります.
+            
+        </para>
+        
+        <para/>
+        
+        <mediaobject>
+            
+            <imageobject>
+                
+                <imagedata fileref="../gui/xcos/en_US/xcos_palette_gui.png"/>
+                
+            </imageobject>
+            
+        </mediaobject>
+        
+        <para/>
+        
+        <para>
+            
+            ウインドウの左の部分にある <emphasis>パレット</emphasis> タイトルを
+            
+            クリックすることにより表示されるパレットをカスタマイズすることができます.
+            
+            パレットウインドウは,パレットを個別に選択/非選択できる選択リストを表示します.
+            
+            前の画面に戻るには, パレットのタイトルをクリックします.
+            
+        </para>
+        
+        <para/>
+        
+        <mediaobject>
+            
+            <imageobject>
+                
+                <imagedata fileref="../gui/xcos/en_US/xcos_palette_select_gui.png"/>
+                
+            </imageobject>
+            
+        </mediaobject>
+        
+        <para>
+            
+            Xcos はModelicaに基づくモデル用,およびユーザ定義のブロックおよびコード生成用に
+            
+            Cコンパイラを必要とします.
+            
+        </para>
+        
+        <para>
+            
+            サポートされるコンパイラをインストールすることが推奨されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+xcos();
+xcos(SCI+"/modules/xcos/demos/Discrete-KalmanFilter.zcos");
+scs_m = scicos_diagram();
+scs_m.objs($+1) = BIGSOM_f("define");
+xcos(scs_m);
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection id="SeeAlso_xcos">
+        
+        <title role="see also">参照</title>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <link linkend="scicosim">scicosim</link>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <link linkend="scicos_simulate">scicos_simulate</link>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <link linkend="xcos_menu_entries">Menu entries</link>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <link linkend="supported_compilers">Supported compilers</link>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+
diff --git a/scilab/modules/xcos/help/ja_JP/xcos_debug_gui.xml b/scilab/modules/xcos/help/ja_JP/xcos_debug_gui.xml
new file mode 100644 (file)
index 0000000..5c460e6
--- /dev/null
@@ -0,0 +1,263 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA - Serge Steer
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+
+
+<refentry xml:id="xcos_debug_gui" xml:lang="ja"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:scilab="http://www.scilab.org"
+          xmlns:ns4="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook">
+    
+    <refnamediv>
+        
+        <refname>xcos_debug_gui</refname>
+        
+        
+        
+        <refpurpose>
+            
+            Debug Xcosブロックで使用される対話的デバッグ機能
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        
+        
+        <para>
+            
+            Xcos Debug ブロックにより 
+            
+            シミュレーション時に各ブロックの
+            
+            実行前および実行後に実行されるScilab命令を設定できるように
+            
+            なります.
+            
+            Debugブロック命令用xcos_debug_gui()命令を設定することにより,
+            
+            シミュレーション開始時にグラフィックユーザインターフェイス
+            
+            がオープンされます.
+            
+            このGUIにより対話的デバッグが可能となります.
+            
+            特にシミュレーションを中断させる条件(ブレークポイント)を
+            
+            動的に指定することができるようになります.
+            
+            ブレークポイントで中断した際に, ユーザは
+            
+            ブロックの
+            
+            カレントの値, 状態, 入力, ....を調べることができます.
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            いつでも, ユーザは以下の累積条件の集合によりブレークポイントを
+            
+            指定することができます:
+            
+        </para>
+        
+        
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>
+                    
+                    カレントのブロックがコールされたフラグの値
+                    
+                </para>
+                
+            </listitem>
+            
+            
+            
+            <listitem>
+                
+                <para>カレントの日付の値</para>
+                
+            </listitem>
+            
+            
+            
+            <listitem>
+                
+                <para>
+                    
+                    ブレークがブロックコールの前に起きたかどうか
+                    
+                </para>
+                
+            </listitem>
+            
+            
+            
+            <listitem>
+                
+                <para>
+                    
+                    Scilab論理式の値により,
+                    
+                    ブレークは条件がtrueに評価された場合に
+                    
+                    アクティブになります.
+                    
+                    この式では,
+                    
+                    カレントのブロック要素と
+                    
+                    Scilab関数 
+                    
+                    <link      linkend="curblock">curblock</link> および 
+                    
+                    <link linkend="scicos_time">scicos_time</link>
+                    
+                    を有する
+                    
+                    ブロック変数 <link linkend="C_struct">C_struct</link> 
+                    
+                    を使用できます.
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        
+        
+        <mediaobject>
+            
+            <imageobject>
+                
+                <imagedata fileref="../images/Xcos_Debug.png" format="PNG"/>
+                
+            </imageobject>
+            
+        </mediaobject>
+        
+        
+        
+        <para>
+            
+            シミュレーションが中断した場合, 
+            
+            グラフィックユーザインターフェイスが
+            
+            カレントの時間とカレントのフラグの値,
+            
+            ブロック番号とスーパーブロック階層におけるブロックのパス
+            
+            を表示します.
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            "Next" ボタンにより次の中断条件までシミュレーションが
+            
+            再実行されます
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            "End debug" ボタンにより条件が全て無効となり,
+            
+            シミュレーションが終了します
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            "Pause" ボタンにより,Scilabコンソール内で
+            
+            Scilab命令を実行するカレントのブロックに関連する
+            
+            ブロックデータ構造体を対話的に観測できるようになります.
+            
+            ユーザは戻る際に"return"命令を入力する必要があります.
+            
+        </para>
+        
+    </refsection>
+    
+    
+    
+    
+    
+    <refsection>
+        
+        <title>著者</title>
+        
+        
+        
+        <simplelist type="vert">
+            
+            <member>Serge Steer, INRIA</member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>0.0</revnumber>
+                
+                
+                
+                <revdescription>関数 xcos_debug_gui が追加されました</revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+</refentry>
+
index 76d4c26..fc548f1 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Copyright (C) DIGITEO - Scilab Consortium (XML Docbook version)
  * 
  * 
  * See the file ./license.txt
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="xcos_menu_entries">
+    
     <refnamediv>
+        
         <refname>Menu_entries</refname>
-        <refpurpose>エディタのメニューエントリ</refpurpose>
+        
+        <refpurpose>Xcosエディタのメニューエントリ</refpurpose>
+        
     </refnamediv>
+    
+    <refsection id="Contents_xcos_menu_entries">
+        
+        <title>内容</title>
+        
+        <para>
+            
+            本節では
+            
+            <emphasis>Xcos</emphasis>エディタの全てのメニューエントリを簡単に
+            
+            紹介します.
+            
+            多くの要素が,マウスカーソルが
+            
+            ブロック,リンクまたはメイン<emphasis>Xcos</emphasis> ウインドウ
+            
+            にある時に右クリックして表示されるプルダウンメニューでも利用可能です.
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <link linkend="xcos_menu_entries">Xcosエディタメニューエントリ</link>
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <itemizedlist>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Filemenu_Menu_entries">Fileメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Editmenu_Menu_entries">Editメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Viewmenu_Menu_entries">Viewメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Simulatemenu_Menu_entries">Simulateメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Formatmenu_Menu_entries">Formatメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Toolsmenu_Menu_entries">Toolsメニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Helpmenu_Menu_entries">?メニュー</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <xref linkend="Seealso_Menu_entries">参照</xref>
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                </itemizedlist>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
     <refsection id="Filemenu_Menu_entries">
+        
         <title>Fileメニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_file.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:新規</emphasis>
-                </para>
+                    
+                    <emphasis role="bold">ファイル:新規 (Ctrl+N)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/document-new.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>
-                    アクティブな編集xcosウインドウに空のダイアグラムを読み込む際には,
-                    「新規ダイアグラム」メニューをクリックしてください.
-                    ウインドウの前の内容が保存されていない場合は,失われます.
+                    
+                    アクティブな編集<emphasis>Xcos</emphasis>ウインドウに
+                    
+                    空のダイアグラムを読み込む際には,
+                    
+                    <emphasis>New</emphasis>メニューをクリックしてください.
+                    
                     このメニューにより,新しいダイアグラムまたはパレットをオープンすることが
+                    
                     できます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:開く (Ctrl+o)</emphasis>
-                </para>
-                <para>保存されたブロックダイアグラムまたは
-                    パレットを有するアスキーまたはバイナリのファイルを読み込む際には,
-                    「開く」メニューを選択してください.
+                    
+                    <emphasis role="bold">ファイル:開く (Ctrl+O)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/document-open.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    保存されたブロックダイアグラムまたは
+                    
+                    パレットを有するXML (<emphasis>.zcos</emphasis>) 
+                    
+                    またはバイナリのファイルを読み込む際には,
+                    
+                    <emphasis>Open</emphasis>メニューを選択してください.
+                    
                     ダイアログボックスによりファイルを選択することができます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:保存 (Ctrl+s)</emphasis>
+                    
+                    <emphasis role="bold">ファイル:保存 (Ctrl+S)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/devices/media-floppy.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    ダイアグラムを <emphasis>XML</emphasis> ファイルに保存するには,
+                    
+                    <emphasis>Save</emphasis> メニュー要素を選択してください.
+                    
                 </para>
-                <para>前の「名前を付けて保存」で選択済みのバイナリファイルに
-                    ブロック図を保存する際には,「保存」メニューを選択してください.
-                    このメニュー項目を選択した時点で,
-                    まだ「名前を付けて保存」メニューをクリックしていない場合は,
-                    カレントのディレクトリに"window_name".cosという名前で保存されます.
-                    ただし,"window_name"はウインドウの最上部に表示されている
-                    ウインドウ名(通常は「無題」または「スーパーブロック」)です.
-                    .cos バイナリファイルは計算機に依存しません.
+                
+                <para>
+                    
+                    このメニュー要素を選択し, <emphasis>Save</emphasis>または
+                    
+                    <emphasis>Save As</emphasis>メニュー要素をクリックしていない場合,
+                    
+                    ダイアログによりディレクトリと拡張子を除くファイル名を選択することが
+                    
+                    できます.
+                    
+                    デフォルトの拡張子は, <emphasis>.zcos</emphasis>です.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:名前を付けて保存
-                        (Ctrl+Shift+s)
-                    </emphasis>
-                </para>
-                <para>ブロックダイアグラムまたはパレットをファイルに保存する際には,
-                    「名前を付けて保存」メニューを選択してください.
-                    ダイアログボックスによりファイルを選択することができます.
-                    ファイルの拡張子は .cos または .cosfとする必要があります.
-                    ダイアグラムはファイル名(拡張子無し)を指定します.
-                    拡張子が".cosf"の場合,バイナリではなく
-                    アスキー形式で保存されます.
-                    整形を伴なう保存は通常の保存よりも時間を要します.
+                    
+                    <emphasis role="bold">ファイル:名前を付けて保存 (Ctrl+Shift+S)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/document-save-as.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    Select the <emphasis>Save As</emphasis> menu item to save the block diagram or palette in a file with a new name.
+                    
                 </para>
+                
+                <para>
+                    
+                    A dialog box allows specifying a file name without the extension and a saving folder.
+                    
+                    The default extension is <emphasis>.zcos</emphasis>.
+                    
+                </para>
+                
+                <para>The diagram takes the name of the file (without the extension).</para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:エクスポート (Ctrl+e)</emphasis>
+                    
+                    <emphasis role="bold">ファイル:エクスポート (Ctrl+E)</emphasis>
+                    
                 </para>
+                
                 <para>
-                    このメニューは,カレントのxcosダイアグラムの図をエキスポートする
-                    際に使用されます.
-                    エキスポートは,ポストスクリプト形式に直接行うか,または
-                    まずグラフィックウインドウをエキスポートしたあとに
-                    Scilabが出力可能な任意の形式にエキスポートします.
-                </para>
+                    
+                    この要素は,カレントの<emphasis>Xcos</emphasis>ダイアグラムの
+                    
+                    図をエキスポートする際に使用されます.
+                    
+                    エクスポートは, 
+                    
+                    WBMP, GIF, HTML, JPEG, JPG, PNG, SVG または VML 形式で行われます.
+                    
+                </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ファイル:最近のファイル</emphasis>
+                    
                 </para>
+                
                 <para>このメニューにより,最近開いたファイルに簡単にアクセスすることができます.</para>
+                
             </listitem>
+            
             <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">ファイル:印刷 (Ctrl+P)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/document-print.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>
-                    <emphasis role="bold">ファイル:印刷 (Ctrl+p)</emphasis>
+                    
+                    カレントのダイアグラムをプリンタで印刷します.
+                    
                 </para>
-                <para>カレントのダイアグラムをプリンタで印刷します.</para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:閉じる (Ctrl+w)</emphasis>
+                    
+                    <emphasis role="bold">ファイル:閉じる (Ctrl+W)</emphasis>
+                    
                 </para>
-                <para>複数のダイアグラムがオープンされている場合,
+                
+                <para>
+                    
+                    複数のダイアグラムがオープンされている場合,
+                    
                     「閉じる」によりカレントのダイアグラムが閉じられます.
+                    
                     オープンされているダイアグラムが1つだけの場合,
-                    「閉じる」によりxcosが閉じられ,
+                    
+                    「閉じる」により<emphasis>Xcos</emphasis>が閉じられ,
+                    
                     (開かれている場合には)ビューポートおよびパレットも閉じられます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ファイル:終了 (Ctrl+q)</emphasis>
+                    
+                    <emphasis role="bold">ファイル:終了 (Ctrl+Q)</emphasis>
+                    
                 </para>
+                
                 <para>
+                    
                     複数のダイアグラムがオープンされている場合,
-                    「終了」により xcosが閉じられ,
+                    
+                    「終了」により <emphasis>Xcos</emphasis>が閉じられ,
+                    
                     (開かれている場合には)ビューポートおよびパレットも閉じられます.
+                    
                     このメニューにより全ての開かれているダイアグラムが
+                    
                     閉じられます.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Editmenu_Menu_entries">
+        
         <title>編集メニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_edit.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:元に戻す (Ctrl+z)</emphasis>
-                </para>
+                    
+                    <emphasis role="bold">編集:元に戻す (Ctrl+Z)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-undo.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>直近の編集操作を取り消すには「元に戻す」を選択します.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:やり直し (Ctrl+y)</emphasis>
-                </para>
+                    
+                    <emphasis role="bold">編集:やり直し (Ctrl+Y)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-redo.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>取り消した直近の編集操作を再度実行するには,
+                    
                     「やり直し」メニューを選択します.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:切り取り (Ctrl+x)</emphasis>
-                </para>
-                <para>選択されたオブジェクトをダイアグラムから削除し,
+                    
+                    <emphasis role="bold">編集:切り取り (Ctrl+X)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-cut.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    選択されたオブジェクトをダイアグラムから削除し,
+                    
                     オブジェクトがブロックの場合にクリップボードにコピーするには,
+                    
                     「切り取り」が使用されます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:コピー (Ctrl+c)</emphasis>
-                </para>
+                    
+                    <emphasis role="bold">編集:コピー (Ctrl+C)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-copy.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>
+                    
                     選択されたオブジェクトを
+                    
                     オブジェクトがブロックの場合にクリップボードにコピーするには,
+                    
                     「コピー」が使用されます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:貼り付け (Ctrl+v)</emphasis>
-                </para>
+                    
+                    <emphasis role="bold">編集:貼り付け (Ctrl+V)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-paste.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>「貼り付け」は,
+                    
                     クリップボード上にあるオブジェクトをダイアグラムに
+                    
                     配置します.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">編集:削除 (Delete)</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/edit-delete.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>ブロックまたはリンクを削除するには,
+                    
                     まず「削除」メニューを選択した後,
+                    
                     選択するオブジェクトを順に(左ボタンで)クリックします.
+                    
                     オブジェクトに結合された全てのリンクを削除した時点で,
+                    
                     そのオブジェクトも同時に削除されます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:全て選択 (Ctrl+a)</emphasis>
+                    
+                    <emphasis role="bold">編集:全て選択 (Ctrl+A)</emphasis>
+                    
                 </para>
+                
                 <para>カレントのダイアグラムのブロックを全て選択します.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">編集:選択範囲を反転</emphasis>
+                    
                 </para>
+                
                 <para>カレントの選択範囲を反転します.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">編集:ブロックパラメータ
-                        (Ctrl+b)
-                    </emphasis>
-                </para>
-                <para>選択されているブロックのブロック設定ウインドウを開きます.</para>
+                    
+                    <emphasis role="bold">編集:ブロックパラメータ (Ctrl+B)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/categories/applications-system.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    選択されているブロックのブロック設定ウインドウを開きます.
+                    
+                    設定は使用するブロックに依存します
+                    
+                    (設定の詳細についてはブロックヘルプを参照).
+                    
+                </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">編集:選択範囲をスーパーブロックに変換</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/object-group.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>選択されたブロックをスーパーブロックに変換します.</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Viewmenu_Menu_entries">
+        
         <title>表示メニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_view.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">表示:拡大 (Ctrl+plus)</emphasis>
-                </para>
-                <para>このメニューを選択すると,ダイアグラムが10%拡大されます.</para>
+                    
+                    <emphasis role="bold">表示:拡大 (Ctrl+Plus)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/zoom-in.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>このメニューを選択すると,ダイアグラムが10% 拡大されます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">表示:縮小
-                        (Ctrl+minus)
-                    </emphasis>
-                </para>
-                <para>このメニューを選択すると,ダイアグラムが10%縮小されます.</para>
+                    
+                    <emphasis role="bold">表示:縮小 (Ctrl+Minus)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/zoom-out.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>このメニューを選択すると,ダイアグラムが10% 縮小されます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:ビューをダイアグラムに合わせる</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/zoom-fit-drawing.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>このメニューを選択すると,ダイアグラムがカレントのウインドウの
+                    
                     大きさとなるよう調整されます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:通常 100%</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/zoom-original.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>ダイアグラムがこの作業範囲に合うように
+                    
                     作業範囲の大きさを調整します.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:パレットブラウザ</emphasis>
+                    
                 </para>
+                
                 <para>パレットブラウザを開きます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:ダイアグラムブラウザ</emphasis>
+                    
                 </para>
+                
                 <para>ダイアグラムのブロックの一覧を出力する
+                    
                     ウインドウを表示し,
-                    ブロックのscs_m構造体に関する情報を出力します.
+                    
+                    ブロックの<emphasis>scs_m</emphasis>構造体に関する情報を出力します.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:表示ポート</emphasis>
+                    
                 </para>
-                <para>表示ポートを表示します.表示ポートはカレントのダイアグラムの
+                
+                <para>
+                    
+                    表示ポートを表示します.表示ポートはカレントのダイアグラムの
+                    
                     イメージです.
+                    
                     この表示ポートにより,作業範囲をダイアグラムの一部に
+                    
                     移動することができます.
+                    
                 </para>
+                
                 <mediaobject>
+                    
                     <imageobject>
+                        
                         <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_viewport.png"/>
+                        
                     </imageobject>
+                    
                 </mediaobject>
-                <para>上の図に,ダイアグラムの一部を拡大するビューポートの例を
+                
+                <para>
+                    
+                    上の図に,ダイアグラムの一部を拡大するビューポートの例を
+                    
                     示します.右側のxcosウインドウは,ダイアグラムの拡大された部分を
+                    
                     表示しています.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">表示:詳細</emphasis>
+                    
                 </para>
+                
                 <para>ダイアグラムの選択されたブロックの一覧を示すウインドウを
+                    
                     表示し,これらのブロックのscs_m構造体に関する情報を出力します.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Simulatemenu_Menu_entries">
+        
         <title>シミュレーションメニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_simulation.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">シミュレーション:設定</emphasis>
-                </para>
-                <para>メインXcosウインドウにおいて,
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/categories/preferences-desktop.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    メインXcosウインドウにおいて,
+                    
                     設定メニューをクリックすると,
+                    
                     以下の積分パラメータを変更するための
+                    
                     ダイアログボックスが起動します:
+                    
                 </para>
+                
+                <para/>
+                
+                <mediaobject>
+                    
+                    <imageobject>
+                        
+                        <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_set_simulation_parameters_gui.png"/>
+                        
+                    </imageobject>
+                    
+                </mediaobject>
+                
+                <para/>
+                
                 <itemizedlist>
+                    
                     <listitem>
+                        
                         <para>積分終了時間 (積分はこの時間で終了します,
+                            
                             この値は常に0を基準とします)
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>実時間スケール(xcosの時間の単位を1秒に設定することにより
+                            
                             強制的にリアルタイムシミュレーションが実行されます)
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>絶対許容誤差および相対許容誤差 (ソルバーのプロパティ)</para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>時間許容値 (ODEソルバーが連続状態量を更新する際に使用される
+                            
                             積分間隔の最小値)
+                            
                         </para>
+                        
                     </listitem>
+                    
                     <listitem>
+                        
                         <para>最大積分時間間隔(各ソルバーのコール時の時間間隔の最大値で
+                            
                             エラーメッセージ"too many calls"が発生した場合はより小さな値と
+                            
                             する必要があります)
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <emphasis role="bold">ソルバ</emphasis>: 使用する数値ソルバーを選択. 
+                            
+                            常微分方程式 (ODE)ソルバまたは
+                            
+                            代数微分方程式ソルバ(IDA)のどちらかを選択します.
+                            
+                            使用するモデルがIDAソルバを必要とすると
+                            
+                            <emphasis>Xcos</emphasis> が検出した場合,
+                            
+                            <emphasis>Xcos</emphasis> はIDAソルバに自動的に切替える情報ボックスを
+                            
+                            表示します.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <emphasis role="bold">最大ステップサイズ</emphasis>: 
+                            
+                            ソルバにより使用される最大時間ステップ.
+                            
+                            このパラメータは単調なシステム応答においてローカルな
+                            
+                            特異性を探す際に有用です.
+                            
+                            この応答型の場合, 数値ソルバは, 計算時間を減らすために
+                            
+                            自動的にステップサイズを増加させます.
+                            
+                            システムがこのようなケースであると思われる場合,
+                            
+                            このパラメータの値を減らしてください.
+                            
+                        </para>
+                        
+                        <para/>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            <emphasis role="bold">コンテキストを設定</emphasis>: 以下の説明を参照
+                            
                         </para>
+                        
+                        <para/>
+                        
                     </listitem>
+                    
                     <listitem>
-                        <para>ソルバー (使用する数値ソルバーを選択),
-                            ステップの大きさの最大値(ソルバーにより設定される時間ステップの最大値)
+                        
+                        <para>
+                            
+                            <emphasis role="bold">デフォルト</emphasis>: 
+                            
+                            このボタンはシミュレーションパラメータを工場値にリセットします.
+                            
                         </para>
+                        
+                        <para/>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
+                <para>
+                    
+                    ソルバに関する詳細については,
+                    
+                    <xref linkend="Seealso_Menu_entries">
+                        
+                        参照
+                        
+                    </xref>
+                    の節を参照ください.
+                    
+                </para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">実行トレースとデバッグ</emphasis>
+                    
                 </para>
-                <para>Xcosをデバッグモードに設定し. ダイアグラムのデバッグを
-                    できるようにします.
-                </para>
+                
+                <para>
+                    
+                    Xcosをデバッグモードに設定します.
+                    
+                    This item opens the following dialog box in which you can choose
+                    
+                    the debugging mode. For more information, see the command 
+                    
+                    <link linkend="scicos_debug">scicos_debug</link>
+                    
+                </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">シミュレーション:コンテキスト設定</emphasis>
+                    
                 </para>
+                
                 <para>
-                    このメニューを選択すると,
-                    ブロック定義または任意の処理で使用されるシンボリックなXcosパラメータ
-                    を定義するための
-                    Scilab命令を入力するダイアログがオープンされます.
-                    これらの命令は,ダイアグラムが読み込まれる度に評価されます.
-                    コンテキストのシンボリックなXcosパラメータの値を変更した場合,
-                    全てのブロックが更新されます(evalが実行されます).
+                    
+                    When you select this menu item you obtain this dialog:
+                    
                 </para>
+                
+                <para/>
+                
+                <mediaobject>
+                    
+                    <imageobject>
+                        
+                        <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_set_context_gui.png"/>
+                        
+                    </imageobject>
+                    
+                </mediaobject>
+                
+                <para/>
+                
+                <para>
+                    
+                    You can enter here <emphasis>Scilab</emphasis> instructions for defining the symbolic <emphasis>Xcos</emphasis>
+                    
+                    parameters used in block definitions or to do whatever you want.
+                    
+                </para>
+                
+                <para>
+                    
+                    These instructions will be evaluated each time the diagram is loaded. If you change the value of a symbolic
+                    
+                    <emphasis>Xcos</emphasis> parameters in the context, all the blocks that contains this symbolic parameter are
+                    
+                    updated when you click on <emphasis>OK</emphasis>. By example if you want to set the value
+                    
+                    of gain of several blocks to a value which depends on a single value, you can proceed like this :
+                    
+                </para>
+                
+                <orderedlist>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            We have three GAINBLK_f blocks, open the <emphasis>Set context</emphasis> dialog and
+                            
+                            writes the symbolic variables:
+                            
+                        </para>
+                        
+                        <para/>
+                        
+                        <programlisting><![CDATA[
+              A = 1.5;
+              B = 2*A;
+              C = 3*A;
+            ]]></programlisting>
+                        
+                        <para/>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            Then, open successively each block parameters dialog and set for the gain value the name of
+                            
+                            required symbolic value, here <emphasis>A</emphasis>,<emphasis> B</emphasis> and
+                            
+                            <emphasis>C</emphasis>.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                </orderedlist>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">シミュレーション:コンパイル</emphasis>
+                    
                 </para>
-                <para>ブロックダイアグラムをコンパイルする際には
+                
+                <para>
+                    
+                    ブロックダイアグラムをコンパイルする際には
+                    
                     「コンパイル」メニューを選択します.
+                    
                     (実行メニューによる)各シミュレーションの開始前に必要に応じて実行前に
+                    
                     自動的にコンパイルが行われるため,このメニューは使用されることはありません.
+                    
                     通常,新たなコンパイルはシステムパラメータおよび内部状態量が
+                    
                     修正された場合でも不要です.
+                    
                     しかしながら,いくつかのケースでは,
+                    
                     これらの修正が正常に更新されない場合があり,
+                    
                     再開または継続の前にマニュアルでコンパイルを行うことが
+                    
                     必要となる可能性があります.
-                    このようなケースが見つかった場合には,報告してください.
+                    
                 </para>
+                
+                <para>
+                    
+                    <emphasis role="bold">このようなケースが見つかった場合には,報告してください.</emphasis>
+                    
+                    <ulink url="http://bugzilla.scilab.org/">
+                        
+                        <emphasis>Scilab</emphasis>に関するバグと希望をレポートしてください.
+                        
+                    </ulink>
+                    
+                </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">シミュレーション:開始</emphasis>
+                    
+                    <emphasis role="bold">Simulate:Modelica の初期化</emphasis>
+                    
                 </para>
+                
+                <para>
+                    
+                    このメニュー要素は,
+                    
+                    <emphasis>Modelica</emphasis>コンパイラの専用ダイアログをオープンします.
+                    
+                    このダイアログでは,モデルの内容を確認でき,
+                    
+                    <emphasis>Kinsol</emphasis>,
+                    
+                    <emphasis>Ida</emphasis>, <emphasis>Fsolve</emphasis>, <emphasis>Optim</emphasis>,
+                    
+                    <emphasis>Nelder Mead</emphasis> および <emphasis>Hompack</emphasis> ソルバ
+                    
+                    からソルバを選択することもできます.
+                    
+                </para>
+                
+                <para/>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">シミュレーション:開始</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/media-playback-start.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>シミュレーションを開始するには開始メニューを選択します.
+                    
                     システムがシミュレーション済みの場合には,
+                    
                     シミュレーションの継続,再開または終了を選択する
+                    
                     ダイアログボックスが開きます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">シミュレーション:停止</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/process-stop.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>"停止"ボタンを選択することによりシミュレーションを中断することが
+                    
                     でき,任意のブロックパラメータを変更して,新しい値で
+                    
                     シミュレーションを継続することができます.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection id="Formatmenu_Menu_entries">
+        
         <title>フォーマットメニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_format.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">フォーマット:回転 (Ctrl+r)</emphasis>
-                </para>
-                <para>「回転」によりブロックを左に回転できます.
-                    ブロックが左に回転する度に,角度が45度増えます.
-                    ブロックを選択しなかった場合または複数のブロックを選択した場合,
-                    マウスポインタの下のブロックが回転されます.
-                </para>
+                    
+                    <emphasis role="bold">フォーマット:回転 (Ctrl+R)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/actions/transform-rotate.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    回転では,ブロックを左に 90°回転することができます.
+                    
+                    回転は選択された全ブロックに適用されます.
+                    
+                </para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">フォーマット:反転 (Ctrl+f)</emphasis>
-                </para>
-                <para>側面に配置されたブロックの(通常の)入力および出力の位置を反転する
+                    
+                    <emphasis role="bold">フォーマット:反転 (Ctrl+F)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/transform-flip.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    側面に配置されたブロックの(通常の)入力および出力の位置を反転する
+                    
                     際には,まず「反転」メニューを選択した後,
+                    
                     選択するブロックをクリックします.
+                    
                     これにより,左から右に番号がふられている
+                    
                     入力および出力イベントポートの順番や位置は変更されません.
+                    
                 </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <emphasis role="bold">フォーマット:ミラー (Ctrl+M)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/transform-mirror.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    
+                    ブロックの左右に設定した(標準)入力および出力の位置を反転する際には,
+                    
+                    ブロックを選択し, <emphasis>Mirror</emphasis>メニュー要素を選択します.
+                    
+                    これは, 上から下に番号が付けられた入力および出力ポートの順番および
+                    
+                    位置には影響しません.
+                    
+                    ミラーリングは選択された全ブロックに作用します.
+                    
+                </para>
+                
+                <para/>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:影を表示/非表示</emphasis>
+                    
                 </para>
+                
                 <para>このメニューにより選択されたブロックの
+                    
                     3次元表示および関連するパラメータを選択することができます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:ブロックの整列</emphasis>
+                    
                 </para>
-                <para>複数のブロックを選択した場合,
-                    垂直方向(上,下,中央)および水平方向(左,右,中心)にこれらを整列させることができます.
-                </para>
+                
+                <para/>
+                
                 <mediaobject>
+                    
                     <imageobject>
+                        
                         <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_format_align.png"/>
+                        
                     </imageobject>
+                    
                 </mediaobject>
+                
+                <para/>
+                
+                <para>
+                    
+                    複数のブロックを選択した場合,
+                    
+                    垂直方向(上,下,中央)および水平方向(左,右,中心)にこれらを整列させることができます.
+                    
+                </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット: 境界の色</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/draw-brush.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>このメニューにより境界の色を変更できます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:線の色</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../xcos/images/icons/16x16/actions/color-fill.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>このメニューにより線の色を変更できます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:結合方法</emphasis>
+                    
                 </para>
+                
                 <mediaobject>
+                    
                     <imageobject>
+                        
                         <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_format_link_style.png"/>
+                        
                     </imageobject>
+                    
                 </mediaobject>
-                <para>このメニューにより結合の形式を選択できます:</para>
+                
+                <para>
+                    
+                    このメニューにより結合の形式を選択できます:
+                    
+                </para>
+                
+                <para>
+                    
+                    まず,リンクを選択,適当なメニュー要素を選択または
+                    
+                    ショートカット(<emphasis>H</emphasis>), <emphasis>S</emphasis>, <emphasis>V</emphasis>)
+                    
+                    を使用します.
+                    
+                    以下に得られる結果のリストを示します.
+                    
+                </para>
+                
                 <itemizedlist>
+                    
                     <listitem>
-                        <para>水平</para>
+                        
+                        <para>
+                            
+                            水平 (<emphasis>H</emphasis>)
+                            
+                        </para>
+                        
+                        <mediaobject>
+                            
+                            <imageobject>
+                                
+                                <imagedata fileref="../images/xcos_menu_entries/en_US/xcos_link_horizontal_en_US.png"/>
+                                
+                            </imageobject>
+                            
+                        </mediaobject>
+                        
                     </listitem>
+                    
                     <listitem>
-                        <para>直線</para>
+                        
+                        <para>
+                            
+                            直線 (<emphasis>S</emphasis>)
+                            
+                        </para>
+                        
+                        <mediaobject>
+                            
+                            <imageobject>
+                                
+                                <imagedata fileref="../images/xcos_menu_entries/en_US/xcos_link_straight_en_US.png"/>
+                                
+                            </imageobject>
+                            
+                        </mediaobject>
+                        
                     </listitem>
+                    
                     <listitem>
-                        <para>垂直</para>
+                        
+                        <para>
+                            
+                            垂直 (<emphasis>V</emphasis>)
+                            
+                        </para>
+                        
+                        <mediaobject>
+                            
+                            <imageobject>
+                                
+                                <imagedata fileref="../images/xcos_menu_entries/en_US/xcos_link_vertical_en_US.png"/>
+                                
+                            </imageobject>
+                            
+                        </mediaobject>
+                        
                     </listitem>
+                    
                 </itemizedlist>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:ダイアグラムの背景</emphasis>
+                    
                 </para>
+                
                 <para>このメニューにより背景の色を変更できます.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">フォーマット:グリッド</emphasis>
+                    
                 </para>
+                
                 <para>このメニューによりグリッドを有効/無効にできます.
+                    
                     グリッドにより,作業領域でブロックを配置するのは容易になります.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
-    <refsection id="Diagrammenu_Menu_entries">
+    
+    <refsection id="Toolsmenu_Menu_entries">
+        
         <title>ツールメニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_tools.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ツール:コード生成</emphasis>
+                    
                 </para>
+                
                 <para>
+                    
                     このメニューにより,離散時間スーパーブロックに関連するシミュレーションコードを
+                    
                     生成することができます.
+                    
                     コード生成は,このメニューを選択した後,
+                    
                     指定するスーパーブロックを選択することにより行ないます.
+                    
                     スーパーブロックが必要な条件を満たす場合,
+                    
                     ブロック名,生成されたファイルを置くディレクトリおよび
+                    
                     リンカにより指定されたオプションのライブラリを入力する
+                    
                     ダイアログボックスがポップアップします.
+                    
                     これらの情報を指定すると,
+                    
                     コードが生成され,コンパイル,Scilabとリンクされます.
+                    
                     スーパーブロックは生成されたコードを実装する
+                    
                     新しいブロックで自動的に置換されます.
+                    
                     この後,修正されたダイアグラムを実行することができます.
+                    
                     スタンドアロン実行用のコードも生成されます.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
-    <refsection id="menu_Menu_entries">
+    
+    <refsection id="Helpmenu_Menu_entries">
+        
         <title>ヘルプメニュー</title>
+        
         <mediaobject>
+            
             <imageobject>
+                
                 <imagedata align="center" fileref="../gui/xcos_menu_entries/en_US/xcos_menu_help.png"/>
+                
             </imageobject>
+            
         </mediaobject>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                    <emphasis role="bold">ヘルプ:Xcosヘルプ</emphasis>
+                    
+                    <emphasis role="bold">ヘルプ:Xcosヘルプ (F1)</emphasis>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/apps/help-browser.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
+                <para>
+                    このメニューは<emphasis>Xcos</emphasis>ヘルプブラウザをオープンします.
                 </para>
-                <para>このメニューはヘルプブラウザをオープンします.</para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ヘルプ:ブロックヘルプ</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/apps/help-browser.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>特定のXcosオブジェクト(ブロック)のヘルプを取得するには,
+                    
                     まずオブジェクト(ブロック)を選択した後,
+                    
                     このヘルプメニュー項目をクリックします.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ヘルプ:Xcosデモ</emphasis>
-                </para>
+                    
+                    <inlinemediaobject>
+                        
+                        <imageobject>
+                            
+                            <imagedata fileref="../../../gui/images/icons/16x16/categories/applications-system.png"/>
+                            
+                        </imageobject>
+                        
+                    </inlinemediaobject>
+                    
+                </para>
+                
                 <para>このデモメニューによりXcosダイアグラムのいくつかの例を
+                    
                     オープンすることができます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <emphasis role="bold">ヘルプ:Xcosについて</emphasis>
+                    
                 </para>
+                
                 <para>Xcosの現在のバージョンおよびいくつかの有用な情報を出力します.</para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
+    <refsection role="see also" id="Seealso_Menu_entries">
+        
+        <title>参照</title>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <link linkend="scicos_debug">scicos_debug</link>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <link linkend="ode">ode</link>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <link linkend="dassl">dassl</link>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
 </refentry>
+