1 <?xml version="1.0" encoding="UTF-8"?>
3 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="scilab" xml:lang="ja">
7 <refname>scilab</refname>
11 Scilabおよび関連ツールを起動するためのツール
13 (GNU/Linux, Unix および Mac OS X)
23 <synopsis>scilab <Options>
25 scilab-adv-cli <Options>
27 scilab-cli <Options>
33 <refsection role="arguments">
41 <term>-args Arguments</term>
47 このオプションが存在する場合,引数がScilabに渡されます.
49 これらは,<link linkend="sciargs">sciargs</link>関数で取得することが
53 複数の引数を指定する場合,以下のように一連の複数の単語を引用符で括り,
55 空白で分割してください: <literal>scilab -args 'foo1 foo2'</literal>.
57 このオプションを指定しない場合,未知の引数は受け付けられません.
67 <term>-display Display</term>
73 Xwindow システム上でのみ使用可能で, 表示する
77 デフォルトの表示先は unix:0.0 です.
83 <literal>-display</literal> は,
85 <literal>-d</literal>と短縮形で指定できます.
99 <para>デバッガgdb上でScilabを開始します(Unix/Linux/Mac OS Xのみ).</para>
103 gdb にカスタムオプションを追加する場合,
105 変数<literal>SCILAB_GDB_OPT</literal>を定義します.
109 <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
117 <term>-debug-kdbg</term>
121 <para>kdbg上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
123 <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
131 <term>-profiling</term>
135 <para>valgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
139 valgrind にカスタムオプションを追加する場合
141 (および既存の valgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
147 <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
155 <term>-profiling-visu</term>
159 <para>callgrind上でScilabを開始します (Unix/Linux/Mac OS X のみ).</para>
163 callgrind にカスタムオプションを追加する場合
165 (および既存の callgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
171 <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
179 <term>-electric-fence</term>
183 <para>Electric Fence を指定して Scilab を開始します(Unix/Linux/Mac OS Xのみ).</para>
185 <para>助言: このオプションをScilabソースツリー上で使用してください.</para>
199 このオプションを指定すると Scilab 命令
201 <literal>Instruction</literal> が(スタートアップファイルの実行直後に)
205 <literal>-e</literal> および
207 <literal>-f</literal> オプションは相互に排他的です.
212 <literal>-e</literal>により複数の命令を指定できることに注意してください.
215 <programlisting role="no-scilab-exec">scilab-cli -e "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
229 このオプションを指定すると, Scilab はスクリプト <literal>file</literal>
231 を(スタートアップファイルの実行直後,)Scilab上で最初に実行します.
235 <literal>-e</literal> および
237 <literal>-f</literal> オプションは相互に排他的です.
241 <para>.xcos 拡張子を有するファイルはXcosで開かれます.</para>
250 This option forces scilab to always exit after the instruction(s) passed with the <literal>-e</literal>
251 option, or the script referred to by the <literal>-f</literal> option, have been executed,
252 even in case of a runtime error. This option should always be used in batch mode.
253 It is ignored if neither <literal>-e</literal> nor <literal>-f</literal> options are present.
264 <para>このオプションを指定した場合,
268 <emphasis>lang</emphasis> は以下の値を指定できます: <emphasis>ca_ES de_DE en_US es_ES
270 fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
280 互換性維持のため,その他に <literal>lang</literal> の値は,フランス語として
282 <literal>'fr'</literal> および英語として <literal>'en'</literal> を使用可能です.
284 デフォルト値は,<literal>scilab.start</literal>ファイルで指定されます.
288 <para>いくつかのシステムでは,UTF-8フォントを正しく描画するために,
294 <para>Scilab を以下のようにコールすることも可能です:</para>
296 <programlisting role="no-scilab-exec">LANG=ja_JP scilab
316 このオプションが指定された場合, Scilabの Welcome バナーは表示されません.
332 このオプションが指定された場合, スタートアップファイル
334 <literal>SCI/etc/scilab.start</literal> およびユーザスタートアップファイル
336 <literal>SCIHOME/.scilab</literal>,
338 <literal>SCIHOME/scilab.ini</literal> は実行されません.
342 <para>このオプションは, Scilabの多くの機能を無効にします (動作を理解している場合のみ
354 <term>-nouserstartup</term>
358 <para>このオプションが指定された場合, スタートアップファイル
360 <literal>SCIHOME/.scilab</literal>,
362 <literal>SCIHOME/scilab.ini</literal> は実行されません.
372 <term>-noatomsautoload</term>
378 このオプションが指定された場合,イントール済みのATOMモジュールは
396 このオプションが指定された場合, Scilab は
398 先進的な機能(グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)
405 このオプションは <literal>-f</literal>または <literal>-e</literal>
407 オプションと同時に指定することができます.
410 <para>Scilab 5.2以降:</para>
416 <para>Scilab のディストリビューションには,
418 <literal>-nw</literal>と同様のバイナリを提供します:
420 <literal>scilab-adv-cli</literal>
422 (Scilab Advanced Command Line Interpreter).
430 <para>全てのオペレーティングシステムについて
432 パイプが有効です (詳細については例を参照ください).
446 <term>-nwni / -nogui</term>
450 <para>このオプションが指定された場合, Scilab は先進的な機能
452 (グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)なしで
459 このオプションは <literal>-f</literal> または <literal>-e</literal>
461 オプションと同時に指定することができます.
464 <para>Scilab 5.2以降:</para>
472 Scilab のディストリビューションでは,
474 <literal>-nwni</literal>と同じ専用バイナリが提供されています
476 : <literal>scilab-cli</literal>
478 (Scilab Command Line Interpreter).
490 <para>全てのオペレーティングシステムについて
492 パイプが有効です (詳細については例を参照ください).
500 <para>このモードでは Java 仮想マシンはロードされません.
502 (起動は高速化され,メモリ消費量は減少します)
512 <term>--texmacs</term>
516 <para>このオプションは TeXMacs用に予約されています.</para>
520 ATOMSモジュールをインストールしてください: <programlisting role="">atomsInstall('texmacs')</programlisting>
530 <term>-version</term>
534 <para>このオプションはプロダクトのバージョンを出力し,終了します.</para>
544 <refsection role="description">
546 <title>環境変数の説明</title>
552 <term>SCIVERBOSE</term>
558 この変数が存在した場合, Scilab起動スクリプトは起動時デバッグ情報を表示します.
560 主にバグレポートおよびデバッグ目的で使用されます.
570 <term>JAVA_HOME</term>
578 <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> は
580 Java 7 でScilabを起動します.
590 <term>SCI_DISABLE_TK</term>
594 <para>Tk (Tclではなく) 機能を無効にします.</para>
602 <term>SCI_JAVA_ENABLE_HEADLESS</term>
608 ヘッドレスJava仮想マシン (すなわち,GUI機能なし).
620 <refsection role="description">
622 <title>Java 仮想マシンオプション</title>
624 <para>Scilab 5.0以降, グラフィカルユーザインターフェイス (GUI) および
626 ドキュメントの構築は,Java機能に基づいています.
630 JVM (Java仮想マシン)オプションを編集することが重要となります.
636 <emphasis>jvm_options.xml</emphasis>ファイルで利用可能です.
640 <para>5.0.X および 5.1.Xでは, このファイルは
642 <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>に保存されています.
646 <para>>= 5.2.0以降, このファイルは
650 etc/jvm_options.xml<emphasis> </emphasis>
658 <para>デフォルトで, 以下の3つのオプションが
668 <term>-XmxXXXm</term>
674 このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
676 デフォルトで, 256M が確保されます.
678 この値を変更した場合, その値がシステムで利用可能なメモリを
686 Scilab 5.4.0以降, この値は設定メニュー内で変更可能です.
696 <term>-Djava.compiler=JIT</term>
702 このオプションを引数<emphasis>JIT</emphasis>を付けて指定すると,
704 Java Just In Time compilerが有効になります.
706 このオプションはデフォルトで有効となります.
708 <emphasis>NONE</emphasis>によりJITは無効となり,
720 <term>-verbose:jni / -Xcheck:jni</term>
726 これらのオプションは,JNIコールとその出力をより詳細に確認します.
728 デバッグ時にはこれらのオプションを利用可能ですが,
730 性能を低下させるためデフォルトでは無効となっています.
740 <para>より多くのオプションが利用可能です.
742 これにより性能を改善したり,ルックアンドフィールを変更したり,
744 メモリ管理を変更したりといったことが可能です.
746 参照: <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>
752 <refsection role="examples">
756 <programlisting role="no-scilab-exec"><![CDATA[
757 # Let's start Scilab in profiling mode without attaching a gdb once a SIGSEGV is met.
758 # We are under Bash shell
759 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
762 # Let's start Scilab in debug mode without stopping after each SIGSEGV
763 # First, we write a small command file
764 echo "handle SIGSEGV nostop" &> debug.txt
765 # Now set the custom option
766 # We are under Bash shell
767 export SCILAB_GDB_OPT="--command=debug.txt"
768 # Start Scilab in debug mode
769 scilab -debug]]></programlisting>
771 <programlisting role="no-scilab-exec"><![CDATA[
772 # Under GNU/Linux, Mac OS X or Unix:
773 $ echo "disp(%pi)"|scilab-cli
775 $ echo "disp(%pi)"|scilab -nwni
777 # Only open the Scilab help window:
778 $ scilab-adv-cli -e "help()"
780 $ scilab -nw -e "help()"
783 # Scilab can be used for scripting aspects:
784 echo "if 1<>2 then exit(99) end"|scilab-cli
785 echo $? ]]></programlisting>
789 <refsection role="see also">
793 <simplelist type="inline">
797 <link linkend="exit">exit</link>
803 <link linkend="startup">startup</link>
811 <refsection role="history">
819 <revnumber>5.4.0</revnumber>
821 <revremark>-noatomsautoload が追加されました.</revremark>
827 <revnumber>5.4.1</revnumber>
829 <revremark>scinotes と xcos 個別スクリプトが導入されました. SEP #87参照.</revremark>
833 <revnumber>6.0.0</revnumber>
835 <literal>-quit</literal> option added. <literal>-mem</literal> option removed.