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">
8 <refnamediv xml:id="scilex">
11 <refname>scilex | scilab</refname>
13 Scilabおよび関連ツールを起動するためのツール
19 # MS Windows | # Linux / Unix / Mac OS X
20 wscilex <Options> | scilab <Options>
21 wscilex -nw <Options> | scilab-adv-cli <Options>
22 scilex <Options> | scilab-cli <Options>
25 <refsection role="arguments">
29 <term>-args arg#1 arg#2 ..</term>
32 This option allows to send some data to the Scilab session:
34 <listitem>Consecutive data are separated by one or several spaces.
36 <listitem>An expression between double-quotes is a single data.
38 <listitem>To include a double-quote in a data, write <literal>\"</literal> instead of <literal>"</literal>.
40 <listitem>The single quote <literal>'</literal> is a regular character. It has no special meaning.
45 Inside the opened session, these data can be retrieved as separated strings with <link linkend="sciargs">sciargs()</link>.
49 <screen><![CDATA[C:\Users\Me> scilex -nb -args "Hello \"%USERNAME%\"" 1.2345 \"%cd%\"]]></screen>
50 <programlisting><![CDATA[
51 // Inside the opened session:
56 "This session has been launched from " + a(i+3)
60 --> // Inside the opened session:
63 !c:\SCIdir\bin\scilex -nw -nb -noatomsautoload -args Hello "John" 1.2345 "C:\Users\Me" !
65 --> i = find(a=="-args")
77 --> "This session has been launched from " + a(i+3)
79 This session has been launched from "C:\Users\Me"
85 <note>Using <literal>-args</literal> as the <emphasis role="italic">last</emphasis> command line option is safer.
91 <term>-display Display</term>
94 Xwindow システム上でのみ使用可能で, 表示する
96 デフォルトの表示先は unix:0.0 です.
99 <literal>-display</literal> は,
100 <literal>-d</literal>と短縮形で指定できます.
105 <term>-e Instructions</term>
108 At the end of the whole session startup, this option
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,
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>
122 <literal>-e</literal> および <literal>-f</literal> オプションは相互に排他的です.
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 --,
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>.
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.
146 <para>.xcos 拡張子を有するファイルはXcosで開かれます.</para>
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.
162 <para>このオプションを指定した場合,
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
170 互換性維持のため,その他に <literal>lang</literal> の値は,フランス語として
171 <literal>'fr'</literal> および英語として <literal>'en'</literal> を使用可能です.
172 デフォルト値は,<literal>scilab.start</literal>ファイルで指定されます.
174 <para>いくつかのシステムでは,UTF-8フォントを正しく描画するために,
177 <para>Scilab を以下のようにコールすることも可能です:</para>
178 <screen><![CDATA[ LANG=ja_JP scilab
188 このオプションが指定された場合, Scilabの Welcome バナーは表示されません.
195 <para>"No Startup files" :
196 このオプションが指定された場合, スタートアップファイル
197 <literal>SCI/etc/scilab.start</literal> およびユーザスタートアップファイル
198 <literal>SCIHOME/.scilab</literal>,
199 <literal>SCIHOME/scilab.ini</literal> は実行されません.
201 <para>このオプションは, Scilabの多くの機能を無効にします (動作を理解している場合のみ
207 <term>-nouserstartup</term>
209 <para>このオプションが指定された場合, スタートアップファイル
210 <literal>SCIHOME/.scilab</literal>,
211 <literal>SCIHOME/scilab.ini</literal> は実行されません.
216 <term>-noatomsautoload</term>
219 このオプションが指定された場合,イントール済みのATOMモジュールは
228 このオプションが指定された場合, Scilab は
229 先進的な機能(グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)
232 <para>Scilab 5.2以降:</para>
235 <para>全てのオペレーティングシステムについて
236 パイプが有効です (詳細については例を参照ください).
240 <para>Scilab のディストリビューションには,
241 <literal>-nw</literal>と同様のバイナリを提供します:
242 <literal>scilab-adv-cli</literal>
243 (Scilab Advanced Command Line Interpreter).
250 <term>-nwni / -nogui</term>
252 <important>このモードでは Java 仮想マシンはロードされません.
253 (起動は高速化され,メモリ消費量は減少します)
255 <para>このオプションが指定された場合, Scilab は先進的な機能
256 (グラフィック, export, xcos, scinotes, ヘルプブラウザ, ...)なしで
259 <para>Scilab 5.2以降:</para>
262 <para>全てのオペレーティングシステムについて
263 パイプが有効です (詳細については例を参照ください).
268 Scilab のディストリビューションでは,
269 <literal>-nwni</literal>と同じ専用バイナリが提供されています
270 : <literal>scilab-cli</literal>
271 (Scilab Command Line Interpreter).
278 <term>--texmacs</term>
280 <para>このオプションは TeXMacs用に予約されています.</para>
282 ATOMSモジュールをインストールしてください: <programlisting role="">atomsInstall('texmacs')</programlisting>
287 <term>-version</term>
289 <para>このオプションはプロダクトのバージョンを出力し,終了します.</para>
295 <refsection role="arguments">
296 <title>Additional options for Unix/Linux and Mac OS X</title>
297 <para>助言: これらのオプションをScilabソースツリー上で使用してください.</para>
302 <para>デバッガgdb上でScilabを開始します.</para>
304 gdb にカスタムオプションを追加する場合,
305 変数<literal>SCILAB_GDB_OPT</literal>を定義します.
310 <term>-debug-kdbg</term>
312 <para>kdbg上でScilabを開始します.</para>
316 <term>-profiling</term>
318 <para>valgrind上でScilabを開始します.</para>
320 valgrind にカスタムオプションを追加する場合
321 (および既存の valgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
327 <term>-profiling-visu</term>
329 <para>callgrind上でScilabを開始します.</para>
331 callgrind にカスタムオプションを追加する場合
332 (および既存の callgrind オプションを上書きする場合),SCILAB_VALGRIND_OPT
338 <term>-electric-fence</term>
340 <para>Electric Fence を指定して Scilab を開始します.</para>
346 <refsection role="description">
347 <title>環境変数の説明</title>
350 <term>SCIVERBOSE</term>
353 この変数が存在した場合, Scilab起動スクリプトは起動時デバッグ情報を表示します.
354 主にバグレポートおよびデバッグ目的で使用されます.
359 <term>JAVA_HOME</term>
363 <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> は
364 Java 7 でScilabを起動します.
369 <term>SCI_DISABLE_TK</term>
371 <para>Tk (Tclではなく) 機能を無効にします.</para>
375 <term>SCI_JAVA_ENABLE_HEADLESS</term>
378 ヘッドレスJava仮想マシン (すなわち,GUI機能なし).
384 <refsection role="description">
385 <title>Java 仮想マシンオプション</title>
387 The options described here-below are useless and are cancelled if the option <literal>-nwni</literal> is used.
389 <para>Scilab 5.0以降, グラフィカルユーザインターフェイス (GUI) および
390 ドキュメントの構築は,Java機能に基づいています.
392 JVM (Java仮想マシン)オプションを編集することが重要となります.
395 <emphasis>jvm_options.xml</emphasis>ファイルで利用可能です.
397 <para>5.0.X および 5.1.Xでは, このファイルは
398 <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>に保存されています.
400 <para>>= 5.2.0以降, このファイルは
402 etc/jvm_options.xml<emphasis> </emphasis>
406 <para>デフォルトで, 以下の3つのオプションが
411 <term>-XmxXXXm</term>
414 このオプションは,Java仮想マシンで利用可能なメモリ量を設定します.
415 デフォルトで, 256M が確保されます.
416 この値を変更した場合, その値がシステムで利用可能なメモリを
420 Scilab 5.4.0以降, この値は設定メニュー内で変更可能です.
425 <term>-Djava.compiler=JIT</term>
428 このオプションを引数<emphasis>JIT</emphasis>を付けて指定すると,
429 Java Just In Time compilerが有効になります.
430 このオプションはデフォルトで有効となります.
431 <emphasis>NONE</emphasis>によりJITは無効となり,
437 <term>-verbose:jni / -Xcheck:jni</term>
440 これらのオプションは,JNIコールとその出力をより詳細に確認します.
441 デバッグ時にはこれらのオプションを利用可能ですが,
442 性能を低下させるためデフォルトでは無効となっています.
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>
453 <refsection role="examples">
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"
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>
470 # Under GNU/Linux, Mac OS X or Unix:
471 $ echo "disp(%pi)"|scilab-cli
473 $ echo "disp(%pi)"|scilab -nwni
474 # Only open the Scilab help window:
475 $ scilab-adv-cli -e "help()"
477 $ scilab -nw -e "help()"
478 # Scilab can be used for scripting aspects:
479 echo "if 1<>2 then exit(99) end"|scilab-cli
482 <refsection role="see also">
484 <simplelist type="inline">
486 <link linkend="startup">startup</link>
489 <link linkend="sciargs">sciargs</link>
492 <link linkend="getpid">getpid</link>
495 <link linkend="getenv">getenv</link>
498 <link linkend="getenv">getversion</link>
501 <link linkend="consolebox">consolebox</link>
504 <link linkend="exit">exit</link>
508 <refsection role="history">
512 <revnumber>5.4.0</revnumber>
513 <revremark>-noatomsautoload が追加されました.</revremark>
516 <revnumber>5.4.1</revnumber>
517 <revremark>scinotes と xcos 個別スクリプトが導入されました. SEP #87参照.</revremark>
520 <revnumber>6.0.0</revnumber>
522 <literal>-quit</literal> option added. <literal>-mem</literal> option removed.