scilab/modules/core/help/ru_RU/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" 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="ru">
   3     <refnamediv>
   4         <refname>scilab</refname>
   5         <refpurpose>
   6             главный файл-сценарий для запуска Scilab'а и различных инструментов(GNU/Linux, Unix и Mac OS X)
   7         </refpurpose>
   8     </refnamediv>
   9     <refsynopsisdiv>
  10         <title>Последовательность вызова</title>
  11         <synopsis>
  12             scilab &lt;Options&gt;
  13             scilab-adv-cli &lt;Options&gt;
  14             scilab-cli &lt;Options&gt;
  15         </synopsis>
  16     </refsynopsisdiv>
  17     <refsection>
  18         <title>Описание</title>
  19         <variablelist>
  20             <varlistentry>
  21                 <term>-args Arguments</term>
  22                 <listitem>
  23                     <para>
  24                         Если есть эта опция, то в Scilab передаются аргументы <literal>Arguments</literal>.
  25                         Они могут затем быть получены с помощью функции
  26                         <link linkend="sciargs">sciargs</link>. Для множества передаваемых
  27                         аргументов используйте кавычки и разделяйте слова пробелами. Например,
  28                         <literal>scilab -args 'foo1 foo2'</literal>. Без этого неизвестные
  29                         аргументы не будут приняты.
  30                     </para>
  31                 </listitem>
  32             </varlistentry>
  33             <varlistentry>
  34                 <term>-display Display</term>
  35                 <listitem>
  36                     <para>
  37                         Только для использования в системах Xwindow для установки специфичного
  38                         дисплея X-сервера. Дисплей по умолчанию -- unix:0.0.
  39                     </para>
  40                     <para>
  41                         <literal>-display</literal> можно сократить как <literal>-d</literal>.
  42                     </para>
  43                 </listitem>
  44             </varlistentry>
  45             <varlistentry>
  46                 <term>-debug</term>
  47                 <listitem>
  48                     <para>
  49                         Запуск Scilab'а в отладчике gdb (только Unix/Linux/Mac OS X).
  50                     </para>
  51                     <para>
  52                         Определите переменную  <literal>SCILAB_GDB_OPT</literal> для добавления
  53                         пользовательских настроек в gdb.
  54                     </para>
  55                     <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
  56                 </listitem>
  57             </varlistentry>
  58             <varlistentry>
  59                 <term>-debug-kdbg</term>
  60                 <listitem>
  61                     <para>Запуск Scilab'а в kdbg (только Unix/Linux/Mac OS X).</para>
  62                     <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
  63                 </listitem>
  64             </varlistentry>
  65             <varlistentry>
  66                 <term>-profiling</term>
  67                 <listitem>
  68                     <para>Запуск Scilab'а в valgrind (только Unix/Linux/Mac OS X).</para>
  69                     <para>
  70                         Определите переменную  <literal>SCILAB_VALGRIND_OPT</literal>  для
  71                         добавления пользовательских настроек в valgrind (и отмены существующих
  72                         опций valgrind).
  73                     </para>
  74                     <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
  75                 </listitem>
  76             </varlistentry>
  77             <varlistentry>
  78                 <term>-profiling-visu</term>
  79                 <listitem>
  80                     <para>Запуск Scilab'а в callgrind (только Unix/Linux/Mac OS X).</para>
  81                     <para>
  82                         Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для
  83                         добавления пользовательских настроек в callgrind (и отмены существующих
  84                         опций callgrind).
  85                     </para>
  86                     <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
  87                 </listitem>
  88             </varlistentry>
  89             <varlistentry>
  90                 <term>-electric-fence</term>
  91                 <listitem>
  92                     <para>Запуск Scilab'а в Electric Fence (только Unix/Linux/Mac OS X).</para>
  93                     <para>Совет: используйте эту опцию в дереве исходников Scilab'а.</para>
  94                 </listitem>
  95             </varlistentry>
  96             <varlistentry>
  97                 <term>-e Instruction</term>
  98                 <listitem>
  99                     <para>
 100                         Если есть эта опция, то инструкция <literal>Instruction</literal> выполняется
 101                         первой (сразу же после исполнения файла запуска) в Scilab'e. Опции <literal>-e</literal>
 102                         и <literal>-f</literal> взаимоисключающие.
 103                     </para>
 104                     <para>
 105                         Заметьте, что с <literal>-e</literal> можно использовать несколько инструкций.
 106                     </para>
 107                     <programlisting role="no-scilab-exec">scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
 108                 </listitem>
 109             </varlistentry>
 110             <varlistentry>
 111                 <term>-f file</term>
 112                 <listitem>
 113                     <para>
 114                         Если есть эта опция, то файл-сценарий Scilab'a <literal>file</literal> исполняется
 115                         первым (сразу же после  исполнения файла запуска) в Scilab'e. <literal>-e</literal> и
 116                         <literal>-f</literal>  взаимоисключающие.
 117                     </para>
 118                     <para>Файл с расширением .xcos будет открыт в Xcos.</para>
 119                 </listitem>
 120             </varlistentry>
 121             <varlistentry>
 122                 <term>-l lang</term>
 123                 <listitem>
 124                     <para>
 125                         Если есть эта опция, то она фиксирует язык пользователя.
 126                         <emphasis>lang</emphasis> может быть: <emphasis>ca_ES de_DE en_US es_ES
 127                             fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW
 128                         </emphasis>
 129                         (начиная с Scilab 5.2).
 130                     </para>
 131                     <para>
 132                         Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal>
 133                         для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
 134                         Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
 135                     </para>
 136                     <para>
 137                         В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
 138                     </para>
 139                     <para>Scilab также может быть запущен следующим образом:</para>
 140                     <programlisting role="no-scilab-exec">LANG=ja_JP scilab
 141                         #  то же, что и
 142                         scilab -l ja_JP
 143                     </programlisting>
 144                 </listitem>
 145             </varlistentry>
 146             <varlistentry>
 147                 <term>-mem N</term>
 148                 <listitem>
 149                     <para>
 150                         Установка исходного размера стека <literal>stacksize</literal> для использования
 151                         совместно с опцией <literal>-ns</literal>. Без опции <literal>-ns</literal>
 152                         исходный размер стека <literal>stacksize</literal> устанавливается файлом-сценарием
 153                         <literal>scilab.start</literal>.
 154                     </para>
 155                 </listitem>
 156             </varlistentry>
 157             <varlistentry>
 158                 <term>-nb</term>
 159                 <listitem>
 160                     <para>
 161                         Если есть эта опция, то приветственный баннер Scilab'а не будет отображаться.
 162                     </para>
 163                 </listitem>
 164             </varlistentry>
 165             <varlistentry>
 166                 <term>-ns</term>
 167                 <listitem>
 168                     <para>
 169                         Если есть эта опция, то файл запуска <literal>SCI/etc/scilab.start</literal> и пользовательские
 170                         файлы запуска <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal> не исполняются.
 171                     </para>
 172                     <para>
 173                         Эта опция отключит многие возможности Scilab'а (используйте, если вы знаете что делаете).
 174                     </para>
 175                 </listitem>
 176             </varlistentry>
 177             <varlistentry>
 178                 <term>-nouserstartup</term>
 179                 <listitem>
 180                     <para>
 181                         Если есть эта опция, то пользовательские файлы запуска <literal>SCIHOME/.scilab</literal> и
 182                         <literal>SCIHOME/scilab.ini</literal> не исполняются.
 183                     </para>
 184                 </listitem>
 185             </varlistentry>
 186             <varlistentry>
 187                 <term>-noatomsautoload</term>
 188                 <listitem>
 189                     <para>
 190                         Если есть эта опция, то ранее установленные модули ATOMS не загружаются для данной сессии.
 191                     </para>
 192                 </listitem>
 193             </varlistentry>
 194             <varlistentry>
 195                 <term>-nw</term>
 196                 <listitem>
 197                     <para>
 198                         Если есть эта опция,то Scilab запускается как командная строка с улучшенными возможностями (графические окна, экспорт, xcos, scinotes, справочная система, ...).
 199                     </para>
 200                     <para>
 201                         Эта опция может быть использована совместно с опциями <literal>-f</literal> и <literal>-e</literal>.
 202                     </para>
 203                     <para>Начиная с Scilab 5.2:</para>
 204                     <itemizedlist>
 205                         <listitem>
 206                             <para>
 207                                 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
 208                                 делает то же, что и <literal>-nw</literal>: <literal>scilab-adv-cli</literal>
 209                                 (Интерпретатор Scilab с улучшенной командной строкой).
 210                             </para>
 211                         </listitem>
 212                         <listitem>
 213                             <para>
 214                                 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
 215                                 информации).
 216                             </para>
 217                         </listitem>
 218                     </itemizedlist>
 219                 </listitem>
 220             </varlistentry>
 221             <varlistentry>
 222                 <term>-nwni / -nogui</term>
 223                 <listitem>
 224                     <para>
 225                         Если есть эта опция, то Scilab запускается как командная строка без улучшенных возможностей (графических окон, экспорта, xcos, scinotes, справочной системы, ...).
 226                     </para>
 227                     <para>
 228                         Эта опция может использоваться совместно с опциями <literal>-f</literal> или
 229                         <literal>-e</literal>.
 230                     </para>
 231                     <para>Начиная с Scilab 5.2:</para>
 232                     <itemizedlist>
 233                         <listitem>
 234                             <para>
 235                                 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
 236                                 делает то же, что и <literal>-nwni</literal>: <literal>scilab-cli</literal>
 237                                 (Интерпретатор Scilab с улучшенной командной строкой).
 238                             </para>
 239                         </listitem>
 240                     </itemizedlist>
 241                     <itemizedlist>
 242                         <listitem>
 243                             <para>
 244                                 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
 245                                 информации).
 246                             </para>
 247                         </listitem>
 248                     </itemizedlist>
 249                     <para>
 250                         Этот режим не загружает виртуальную машину Java (быстрее загружается и использует меньше памяти.
 251                     </para>
 252                 </listitem>
 253             </varlistentry>
 254             <varlistentry>
 255                 <term>--texmacs</term>
 256                 <listitem>
 257                     <para>Эта опция предназначена для TeXMacs.</para>
 258                     <para>Пожалуйста, установите ATOMS-модуль TeXMacs:
 259                         <programlisting role="">atomsInstall('texmacs')</programlisting>atomsInstall('texmacs')
 260                     </para>
 261                 </listitem>
 262             </varlistentry>
 263             <varlistentry>
 264                 <term>-version</term>
 265                 <listitem>
 266                     <para>Эта опция выводит на экран версию продукта и выходит.</para>
 267                 </listitem>
 268             </varlistentry>
 269         </variablelist>
 270     </refsection>
 271     <refsection>
 272         <title>Описание переменных окружения</title>
 273         <variablelist>
 274             <varlistentry>
 275                 <term>SCIVERBOSE</term>
 276                 <listitem>
 277                     <para>
 278                         Если есть эта переменная, то файл-сценарий начального запуска Scilab'а покажет
 279                         отладочную информацию начального запуска. Используется главным образом для сообщения об
 280                         ошибках и отладки.
 281                     </para>
 282                 </listitem>
 283             </varlistentry>
 284             <varlistentry>
 285                 <term>JAVA_HOME</term>
 286                 <listitem>
 287                     <para>
 288                         Определяет какую Java использовать. Например,
 289                         <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> запустить Scilab с Java 7.
 290                     </para>
 291                 </listitem>
 292             </varlistentry>
 293             <varlistentry>
 294                 <term>SCI_DISABLE_TK</term>
 295                 <listitem>
 296                     <para>Отключение возможностей Tk (не не Tcl).</para>
 297                 </listitem>
 298             </varlistentry>
 299             <varlistentry>
 300                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
 301                 <listitem>
 302                     <para>
 303                         Включить Java Headless VM (т. е. без возможностей графического пользовательского интерфейса).
 304                     </para>
 305                 </listitem>
 306             </varlistentry>
 307         </variablelist>
 308     </refsection>
 309     <refsection>
 310         <title>Опции виртуальной машины Java</title>
 311         <para>
 312             Начиная с Scilab 5.0, графический пользовательский интерфейс (GUI) и встроенная
 313             документация основаны на возможностях Java. В некоторых случаях может оказаться
 314             важным править опции JVM (Виртуальная Машина Java).
 315         </para>
 316         <para>
 317             Эти опции доступны в файле <emphasis>jvm_options.xml</emphasis>.
 318         </para>
 319         <para>
 320             В версиях 5.0.X и 5.1.X этот файл хранится как
 321             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
 322         </para>
 323         <para>
 324             В версии &gt;= 5.2.0 этот файл доступен в
 325             <emphasis>
 326                 etc/jvm_options.xml
 327             </emphasis>
 328             .
 329         </para>
 330         <para>
 331             <emphasis>
 332                 По умолчанию в конфигурационном файле легко доступны следующие три опции:
 333             </emphasis>
 334         </para>
 335         <variablelist>
 336             <varlistentry>
 337                 <term>-XmxXXXm</term>
 338                 <listitem>
 339                     <para>
 340                         Эта опция устанавливает количество памяти, доступной для виртуальной Java-машины. По умолчанию выделено 256 МБ. Если вы меняете это значение, убедитесь, что оно не превышает память системы.
 341                     </para>
 342                     <para>
 343                         Начиная с Scilab 5.4.0, это значение можно менять в меню настроек.
 344                     </para>
 345                 </listitem>
 346             </varlistentry>
 347             <varlistentry>
 348                 <term>-Djava.compiler=JIT</term>
 349                 <listitem>
 350                     <para>
 351                         Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный
 352                         Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает
 353                         оперативный Java-компилятор и чрезвычайно уменьшает производительность.
 354                     </para>
 355                 </listitem>
 356             </varlistentry>
 357             <varlistentry>
 358                 <term>-verbose:jni / -Xcheck:jni</term>
 359                 <listitem>
 360                     <para>
 361                         Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого
 362                         доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
 363                     </para>
 364                 </listitem>
 365             </varlistentry>
 366         </variablelist>
 367         <para>
 368             Доступно очень много опций. Они могут улучшить производительность, поменять взгляды и
 369             отношение, изменить способы управления памятью... Смотрите:: <ulink url="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp</ulink>
 370             или <ulink url="http://blogs.sun.com/watt/resource/jvm-options-list.html">http://blogs.sun.com/watt/resource/jvm-options-list.html</ulink>.
 371         </para>
 372     </refsection>
 373     <refsection>
 374         <title>Примеры</title>
 375         <programlisting role="example"><![CDATA[
 376 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
 377 # Мы находимся в оболочке Bash
 378 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
 379 scilab -profiling
 380
 381 # Запустим Scilab в режиме отладки без остановки после каждого SIGSEGV
 382 # Сначала запишем небольшой файл команд
 383 echo "handle SIGSEGV nostop" &> debug.txt
 384 # Теперь установим пользовательские опции
 385 # Мы находимся в оболочке Bash
 386 export SCILAB_GDB_OPT="--command=debug.txt"
 387 # Запуск Scilab'а в режиме отладки
 388 scilab -debug
 389 ]]></programlisting>
 390         <programlisting role="example-cli"><![CDATA[
 391 # В GNU/Linux, Mac OS X или Unix:
 392 $ echo "disp(%pi)"|scilab-cli
 393 или
 394 $ echo "disp(%pi)"|scilab -nwni
 395
 396 # Открыть только окно справки Scilab:
 397 $ scilab-adv-cli -e "help()"
 398 или
 399 $ scilab -nw -e "help()"
 400
 401
 402 # Scilab может быть использован написания сценариев:
 403 echo "if 1<>2 then exit(99) end"|scilab-cli
 404 echo $? ]]></programlisting>
 405     </refsection>
 406     <refsection role="see also">
 407         <title>Смотрите также</title>
 408         <simplelist type="inline">
 409             <member>
 410                 <link linkend="exit">exit</link>
 411             </member>
 412             <member>
 413                 <link linkend="startup">начальный запуск</link>
 414             </member>
 415         </simplelist>
 416     </refsection>
 417     <refsection>
 418         <title>История</title>
 419         <revhistory>
 420             <revision>
 421                 <revnumber>5.4.0</revnumber>
 422                 <revremark>добавлено -noatomsautoload.</revremark>
 423             </revision>
 424         </revhistory>
 425     </refsection>
 426 </refentry>