scilab/modules/core/help/ja_JP/scilab.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
   3     xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
   4     xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
   5     xmlns:scilab="http://www.scilab.org" xml:id="scilab" xml:lang="ja">
   6     <refnamediv xml:id="wscilex">
   7     </refnamediv>
   8     <refnamediv xml:id="scilex">
   9     </refnamediv>
  10     <refnamediv>
  11         <refname>scilex | scilab</refname>
  12         <refpurpose>
  13             Scilabおよび関連ツールを起動するためのツール
  14         </refpurpose>
  15     </refnamediv>
  16     <refsynopsisdiv>
  17         <title>呼出し手順</title>
  18         <synopsis>
  19 #      MS Windows          |  # Linux / Unix / Mac OS X
  20 wscilex     &lt;Options&gt;     |  scilab         &lt;Options&gt;
  21 wscilex -nw &lt;Options&gt; |  scilab-adv-cli &lt;Options&gt;
  22 scilex      &lt;Options&gt;      |  scilab-cli     &lt;Options&gt;
  23         </synopsis>
  24     </refsynopsisdiv>
  25     <refsection role="arguments">
  26         <title>説定</title>
  27         <variablelist>
  28             <varlistentry>
  29                 <term>-args arg#1 arg#2 ..</term>
  30                 <listitem>
  31                     <para>
  32                         This option allows to send some data to the Scilab session:
  33                         <itemizedlist>
  34                             <listitem>Consecutive data are separated by one or several spaces.
  35                             </listitem>
  36                             <listitem>An expression between double-quotes is a single data.
  37                             </listitem>
  38                             <listitem>To include a double-quote in a data, write <literal>\"</literal> instead of <literal>"</literal>.
  39                             </listitem>
  40                             <listitem>The single quote <literal>'</literal> is a regular character. It has no special meaning.
  41                             </listitem>
  42                         </itemizedlist>
  43                     </para>
  44                     <para>
  45                       Inside the opened session, these data can be retrieved as separated strings with <link linkend="sciargs">sciargs()</link>.
  46                      </para>
  47                      <para>
  48                       Example:
  49                         <screen><![CDATA[C:\Users\Me> scilex -nb -args "Hello \"%USERNAME%\"" 1.2345 \"%cd%\"]]></screen>
  50                         <programlisting><![CDATA[
  51 // Inside the opened session:
  52 a = sciargs()
  53 i = find(a=="-args")
  54 a(i+1)
  55 evstr(a(i+2))*2
  56 "This session has been launched from " + a(i+3)
  57                         ]]>
  58                         </programlisting>
  59                         <screen><![CDATA[
  60 --> // Inside the opened session:
  61 --> a = sciargs()
  62  a  =
  63 !c:\SCIdir\bin\scilex  -nw  -nb  -noatomsautoload  -args  Hello "John"  1.2345  "C:\Users\Me" !
  64
  65 --> i = find(a=="-args")
  66  i  =
  67     5.
  68
  69 --> a(i+1)
  70  ans  =
  71  Hello "John"
  72
  73 --> evstr(a(i+2))*2
  74  ans  =
  75     2.469
  76
  77 --> "This session has been launched from " + a(i+3)
  78  ans  =
  79  This session has been launched from "C:\Users\Me"
  80
  81 -->
  82 ]]></screen>
  83                      </para>
  84                      <para>
  85                      <note>Using <literal>-args</literal> as the <emphasis role="italic">last</emphasis> command line option is safer.
  86                      </note>
  87                      </para>
  88                 </listitem>
  89             </varlistentry>
  90             <varlistentry>
  91                 <term>-display Display</term>
  92                 <listitem>
  93                     <para>
  94                         Xwindow システム上でのみ使用可能で, 表示する
  95                         Xサーバーを指定します.
  96                         デフォルトの表示先は unix:0.0 です.
  97                     </para>
  98                     <para>
  99                         <literal>-display</literal> は,
 100                         <literal>-d</literal>と短縮形で指定できます.
 101                     </para>
 102                 </listitem>
 103             </varlistentry>
 104             <varlistentry>
 105                 <term>-e Instructions</term>
 106                 <listitem>
 107                     <para>
 108                         At the end of the whole session startup, this option
 109                         <itemizedlist>
 110                             <listitem>
 111                                 <para>sets the current working directory to the shell directory from which Scilab has been launched. Please see the example given here-below for the <literal>-f</literal> option. Then,
 112                                 </para>
 113                             </listitem>
 114                             <listitem>
 115                                 <para>executes Scilab <literal>Instructions</literal> provided in a string. Example:
 116                                     <screen><![CDATA[ scilab-cli -e  "disp(\"Hello\"); a=%pi+%i; disp(exp(a)); exit;" -nb]]></screen>
 117                                 </para>
 118                             </listitem>
 119                         </itemizedlist>
 120                     </para>
 121                     <warning>
 122                         <literal>-e</literal> および <literal>-f</literal> オプションは相互に排他的です.
 123                     </warning>
 124                 </listitem>
 125             </varlistentry>
 126             <varlistentry>
 127                 <term>-f file</term>
 128                 <listitem>
 129                     <para>
 130                         If this option is used, then at the beginning of the Scilab session, after the execution of the scilab and user startup files, and after the setting of user Preferences -- including the working directory ones --,
 131                         <itemizedlist>
 132                             <listitem>
 133                                 <para>
 134                                     the current Scilab working directory is set to the shell directory from which Scilab has been launched. For instance,
 135                                     <screen><![CDATA[ D:\users\me\scilab\dev> C:\scilab-5.5.2\bin\scilex -f ..\test.sce]]></screen>
 136                                     will do a <literal>cd("D:\users\me\scilab\dev")</literal>.
 137                                 </para>
 138                             </listitem>
 139                             <listitem>
 140                                 <para>
 141                                     the Scilab script <literal>file</literal> is executed. If a relative path is used (default <literal>.\</literal>, or like <literal>..\</literal> in the sample here-above), it refers to the new Scilab working directory.
 142                                 </para>
 143                             </listitem>
 144                         </itemizedlist>
 145                     </para>
 146                     <para>.xcos 拡張子を有するファイルはXcosで開かれます.</para>
 147                 </listitem>
 148             </varlistentry>
 149             <varlistentry>
 150                 <term>-quit</term>
 151                 <listitem>
 152                     <para>This option forces scilab to always exit after the instruction(s) passed with the <literal>-e</literal>
 153                     option, or the script referred to by the <literal>-f</literal> option, have been executed,
 154                     even in case of a runtime error. This option should always be used in batch mode.
 155                     It is ignored if neither <literal>-e</literal> nor <literal>-f</literal> options are present.
 156                     </para>
 157                 </listitem>
 158             </varlistentry>
 159             <varlistentry>
 160                 <term>-l lang</term>
 161                 <listitem>
 162                     <para>このオプションを指定した場合,
 163                         ユーザ言語を指定します.
 164                         <emphasis>lang</emphasis> は以下の値を指定できます: <emphasis>ca_ES de_DE en_US es_ES
 165                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
 166                         </emphasis>
 167                         (Scilab 5.2以降).
 168                     </para>
 169                     <para>
 170                         互換性維持のため，その他に <literal>lang</literal> の値は,フランス語として
 171                         <literal>'fr'</literal> および英語として <literal>'en'</literal> を使用可能です.
 172                         デフォルト値は,<literal>scilab.start</literal>ファイルで指定されます.
 173                     </para>
 174                     <para>いくつかのシステムでは,UTF-8フォントを正しく描画するために,
 175                         ロケールをコンパイルする必要があります.
 176                     </para>
 177                     <para>Scilab を以下のようにコールすることも可能です:</para>
 178                     <screen><![CDATA[ LANG=ja_JP scilab
 179  # これは以下と等価です
 180  scilab -l ja_JP
 181 ]]></screen>
 182                 </listitem>
 183             </varlistentry>
 184             <varlistentry>
 185                 <term>-nb</term>
 186                 <listitem>
 187                     <para>"no banner" :
 188                         このオプションが指定された場合, Scilabの Welcome バナーは表示されません.
 189                     </para>
 190                 </listitem>
 191             </varlistentry>
 192             <varlistentry>
 193                 <term>-ns</term>
 194                 <listitem>
 195                     <para>"No Startup files" :
 196                         このオプションが指定された場合, スタートアップファイル
 197                         <literal>SCI/etc/scilab.start</literal> およびユーザスタートアップファイル
 198                         <literal>SCIHOME/.scilab</literal>,
 199                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
 200                     </para>
 201                     <para>このオプションは, Scilabの多くの機能を無効にします (動作を理解している場合のみ
 202                         使用してください).
 203                     </para>
 204                 </listitem>
 205             </varlistentry>
 206             <varlistentry>
 207                 <term>-nouserstartup</term>
 208                 <listitem>
 209                     <para>このオプションが指定された場合, スタートアップファイル
 210                         <literal>SCIHOME/.scilab</literal>,
 211                         <literal>SCIHOME/scilab.ini</literal> は実行されません.
 212                     </para>
 213                 </listitem>
 214             </varlistentry>
 215             <varlistentry>
 216                 <term>-noatomsautoload</term>
 217                 <listitem>
 218                     <para>
 219                         このオプションが指定された場合,イントール済みのATOMモジュールは
 220                         このセッションでロードされません.
 221                     </para>
 222                 </listitem>
 223             </varlistentry>
 224             <varlistentry>
 225                 <term>-nw</term>
 226                 <listitem>
 227                     <para>
 228                         このオプションが指定された場合, Scilab は
 229                         先進的な機能(グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)
 230                         と共にコマンドラインで起動されます.
 231                     </para>
 232                     <para>Scilab 5.2以降:</para>
 233                     <itemizedlist>
 234                         <listitem>
 235                             <para>全てのオペレーティングシステムについて
 236                                 パイプが有効です (詳細については例を参照ください).
 237                             </para>
 238                         </listitem>
 239                         <listitem>
 240                             <para>Scilab のディストリビューションには,
 241                                 <literal>-nw</literal>と同様のバイナリを提供します:
 242                                 <literal>scilab-adv-cli</literal>
 243                                 (Scilab Advanced Command Line Interpreter).
 244                             </para>
 245                         </listitem>
 246                     </itemizedlist>
 247                 </listitem>
 248             </varlistentry>
 249             <varlistentry>
 250                 <term>-nwni / -nogui</term>
 251                 <listitem>
 252                     <important>このモードでは Java 仮想マシンはロードされません.
 253                         (起動は高速化され,メモリ消費量は減少します)
 254                     </important>
 255                     <para>このオプションが指定された場合, Scilab は先進的な機能
 256                         (グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)なしで
 257                         コマンドラインで起動されます.
 258                     </para>
 259                     <para>Scilab 5.2以降:</para>
 260                     <itemizedlist>
 261                         <listitem>
 262                             <para>全てのオペレーティングシステムについて
 263                                 パイプが有効です (詳細については例を参照ください).
 264                             </para>
 265                         </listitem>
 266                         <listitem>
 267                             <para>
 268                                 Scilab のディストリビューションでは,
 269                                 <literal>-nwni</literal>と同じ専用バイナリが提供されています
 270                                 : <literal>scilab-cli</literal>
 271                                 (Scilab Command Line Interpreter).
 272                             </para>
 273                         </listitem>
 274                     </itemizedlist>
 275                 </listitem>
 276             </varlistentry>
 277             <varlistentry>
 278                 <term>--texmacs</term>
 279                 <listitem>
 280                     <para>このオプションは TeXMacs用に予約されています.</para>
 281                     <para>
 282                         ATOMSモジュールをインストールしてください: <programlisting role="">atomsInstall('texmacs')</programlisting>
 283                     </para>
 284                 </listitem>
 285             </varlistentry>
 286             <varlistentry>
 287                 <term>-version</term>
 288                 <listitem>
 289                     <para>このオプションはプロダクトのバージョンを出力し,終了します.</para>
 290                 </listitem>
 291             </varlistentry>
 292         </variablelist>
 293     </refsection>
 294
 295     <refsection role="arguments">
 296         <title>Additional options for Unix/Linux and Mac OS X</title>
 297         <para>助言: これらのオプションをScilabソースツリー上で使用してください.</para>
 298         <variablelist>
 299             <varlistentry>
 300                 <term>-debug</term>
 301                 <listitem>
 302                     <para>デバッガgdb上でScilabを開始します.</para>
 303                     <para>
 304                         gdb にカスタムオプションを追加する場合,
 305                         変数<literal>SCILAB_GDB_OPT</literal>を定義します.
 306                     </para>
 307                 </listitem>
 308             </varlistentry>
 309             <varlistentry>
 310                 <term>-debug-kdbg</term>
 311                 <listitem>
 312                     <para>kdbg上でScilabを開始します.</para>
 313                 </listitem>
 314             </varlistentry>
 315             <varlistentry>
 316                 <term>-profiling</term>
 317                 <listitem>
 318                     <para>valgrind上でScilabを開始します.</para>
 319                     <para>
 320                         valgrind にカスタムオプションを追加する場合
 321                         (および既存の valgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
 322                         を定義してください.
 323                     </para>
 324                 </listitem>
 325             </varlistentry>
 326             <varlistentry>
 327                 <term>-profiling-visu</term>
 328                 <listitem>
 329                     <para>callgrind上でScilabを開始します.</para>
 330                     <para>
 331                         callgrind にカスタムオプションを追加する場合
 332                         (および既存の callgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
 333                         を定義してください.
 334                     </para>
 335                 </listitem>
 336             </varlistentry>
 337             <varlistentry>
 338                 <term>-electric-fence</term>
 339                 <listitem>
 340                     <para>Electric Fence を指定して Scilab を開始します.</para>
 341                 </listitem>
 342             </varlistentry>
 343         </variablelist>
 344     </refsection>
 345
 346     <refsection role="description">
 347         <title>環境変数の説明</title>
 348         <variablelist>
 349             <varlistentry>
 350                 <term>SCIVERBOSE</term>
 351                 <listitem>
 352                     <para>
 353                         この変数が存在した場合, Scilab起動スクリプトは起動時デバッグ情報を表示します.
 354                         主にバグレポートおよびデバッグ目的で使用されます.
 355                     </para>
 356                 </listitem>
 357             </varlistentry>
 358             <varlistentry>
 359                 <term>JAVA_HOME</term>
 360                 <listitem>
 361                     <para>
 362                         使用するJavaを指定します. 例えば,
 363                         <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> は
 364                         Java 7 でScilabを起動します.
 365                     </para>
 366                 </listitem>
 367             </varlistentry>
 368             <varlistentry>
 369                 <term>SCI_DISABLE_TK</term>
 370                 <listitem>
 371                     <para>Tk (Tclではなく) 機能を無効にします.</para>
 372                 </listitem>
 373             </varlistentry>
 374             <varlistentry>
 375                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
 376                 <listitem>
 377                     <para>
 378                         ヘッドレスJava仮想マシン (すなわち,GUI機能なし).
 379                     </para>
 380                 </listitem>
 381             </varlistentry>
 382         </variablelist>
 383     </refsection>
 384     <refsection role="description">
 385         <title>Java 仮想マシンオプション</title>
 386         <warning>
 387             The options described here-below are useless and are cancelled if the option <literal>-nwni</literal> is used.
 388         </warning>
 389         <para>Scilab 5.0以降, グラフィカルユーザインターフェイス (GUI) および
 390             ドキュメントの構築は,Java機能に基づいています.
 391             いくつかのケースでは,
 392             JVM (Java仮想マシン)オプションを編集することが重要となります.
 393         </para>
 394         <para>これらのオプションは,
 395             <emphasis>jvm_options.xml</emphasis>ファイルで利用可能です.
 396         </para>
 397         <para>5.0.X および 5.1.Xでは, このファイルは
 398             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>に保存されています.
 399         </para>
 400         <para>&gt;= 5.2.0以降, このファイルは
 401             <emphasis>
 402                 etc/jvm_options.xml<emphasis> </emphasis>
 403             </emphasis>
 404             にあります.
 405         </para>
 406         <para>デフォルトで, 以下の3つのオプションが
 407             設定ファイルで容易にアクセス可能です:
 408         </para>
 409         <variablelist>
 410             <varlistentry>
 411                 <term>-XmxXXXm</term>
 412                 <listitem>
 413                     <para>
 414                         このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
 415                         デフォルトで, 256M が確保されます.
 416                         この値を変更した場合, その値がシステムで利用可能なメモリを
 417                         超えないことを確認してください.
 418                     </para>
 419                     <para>
 420                         Scilab 5.4.0以降, この値は設定メニュー内で変更可能です.
 421                     </para>
 422                 </listitem>
 423             </varlistentry>
 424             <varlistentry>
 425                 <term>-Djava.compiler=JIT</term>
 426                 <listitem>
 427                     <para>
 428                         このオプションを引数<emphasis>JIT</emphasis>を付けて指定すると,
 429                         Java Just In Time compilerが有効になります.
 430                         このオプションはデフォルトで有効となります.
 431                         <emphasis>NONE</emphasis>によりJITは無効となり,
 432                         著しく性能が低下します.
 433                     </para>
 434                 </listitem>
 435             </varlistentry>
 436             <varlistentry>
 437                 <term>-verbose:jni / -Xcheck:jni</term>
 438                 <listitem>
 439                     <para>
 440                         これらのオプションは,JNIコールとその出力をより詳細に確認します.
 441                         デバッグ時にはこれらのオプションを利用可能ですが,
 442                         性能を低下させるためデフォルトでは無効となっています.
 443                     </para>
 444                 </listitem>
 445             </varlistentry>
 446         </variablelist>
 447         <para>より多くのオプションが利用可能です.
 448             これにより性能を改善したり,ルックアンドフィールを変更したり,
 449             メモリ管理を変更したりといったことが可能です.
 450             参照:  <ulink url="http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html">http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html</ulink>
 451         </para>
 452     </refsection>
 453     <refsection role="examples">
 454         <title>例</title>
 455         <screen><![CDATA[
 456 # Let's start Scilab in profiling mode without attaching a gdb once a SIGSEGV is met.
 457 # We are under Bash shell
 458 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
 459 scilab -profiling
 460 # Let's start Scilab in debug mode without stopping after each SIGSEGV
 461 # First, we write a small command file
 462 echo "handle SIGSEGV nostop" &> debug.txt
 463 # Now set the custom option
 464 # We are under Bash shell
 465 export SCILAB_GDB_OPT="--command=debug.txt"
 466 # Start Scilab in debug mode
 467 scilab -debug ]]></screen>
 468         <para></para>
 469         <screen><![CDATA[
 470 # Under GNU/Linux, Mac OS X or Unix:
 471 $ echo "disp(%pi)"|scilab-cli
 472 or
 473 $ echo "disp(%pi)"|scilab -nwni
 474 # Only open the Scilab help window:
 475 $ scilab-adv-cli -e "help()"
 476 or
 477 $ scilab -nw -e "help()"
 478 # Scilab can be used for scripting aspects:
 479 echo "if 1<>2 then exit(99) end"|scilab-cli
 480 echo $? ]]></screen>
 481     </refsection>
 482     <refsection role="see also">
 483         <title>参照</title>
 484         <simplelist type="inline">
 485             <member>
 486                 <link linkend="startup">startup</link>
 487             </member>
 488             <member>
 489                 <link linkend="sciargs">sciargs</link>
 490             </member>
 491             <member>
 492                 <link linkend="getpid">getpid</link>
 493             </member>
 494             <member>
 495                 <link linkend="getenv">getenv</link>
 496             </member>
 497             <member>
 498                 <link linkend="getenv">getversion</link>
 499             </member>
 500             <member>
 501                 <link linkend="consolebox">consolebox</link>
 502             </member>
 503             <member>
 504                 <link linkend="exit">exit</link>
 505             </member>
 506         </simplelist>
 507     </refsection>
 508     <refsection role="history">
 509         <title>履歴</title>
 510         <revhistory>
 511             <revision>
 512                 <revnumber>5.4.0</revnumber>
 513                 <revremark>-noatomsautoload が追加されました.</revremark>
 514             </revision>
 515             <revision>
 516                 <revnumber>5.4.1</revnumber>
 517                 <revremark>scinotes と xcos 個別スクリプトが導入されました. SEP #87参照.</revremark>
 518             </revision>
 519             <revision>
 520                 <revnumber>6.0.0</revnumber>
 521                 <revremark>
 522                     <literal>-quit</literal> option added. <literal>-mem</literal> option removed.
 523                 </revremark>
 524             </revision>
 525         </revhistory>
 526     </refsection>
 527 </refentry>