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" version="5.0-subset Scilab" 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 запускается как командная строка с улучшенными возможностями (графические окна...).
 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 запускается как командная строка без улучшенных возможностей.
 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         </listitem>
 343       </varlistentry>
 344       <varlistentry>
 345         <term>-Djava.compiler=JIT</term>
 346         <listitem>
 347           <para>
 348             Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный
 349             Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает
 350             оперативный Java-компилятор и чрезвычайно уменьшает производительность.
 351           </para>
 352         </listitem>
 353       </varlistentry>
 354       <varlistentry>
 355         <term>-verbose:jni / -Xcheck:jni</term>
 356         <listitem>
 357           <para>
 358             Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого
 359             доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
 360           </para>
 361         </listitem>
 362       </varlistentry>
 363     </variablelist>
 364     <para>
 365       Доступно очень много опций. Они могут улучшить производительность, поменять взгляды и
 366       отношение, изменить способы управления памятью... Смотрите:: <ulink url="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp</ulink>
 367       или <ulink url="http://blogs.sun.com/watt/resource/jvm-options-list.html">http://blogs.sun.com/watt/resource/jvm-options-list.html</ulink>.
 368     </para>
 369   </refsection>
 370   <refsection>
 371     <title>Примеры</title>
 372     <programlisting role="example"><![CDATA[
 373 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
 374 # Мы находимся в оболочке Bash
 375 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
 376 scilab -profiling
 377
 378 # Запустим Scilab в режиме отладки без остановки после каждого SIGSEGV
 379 # Сначала запишем небольшой файл команд
 380 echo "handle SIGSEGV nostop" &> debug.txt
 381 # Теперь установим пользовательские опции
 382 # Мы находимся в оболочке Bash
 383 export SCILAB_GDB_OPT="--command=debug.txt"
 384 # Запуск Scilab'а в режиме отладки
 385 scilab -debug
 386 ]]></programlisting>
 387     <programlisting role="example-cli"><![CDATA[
 388 # В GNU/Linux, Mac OS X или Unix:
 389 $ echo "disp(%pi)"|scilab-cli
 390 или
 391 $ echo "disp(%pi)"|scilab -nwni
 392
 393 # Открыть только окно справки Scilab:
 394 $ scilab-adv-cli -e "help()"
 395 или
 396 $ scilab -nw -e "help()"
 397
 398
 399 # Scilab может быть использован написания сценариев:
 400 echo "if 1<>2 then exit(99) end"|scilab-cli
 401 echo $? ]]></programlisting>
 402   </refsection>
 403   <refsection role="see also">
 404     <title>Смотрите также</title>
 405     <simplelist type="inline">
 406       <member>
 407         <link linkend="exit">exit</link>
 408       </member>
 409       <member>
 410         <link linkend="startup">начальный запуск</link>
 411       </member>
 412     </simplelist>
 413   </refsection>
 414   <refsection>
 415     <title>История</title>
 416     <revhistory>
 417       <revision>
 418         <revnumber>5.4.0</revnumber>
 419         <revremark>добавлено -noatomsautoload.</revremark>
 420       </revision>
 421     </revhistory>
 422   </refsection>
 423 </refentry>