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"
   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">
   7     </refnamediv>
   8     <refnamediv xml:id="scilex">
   9     </refnamediv>
  10     <refnamediv>
  11         <refname>scilex | scilab</refname>
  12         <refpurpose>
  13             главный файл-сценарий для запуска Scilab'а и различных инструментов
  14         </refpurpose>
  15     </refnamediv>
  16     <refsynopsisdiv>
  17         <title>Синтаксис</title>
  18         <synopsis>
  19 #      MS Windows          |  # Linux / Unix / Mac OS X
  20 wscilex     &lt;Options&gt;     |  scilab         &lt;Options&gt;
  21 wscilex -nw &lt;Options&gt; |  scilab-adv-cli &lt;Options&gt;
  22 scilex      &lt;Options&gt;      |  scilab-cli     &lt;Options&gt;
  23         </synopsis>
  24     </refsynopsisdiv>
  25     <refsection role="arguments">
  26         <title>Аргументы</title>
  27         <variablelist>
  28             <varlistentry>
  29                 <term>-args arg№1 arg№2 ..</term>
  30                 <listitem>
  31                     <para>
  32                         Эта опция позволяет переслать  данные в сессию Scilab'а:
  33                         <itemizedlist>
  34                             <listitem>
  35                               Последовательность данных, разделённых одним или несколькими пробелами.
  36                             </listitem>
  37                             <listitem>
  38                               Выражение между двойными кавычками является единым куском данных.
  39                             </listitem>
  40                             <listitem>
  41                               Чтобы внести двойные кавычки в данные, запишите <literal>\"</literal> вместо <literal>"</literal>.
  42                             </listitem>
  43                             <listitem>
  44                               Одинарная кавычка <literal>'</literal> является обычным символом. У неё нет специального значения.
  45                             </listitem>
  46                         </itemizedlist>
  47                     </para>
  48                     <para>
  49                       Внутри открытой сессии эти данные могут быть получены  виде раздельных строк с помощью <link linkend="sciargs">sciargs()</link>.
  50                      </para>
  51                      <para>
  52                       Пример:
  53                         <screen><![CDATA[C:\Users\Me> scilex -nb -args "Привет, \"%USERNAME%\"" 1.2345 \"%cd%\"]]></screen>
  54                         <programlisting><![CDATA[
  55 // Внутри открытой сессии:
  56 a = sciargs()
  57 i = find(a=="-args")
  58 a(i+1)
  59 evstr(a(i+2))*2
  60 "Эта сессия была запущена из " + a(i+3)
  61                         ]]>
  62                         </programlisting>
  63                         <screen><![CDATA[
  64 --> // Внутри открытой сессии:
  65 --> a = sciargs()
  66  a  =
  67 !c:\SCIdir\bin\scilex  -nw  -nb  -noatomsautoload  -args  Привет, "Иван"  1.2345  "C:\Users\Me" !
  68
  69 --> i = find(a=="-args")
  70  i  =
  71     5.
  72
  73 --> a(i+1)
  74  ans  =
  75  Привет, "Иван"
  76
  77 --> evstr(a(i+2))*2
  78  ans  =
  79     2.469
  80
  81 --> "Эта сессия была запущена из " + a(i+3)
  82  ans  =
  83  Эта сессия была запущена из "C:\Users\Me"
  84
  85 -->
  86 ]]></screen>
  87                      </para>
  88                      <para>
  89                      <note>
  90                        Безопаснее использовать <literal>-args</literal> в качестве <emphasis role="italic">последней</emphasis> опции командной строки.
  91                      </note>
  92                      </para>
  93                 </listitem>
  94             </varlistentry>
  95             <varlistentry>
  96                 <term>-display Display</term>
  97                 <listitem>
  98                     <para>
  99                         Только для использования в системах Xwindow для установки специфичного
 100                         дисплея X-сервера. Дисплей по умолчанию -- unix:0.0.
 101                     </para>
 102                     <para>
 103                         <literal>-display</literal> можно сократить как <literal>-d</literal>.
 104                     </para>
 105                 </listitem>
 106             </varlistentry>
 107             <varlistentry>
 108                 <term>-e Instructions</term>
 109                 <listitem>
 110                     <para>
 111                         По окончании запуска всей сессии, этот вариант
 112                         <itemizedlist>
 113                             <listitem>
 114                                 <para>
 115                                   устанавливает текущий рабочий каталог в каталог оболочки, из которой Scilab был запущен.
 116                                   Пожалуйста, смотрите пример, приведенный здесь ниже для опции <literal>-f</literal>. Затем,
 117                                 </para>
 118                             </listitem>
 119                             <listitem>
 120                                 <para>эта опция выполняет инструкции Scilab <literal>Instructions</literal>, указанные в строке. Пример :
 121                                     <screen><![CDATA[ scilab-cli -e  "disp(\"Привет\"); a=%pi+%i; disp(exp(a)); exit;" -nb]]></screen>
 122                                 </para>
 123                             </listitem>
 124                         </itemizedlist>
 125                     </para>
 126                     <warning>
 127                         Опции <literal>-e</literal> и <literal>-f</literal> взаимоисключающие.
 128                     </warning>
 129                 </listitem>
 130             </varlistentry>
 131             <varlistentry>
 132                 <term>-f file</term>
 133                 <listitem>
 134                     <para>
 135                         Если эта опцпия используется, то в начале сессии Scilab, после исполнения файлов запуска Sciblab и
 136                         пользовательских файлов запуска, и после установки пользовательских настроек, включая настройки рабочей директории,
 137                         <itemizedlist>
 138                             <listitem>
 139                                 <para>
 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>.
 143                                 </para>
 144                             </listitem>
 145                             <listitem>
 146                                 <para>
 147                                     Scilab-сценарий <literal>file</literal> выполнен. Если относительный путь используется
 148                                     (по умолчанию <literal>.\</literal> или как <literal>..\</literal> в примере выше), то
 149                                     он отсылается в новую рабочую директорию Scilab.
 150                                 </para>
 151                             </listitem>
 152                         </itemizedlist>
 153                     </para>
 154                   <para>Файл с расширением <literal>.xcos</literal> будет открыт в Xcos.</para>
 155                 </listitem>
 156             </varlistentry>
 157             <varlistentry>
 158                 <term>-quit</term>
 159                 <listitem>
 160                     <para>
 161                         Эта опция заставляет Scilab всегда выходить после инструкций, переданных вместе с опцией
 162                         <literal>-e</literal>, или  сценарий, на который ссылается оция <literal>-f</literal>,
 163                         будет исполнен, даже в случае ошибки времени исполнения. Эта опция всегда должна использоваться
 164                         в режиме пакетной обработки. Она игнорируется, если нет ни опции <literal>-e</literal>
 165                         ни опции <literal>-f</literal>.
 166                     </para>
 167                 </listitem>
 168             </varlistentry>
 169             <varlistentry>
 170                 <term>-l lang</term>
 171                 <listitem>
 172                     <para>
 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
 176                         </emphasis>
 177                         (начиная с Scilab 5.2).
 178                     </para>
 179                     <para>
 180                         Другими возможными значениями <literal>lang</literal> (для совместимости) являются <literal>'fr'</literal>
 181                         для французского и <literal>'en'</literal> для английского языка. По умолчанию язык английский.
 182                         Это значение по умолчанию зафиксировано в файле <literal>scilab.start</literal>.
 183                     </para>
 184                     <para>
 185                         В некоторых системах для правильного отображения шрифтов в кодировке UTF-8 локали должны быть откомпилированы.
 186                     </para>
 187                     <para>Scilab также может быть запущен следующим образом:</para>
 188                     <screen><![CDATA[ LANG=ja_JP scilab
 189  #  то же, что и
 190  scilab -l ja_JP
 191 ]]></screen>
 192                 </listitem>
 193             </varlistentry>
 194             <varlistentry>
 195                 <term>-nb</term>
 196                 <listitem>
 197                     <para>
 198                         "no banner" : Если есть эта опция, то сообщение о загрузке Scilab'а не будет отображаться.
 199                     </para>
 200                 </listitem>
 201             </varlistentry>
 202             <varlistentry>
 203                 <term>-ns</term>
 204                 <listitem>
 205                     <para>
 206                         "No Startup files" :
 207                         Если есть эта опция, то файл запуска <literal>SCI/etc/scilab.start</literal> и пользовательские
 208                         файлы запуска <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal> не исполняются.
 209                     </para>
 210                     <para>
 211                         Эта опция отключит многие возможности Scilab'а (используйте, если вы знаете что делаете).
 212                     </para>
 213                 </listitem>
 214             </varlistentry>
 215             <varlistentry>
 216                 <term>-nouserstartup</term>
 217                 <listitem>
 218                     <para>
 219                         Если есть эта опция, то пользовательские файлы запуска <literal>SCIHOME/.scilab</literal> и
 220                         <literal>SCIHOME/scilab.ini</literal> не исполняются.
 221                     </para>
 222                 </listitem>
 223             </varlistentry>
 224             <varlistentry>
 225                 <term>-noatomsautoload</term>
 226                 <listitem>
 227                     <para>
 228                         Если есть эта опция, то ранее установленные модули ATOMS не загружаются для данной сессии.
 229                     </para>
 230                 </listitem>
 231             </varlistentry>
 232             <varlistentry>
 233                 <term>-nw</term>
 234                 <listitem>
 235                     <para>
 236                         Если есть эта опция,то Scilab запускается как командная строка с улучшенными возможностями (графические окна, экспорт, xcos, scinotes, справочная система, ...).
 237                     </para>
 238                     <para>Начиная с Scilab 5.2:</para>
 239                     <itemizedlist>
 240                         <listitem>
 241                             <para>
 242                                 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
 243                                 информации).
 244                             </para>
 245                         </listitem>
 246                         <listitem>
 247                             <para>
 248                                 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
 249                                 делает то же, что и <literal>-nw</literal>: <literal>scilab-adv-cli</literal>
 250                                 (Интерпретатор Scilab с улучшенной командной строкой).
 251                             </para>
 252                         </listitem>
 253                     </itemizedlist>
 254                 </listitem>
 255             </varlistentry>
 256             <varlistentry>
 257                 <term>-nwni / -nogui</term>
 258                 <listitem>
 259                     <important>
 260                         Этот режим не загружает виртуальную машину Java (быстрее загружается и использует меньше памяти).
 261                     </important>
 262                     <para>
 263                         Если есть эта опция, то Scilab запускается как командная строка без улучшенных возможностей (графических окон, экспорта, xcos, scinotes, справочной системы, ...).
 264                     </para>
 265                     <para>Начиная с Scilab 5.2:</para>
 266                     <itemizedlist>
 267                         <listitem>
 268                             <para>
 269                                 конвейеры доступны во всех операционных системах (см. примеры для дополнительной
 270                                 информации).
 271                             </para>
 272                         </listitem>
 273                         <listitem>
 274                             <para>
 275                                 Дистрибутив Scilab также предоставляет специальный бинарный файл, который
 276                                 делает то же, что и <literal>-nwni</literal>: <literal>scilab-cli</literal>
 277                                 (Интерпретатор Scilab с улучшенной командной строкой).
 278                             </para>
 279                         </listitem>
 280                     </itemizedlist>
 281                 </listitem>
 282             </varlistentry>
 283             <varlistentry>
 284                 <term>--texmacs</term>
 285                 <listitem>
 286                     <para>Эта опция предназначена для TeXMacs.</para>
 287                     <para>Пожалуйста, установите ATOMS-модуль TeXMacs:
 288                         <code>atomsInstall('texmacs')</code>
 289                     </para>
 290                 </listitem>
 291             </varlistentry>
 292             <varlistentry>
 293                 <term>-version</term>
 294                 <listitem>
 295                     <para>Эта опция выводит на экран версию продукта.</para>
 296                 </listitem>
 297             </varlistentry>
 298         </variablelist>
 299     </refsection>
 300
 301     <refsection role="arguments">
 302         <title>Дополнительные опции для Unix/Linux и Mac OS X</title>
 303         <para>Совет: используйте эти параметры в дереве исходников Scilab'а.</para>
 304         <variablelist>
 305             <varlistentry>
 306                 <term>-debug</term>
 307                 <listitem>
 308                     <para>
 309                         Запуск Scilab'а в отладчике gdb.
 310                     </para>
 311                     <para>
 312                         Определите переменную  <literal>SCILAB_GDB_OPT</literal> для добавления
 313                         пользовательских настроек в gdb.
 314                     </para>
 315                 </listitem>
 316             </varlistentry>
 317             <varlistentry>
 318                 <term>-debug-kdbg</term>
 319                 <listitem>
 320                     <para>Запуск Scilab'а в kdbg.</para>
 321                 </listitem>
 322             </varlistentry>
 323             <varlistentry>
 324                 <term>-profiling</term>
 325                 <listitem>
 326                     <para>Запуск Scilab'а в valgrind.</para>
 327                     <para>
 328                         Определите переменную  <literal>SCILAB_VALGRIND_OPT</literal>  для
 329                         добавления пользовательских настроек в valgrind (и отмены существующих
 330                         опций valgrind).
 331                     </para>
 332                 </listitem>
 333             </varlistentry>
 334             <varlistentry>
 335                 <term>-profiling-visu</term>
 336                 <listitem>
 337                     <para>Запуск Scilab'а в callgrind.</para>
 338                     <para>
 339                         Определите переменную <literal>SCILAB_VALGRIND_OPT</literal> для
 340                         добавления пользовательских настроек в callgrind (и отмены существующих
 341                         опций callgrind).
 342                     </para>
 343                 </listitem>
 344             </varlistentry>
 345             <varlistentry>
 346                 <term>-electric-fence</term>
 347                 <listitem>
 348                     <para>Запуск Scilab'а в Electric Fence.</para>
 349                 </listitem>
 350             </varlistentry>
 351         </variablelist>
 352     </refsection>
 353
 354     <refsection role="description">
 355         <title>Описание переменных окружения</title>
 356         <variablelist>
 357             <varlistentry>
 358                 <term>SCIVERBOSE</term>
 359                 <listitem>
 360                     <para>
 361                         Если есть эта переменная, то файл-сценарий начального запуска Scilab'а покажет
 362                         отладочную информацию начального запуска. Используется главным образом для сообщения об
 363                         ошибках и отладки.
 364                     </para>
 365                 </listitem>
 366             </varlistentry>
 367             <varlistentry>
 368                 <term>JAVA_HOME</term>
 369                 <listitem>
 370                     <para>
 371                         Определяет какую Java использовать. Например,
 372                         <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> запустить Scilab с Java 7.
 373                     </para>
 374                 </listitem>
 375             </varlistentry>
 376             <varlistentry>
 377                 <term>SCI_DISABLE_TK</term>
 378                 <listitem>
 379                     <para>Отключение возможностей Tk (не не Tcl).</para>
 380                 </listitem>
 381             </varlistentry>
 382             <varlistentry>
 383                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
 384                 <listitem>
 385                     <para>
 386                         Включить Java Headless VM (т. е. без возможностей графического пользовательского интерфейса).
 387                     </para>
 388                 </listitem>
 389             </varlistentry>
 390         </variablelist>
 391     </refsection>
 392     <refsection role="description">
 393         <title>Опции виртуальной машины Java</title>
 394         <warning>
 395             Опции, описаные ниже бесполезны и будут удалены, если используется опция <literal>-nwni</literal>.
 396         </warning>
 397         <para>
 398             Начиная с Scilab 5.0, графический пользовательский интерфейс (GUI) и встроенная
 399             документация основаны на возможностях Java. В некоторых случаях может оказаться
 400             важным править опции JVM (Виртуальная Машина Java).
 401         </para>
 402         <para>
 403             Эти опции доступны в файле <emphasis>jvm_options.xml</emphasis>.
 404         </para>
 405         <para>
 406             В версиях 5.0.X и 5.1.X этот файл хранится как
 407             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
 408         </para>
 409         <para>
 410             В версии &gt;= 5.2.0 этот файл доступен в
 411             <emphasis>
 412                 etc/jvm_options.xml
 413             </emphasis>
 414             .
 415         </para>
 416         <para>
 417             <emphasis>
 418                 По умолчанию в конфигурационном файле легко доступны следующие три опции:
 419             </emphasis>
 420         </para>
 421         <variablelist>
 422             <varlistentry>
 423                 <term>-XmxXXXm</term>
 424                 <listitem>
 425                     <para>
 426                         Эта опция устанавливает количество памяти, доступной для виртуальной Java-машины. По умолчанию выделено 256 МБ. Если вы меняете это значение, убедитесь, что оно не превышает память системы.
 427                     </para>
 428                     <para>
 429                         Начиная с Scilab 5.4.0, это значение можно менять в меню настроек.
 430                     </para>
 431                 </listitem>
 432             </varlistentry>
 433             <varlistentry>
 434                 <term>-Djava.compiler=JIT</term>
 435                 <listitem>
 436                     <para>
 437                         Эта опция с аргументом <emphasis>JIT</emphasis> задействует оперативный
 438                         Java-компилятор (JIT). Он включается по умолчанию. <emphasis>NONE</emphasis> отключает
 439                         оперативный Java-компилятор и чрезвычайно уменьшает производительность.
 440                     </para>
 441                 </listitem>
 442             </varlistentry>
 443             <varlistentry>
 444                 <term>-verbose:jni / -Xcheck:jni</term>
 445                 <listitem>
 446                     <para>
 447                         Эти опции задействуют больше проверок и выход из вызовов интерфейса для прямого
 448                         доступа из Java. Эти опции полезны в случае отладки и по умолчанию отключены, поскольку они уменьшают производительность.
 449                     </para>
 450                 </listitem>
 451             </varlistentry>
 452         </variablelist>
 453         <para>
 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>.
 457         </para>
 458     </refsection>
 459     <refsection role="examples">
 460         <title>Примеры</title>
 461         <screen><![CDATA[
 462 # Запустим Scilab в режиме профилирования без прикрепления gdb после каждого SIGSEGV.
 463 # Мы находимся в оболочке Bash
 464 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
 465 scilab -profiling
 466
 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>
 475         <para></para>
 476         <screen><![CDATA[
 477 # В GNU/Linux, Mac OS X или Unix:
 478 $ echo "disp(%pi)"|scilab-cli
 479 или
 480 $ echo "disp(%pi)"|scilab -nwni
 481
 482 # Открыть только окно справки Scilab:
 483 $ scilab-adv-cli -e "help()"
 484 или
 485 $ scilab -nw -e "help()"
 486
 487
 488 # Scilab может быть использован написания сценариев:
 489 echo "if 1<>2 then exit(99) end"|scilab-cli
 490 echo $? ]]></screen>
 491     </refsection>
 492     <refsection role="see also">
 493         <title>Смотрите также</title>
 494         <simplelist type="inline">
 495             <member>
 496                 <link linkend="startup">начальный запуск</link>
 497             </member>
 498             <member>
 499                 <link linkend="sciargs">sciargs</link>
 500             </member>
 501             <member>
 502                 <link linkend="getpid">getpid</link>
 503             </member>
 504             <member>
 505                 <link linkend="getenv">getenv</link>
 506             </member>
 507             <member>
 508                 <link linkend="getenv">getversion</link>
 509             </member>
 510             <member>
 511                 <link linkend="consolebox">consolebox</link>
 512             </member>
 513             <member>
 514                 <link linkend="exit">exit</link>
 515             </member>
 516         </simplelist>
 517     </refsection>
 518     <refsection role="history">
 519         <title>История</title>
 520         <revhistory>
 521             <revision>
 522                 <revnumber>5.4.0</revnumber>
 523                 <revremark>добавлено -noatomsautoload.</revremark>
 524             </revision>
 525             <revision>
 526                 <revnumber>5.4.1</revnumber>
 527                 <revremark>
 528                     введены отдельные сценарии scinotes и xcos.
 529                     См.SEP #87.
 530                 </revremark>
 531             </revision>
 532             <revision>
 533                 <revnumber>6.0.0</revnumber>
 534                 <revremark>
 535                     Добавлена опция <literal>-quit</literal>. Опция <literal>-mem</literal> удалена.
 536                 </revremark>
 537             </revision>
 538         </revhistory>
 539     </refsection>
 540 </refentry>