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="ru">
6 <refnamediv xml:id="wscilex">
8 <refnamediv xml:id="scilex">
11 <refname>scilex | scilab</refname>
13 главный файл-сценарий для запуска Scilab'а и различных инструментов
17 <title>Синтаксис</title>
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">
26 <title>Аргументы</title>
29 <term>-args arg№1 arg№2 ..</term>
32 Эта опция позволяет переслать данные в сессию Scilab'а:
35 Последовательность данных, разделённых одним или несколькими пробелами.
38 Выражение между двойными кавычками является единым куском данных.
41 Чтобы внести двойные кавычки в данные, запишите <literal>\"</literal> вместо <literal>"</literal>.
44 Одинарная кавычка <literal>'</literal> является обычным символом. У неё нет специального значения.
49 Внутри открытой сессии эти данные могут быть получены виде раздельных строк с помощью <link linkend="sciargs">sciargs()</link>.
53 <screen><![CDATA[C:\Users\Me> scilex -nb -args "Привет, \"%USERNAME%\"" 1.2345 \"%cd%\"]]></screen>
54 <programlisting><![CDATA[
55 // Внутри открытой сессии:
60 "Эта сессия была запущена из " + a(i+3)
64 --> // Внутри открытой сессии:
67 !c:\SCIdir\bin\scilex -nw -nb -noatomsautoload -args Привет, "Иван" 1.2345 "C:\Users\Me" !
69 --> i = find(a=="-args")
81 --> "Эта сессия была запущена из " + a(i+3)
83 Эта сессия была запущена из "C:\Users\Me"
90 Безопаснее использовать <literal>-args</literal> в качестве <emphasis role="italic">последней</emphasis> опции командной строки.
96 <term>-display Display</term>
99 Только для использования в системах Xwindow для установки специфичного
100 дисплея X-сервера. Дисплей по умолчанию -- unix:0.0.
103 <literal>-display</literal> можно сократить как <literal>-d</literal>.
108 <term>-e Instructions</term>
111 По окончании запуска всей сессии, этот вариант
115 устанавливает текущий рабочий каталог в каталог оболочки, из которой Scilab был запущен.
116 Пожалуйста, смотрите пример, приведенный здесь ниже для опции <literal>-f</literal>. Затем,
120 <para>эта опция выполняет инструкции Scilab <literal>Instructions</literal>, указанные в строке. Пример :
121 <screen><![CDATA[ scilab-cli -e "disp(\"Привет\"); a=%pi+%i; disp(exp(a)); exit;" -nb]]></screen>
127 Опции <literal>-e</literal> и <literal>-f</literal> взаимоисключающие.
135 Если эта опцпия используется, то в начале сессии Scilab, после исполнения файлов запуска Sciblab и
136 пользовательских файлов запуска, и после установки пользовательских настроек, включая настройки рабочей директории,
140 текущая рабочая директория Scilab устаровлена в каталоге оболочки, из которой Scilab был запущен. Например,
141 <screen><![CDATA[ D:\users\me\scilab\dev> C:\scilab-5.5.2\bin\scilex -f ..\test.sce]]></screen>
142 будет исполнять <literal>cd("D:\users\me\scilab\dev")</literal>.
147 Scilab-сценарий <literal>file</literal> выполнен. Если относительный путь используется
148 (по умолчанию <literal>.\</literal> или как <literal>..\</literal> в примере выше), то
149 он отсылается в новую рабочую директорию Scilab.
154 <para>Файл с расширением <literal>.xcos</literal> будет открыт в Xcos.</para>
161 Эта опция заставляет Scilab всегда выходить после инструкций, переданных вместе с опцией
162 <literal>-e</literal>, или сценарий, на который ссылается оция <literal>-f</literal>,
163 будет исполнен, даже в случае ошибки времени исполнения. Эта опция всегда должна использоваться
164 в режиме пакетной обработки. Она игнорируется, если нет ни опции <literal>-e</literal>
165 ни опции <literal>-f</literal>.
173 Если есть эта опция, то она фиксирует язык пользователя.
174 <emphasis>lang</emphasis> может быть: <emphasis>ca_ES de_DE en_US es_ES
175 fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
177 (начиная с Scilab 5.2).
180 Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal>
181 для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
182 Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
185 В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
187 <para>Scilab также может быть запущен следующим образом:</para>
188 <screen><![CDATA[ LANG=ja_JP scilab
198 "no banner" : Если есть эта опция, то сообщение о загрузке Scilab'а не будет отображаться.
207 Если есть эта опция, то файл запуска <literal>SCI/etc/scilab.start</literal> и пользовательские
208 файлы запуска <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal> не исполняются.
211 Эта опция отключит многие возможности Scilab'а (используйте, если вы знаете что делаете).
216 <term>-nouserstartup</term>
219 Если есть эта опция, то пользовательские файлы запуска <literal>SCIHOME/.scilab</literal> и
220 <literal>SCIHOME/scilab.ini</literal> не исполняются.
225 <term>-noatomsautoload</term>
228 Если есть эта опция, то ранее установленные модули ATOMS не загружаются для данной сессии.
236 Если есть эта опция,то Scilab запускается как командная строка с улучшенными возможностями (графические окна, экспорт, xcos, scinotes, справочная система, ...).
238 <para>Начиная с Scilab 5.2:</para>
242 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
248 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
249 делает то же, что и <literal>-nw</literal>: <literal>scilab-adv-cli</literal>
250 (Интерпретатор Scilab с улучшенной командной строкой).
257 <term>-nwni / -nogui</term>
260 Этот режим не загружает виртуальную машину Java (быстрее загружается и использует меньше памяти).
263 Если есть эта опция, то Scilab запускается как командная строка без улучшенных возможностей (графических окон, экспорта, xcos, scinotes, справочной системы, ...).
265 <para>Начиная с Scilab 5.2:</para>
269 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
275 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
276 делает то же, что и <literal>-nwni</literal>: <literal>scilab-cli</literal>
277 (Интерпретатор Scilab с улучшенной командной строкой).
284 <term>--texmacs</term>
286 <para>Эта опция предназначена для TeXMacs.</para>
287 <para>Пожалуйста, установите ATOMS-модуль TeXMacs:
288 <code>atomsInstall('texmacs')</code>
293 <term>-version</term>
295 <para>Эта опция выводит на экран версию продукта.</para>
301 <refsection role="arguments">
302 <title>Дополнительные опции для Unix/Linux и Mac OS X</title>
303 <para>Совет: используйте эти параметры в дереве исходников Scilab'а.</para>
309 Запуск Scilab'а в отладчике gdb.
312 Определите переменную <literal>SCILAB_GDB_OPT</literal> для добавления
313 пользовательских настроек в gdb.
318 <term>-debug-kdbg</term>
320 <para>Запуск Scilab'а в kdbg.</para>
324 <term>-profiling</term>
326 <para>Запуск Scilab'а в valgrind.</para>
328 Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для
329 добавления пользовательских настроек в valgrind (и отмены существующих
335 <term>-profiling-visu</term>
337 <para>Запуск Scilab'а в callgrind.</para>
339 Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для
340 добавления пользовательских настроек в callgrind (и отмены существующих
346 <term>-electric-fence</term>
348 <para>Запуск Scilab'а в Electric Fence.</para>
354 <refsection role="description">
355 <title>Описание переменных окружения</title>
358 <term>SCIVERBOSE</term>
361 Если есть эта переменная, то файл-сценарий начального запуска Scilab'а покажет
362 отладочную информацию начального запуска. Используется главным образом для сообщения об
368 <term>JAVA_HOME</term>
371 Определяет какую Java использовать. Например,
372 <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> запустить Scilab с Java 7.
377 <term>SCI_DISABLE_TK</term>
379 <para>Отключение возможностей Tk (не не Tcl).</para>
383 <term>SCI_JAVA_ENABLE_HEADLESS</term>
386 Включить Java Headless VM (т. е. без возможностей графического пользовательского интерфейса).
392 <refsection role="description">
393 <title>Опции виртуальной машины Java</title>
395 Опции, описаные ниже бесполезны и будут удалены, если используется опция <literal>-nwni</literal>.
398 Начиная с Scilab 5.0, графический пользовательский интерфейс (GUI) и встроенная
399 документация основаны на возможностях Java. В некоторых случаях может оказаться
400 важным править опции JVM (Виртуальная Машина Java).
403 Эти опции доступны в файле <emphasis>jvm_options.xml</emphasis>.
406 В версиях 5.0.X и 5.1.X этот файл хранится как
407 <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
410 В версии >= 5.2.0 этот файл доступен в
418 По умолчанию в конфигурационном файле легко доступны следующие три опции:
423 <term>-XmxXXXm</term>
426 Эта опция устанавливает количество памяти, доступной для виртуальной Java-машины. По умолчанию выделено 256 МБ. Если вы меняете это значение, убедитесь, что оно не превышает память системы.
429 Начиная с Scilab 5.4.0, это значение можно менять в меню настроек.
434 <term>-Djava.compiler=JIT</term>
437 Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный
438 Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает
439 оперативный Java-компилятор и чрезвычайно уменьшает производительность.
444 <term>-verbose:jni / -Xcheck:jni</term>
447 Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого
448 доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
454 Доступно очень много опций. Они могут улучшить производительность, поменять взгляды и
455 отношение, изменить способы управления памятью... Смотрите:: <ulink url="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp</ulink>
456 или <ulink url="http://blogs.sun.com/watt/resource/jvm-options-list.html">http://blogs.sun.com/watt/resource/jvm-options-list.html</ulink>.
459 <refsection role="examples">
460 <title>Примеры</title>
462 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
463 # Мы находимся в оболочке Bash
464 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
467 # Запустим Scilab в режиме отладки без остановки после каждого SIGSEGV
468 # Сначала запишем небольшой файл команд
469 echo "handle SIGSEGV nostop" &> debug.txt
470 # Теперь установим пользовательские опции
471 # Мы находимся в оболочке Bash
472 export SCILAB_GDB_OPT="--command=debug.txt"
473 # Запуск Scilab'а в режиме отладки
474 scilab -debug ]]></screen>
477 # В GNU/Linux, Mac OS X или Unix:
478 $ echo "disp(%pi)"|scilab-cli
480 $ echo "disp(%pi)"|scilab -nwni
482 # Открыть только окно справки Scilab:
483 $ scilab-adv-cli -e "help()"
485 $ scilab -nw -e "help()"
488 # Scilab может быть использован написания сценариев:
489 echo "if 1<>2 then exit(99) end"|scilab-cli
492 <refsection role="see also">
493 <title>Смотрите также</title>
494 <simplelist type="inline">
496 <link linkend="startup">начальный запуск</link>
499 <link linkend="sciargs">sciargs</link>
502 <link linkend="getpid">getpid</link>
505 <link linkend="getenv">getenv</link>
508 <link linkend="getenv">getversion</link>
511 <link linkend="consolebox">consolebox</link>
514 <link linkend="exit">exit</link>
518 <refsection role="history">
519 <title>История</title>
522 <revnumber>5.4.0</revnumber>
523 <revremark>добавлено -noatomsautoload.</revremark>
526 <revnumber>5.4.1</revnumber>
528 введены отдельные сценарии scinotes и xcos.
533 <revnumber>6.0.0</revnumber>
535 Добавлена опция <literal>-quit</literal>. Опция <literal>-mem</literal> удалена.