scilex | scilab

Options

-args arg#1 arg#2 ..

Cette option permet de transmettre des données à la session Scilab à ouvrir :

• Des données consécutives sont séparées par un ou plusieurs espaces.
• Une expression entre guillemets " constitue une donnée unique.
• Pour inclure un guillemet dans une donnée, écrire \" au lieu de ".
• L'apostrophe ' est un caractère normal. Il n'a pas de signification particulière.

Dans la session ouverte, les données arg#1, arg#2, .. peuvent être récupérées comme autant d'expressions texte avec sciargs().

Exemple :

C:\Users\Me> scilex -nb -noatomsautoload -args "Hello \"%USERNAME%\"" 1.2345 \"%cd%\" 

// Dans la session ouverte :
a = sciargs()
i = find(a=="-args")
a(i+1)
evstr(a(i+2))*2
"Cette session a été lancée depuis " + a(i+3)

--> // Dans la session ouverte :
--> a = sciargs()
 a  =
!c:\SCIdir\bin\scilex  -nw  -nb  -noatomsautoload  -args  Hello "John"  1.2345  "C:\Users\Me" !

--> i = find(a=="-args")
 i  =
    5.

--> a(i+1)
 ans  =
 Hello "John"

--> evstr(a(i+2))*2
 ans  =
    2.469

--> "Cette session a été lancée depuis " + a(i+3)
 ans  =
 Cette session a été lancée depuis "C:\Users\Me"

-->

Utiliser -args comme dernière option sur la ligne de commande est plus sûr.

-display Display

Cette option n'est valide que pour les version basées sur Xwindow, elle peut alors être utilisée pour specifier un server X. La valeur par défaut est unix:0.0

-display peut être remplacé par -d

-e Instructions

À l'issue du démarrage complet de la session, cette option

• fixe le dossier de travail de Scilab au dossier système depuis lequel Scilab a été lancé. Voir l'exemple donné plus bas pour l'option -f. Puis,

• éxécute les Instructions Scilab indiquées. Exemple :

   scilab-cli -e  "disp(\"Hello\"); a=%pi+%i; disp(exp(a)); exit;" -nb 

Les options -e et -f ne peuvent pas être utilisées ensemble.

-f Fichier

Si cette option est indiquée, alors au début de la session Scilab, après l'exécution des fichiers de démarrage de Scilab et de l'utilisateur, et après l'activation des Préférences de l'utilisateur -- dont celles concernant le dossier de travail par défaut --,

• le dossier de travail de Scilab est fixé au dossier système depuis lequel Scilab a été lancé. Par exemple,

  D:\users\me\scilab\dev> C:\scilab-5.5.2\bin\scilex -f ..\test.sce

  exécutera cd("D:\users\me\scilab\dev").

• le script Scilab Fichier est exécuté. S'il est indiqué avec un chemin relatif (.\ par défaut, ou tel que ..\ dans l'exemple ci-dessus), celui-ci se réfère au nouveau dossier de travail de Scilab.

Un fichier avec l'extension .xcos sera ouvert par Xcos.

-quit

Cette option force Scilab à quitter la session après l'exécution des instructions données par l'option -e ou par le script indiqué via l'option -f, y compris en cas d'erreur d'exécution. Cette option doit toujours être utilisée en mode batch. Elle est ignorée lorsque l'option -e ou -f n'est pas utilisée.

-l lang

Cette option permet de sélectionner la langue de l'utilisateur. lang peut avoir les valeurs: ca_ES de_DE en_US es_ES fr_FR ja_JP pt_BR ru_RU zh_CN zh_TW (à partir de Scilab 5.2).

Les valeurs possible pour sont -l fr pour sélectionner le francais et -l en pour sélectionner l'anglais. La langue par défaut est établie à l'anglais dans le fichier scilab.start.

Avec certains systèmes, la compilation des locales peut être nécessaire pour rendre correctement les polices UTF-8.

Scilab peut être aussi appellé de la manière suivante:

 LANG=ja_JP scilab
 # équivalent à
 scilab -l ja_JP

-nb

"no banner" : supprime l'affichage du message de chargement de Scilab.

-ns

"no startup" : supprime l'éxécution du script de démarrage "principal" SCI/etc/scilab.start ainsi que les fichiers de démarrage "utilisateur" SCIHOME/.scilab et SCIHOME/scilab.ini ne sont pas pas exécutés.

Cette option désactive de nombreuses fonctionnalités de Scilab. À utiliser avec expertise et discernement.

-nouserstartup

Si cette option est fournie, les fichiers de démarrage "utilisateur" SCIHOME/.scilab, SCIHOME/scilab.ini ne sont pas exécutés.

-noatomsautoload

supprime le chargement en début de session des modules ATOMS installés.

-nw

si cette option est présente, Scilab est lancé en tant qu'interprêteur de commandes avancé : la console est sans menus, mais les fonctionnalités Java sont disponibles (graphiques, export, xcos, scinotes, navigateur d'aide, module JIMS, etc).

A partir de la version 5.2 de Scilab:

• La distribution de Scilab fournit aussi un binaire dédié faisant la même chose que l'option -nw: scilab-adv-cli (Scilab Advanced Command Line Interpreter).

• Les fonctionnalités de pipe sont accessibles pour tous les systèmes d'exploitations (voir les examples pour plus de détails)

-nwni / -nogui

Cette option supprime le chargement de la Machine Virtuelle Java en mémoire. Elle accélère le démarrage de Scilab et réduit la mémoire consommée. Mais alors...

Scilab est lancé en tant que simple interprêteur de commandes, sans aucune fonctionalité avancée requérant la JVM : les fonctionalités graphiques, les interfaces graphiques dont les navigateurs d'aide, de démos, de modules externes, de variables, l'éditeur Scinotes, le module "Java depuis Scilab"... ne sont pas disponibles dans ce mode.

A partir de la version 5.2 de Scilab:

• Les fonctionnalités de pipe sont accessibles pour tous les systèmes d'exploitations (voir les exemples pour plus de détails)

• La distribution de Scilab fournit aussi un binaire dédié faisant la même chose que l'option -nw: scilab-cli (Scilab Command Line Interpreter).

--texmacs

Cette option est réservée au module externe TeXMacs.

Celui-ci peut être préalablement installé avec atomsInstall('texmacs')

-version

Cette option affiche la version de Scilab.

Options supplémentaires sous Unix/Linux ou Mac OS X

Conseil: utiliser ces options à partir de l'arborescence source de Scilab.

-debug

Lance Scilab sous gdb.

Définir la variable SCILAB_GDB_OPT pour ajouter des options supplémentaire à gdb.

-debug-kdbg

Lance Scilab sous kdbg.

-profiling

Lance Scilab sous valgrind.

Définir la variable SCILAB_VALGRIND_OPT pour ajouter des options supplémentaire à valgrind (et surcharger les options de valgrind existantes).

-profiling-visu

Lance Scilab sous callgrind.

Définir la variable SCILAB_VALGRIND_OPT pour ajouter des options supplémentaires à callgrind (et surcharger les options de callgrind existante).

-electric-fence

Lance Scilab sous Electric Fence.

Variables d'environnement

SCIVERBOSE

Si cette variable d'environnement est présente, le script de démarrage de Scilab affichera les informations de debug. Principalement utilisée pour du debug ou le report de bugs.

JAVA_HOME

Indique quelle version de Java utiliser. Par exemple, JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab démarrera Scilab avec la version 7 de Java.

SCI_DISABLE_TK

Désactive les fonctionnalités Tk (mais pas Tcl)

SCI_JAVA_ENABLE_HEADLESS

Démarre Java en mode Headless (ie sans les fonctionnalités graphiques).

Options JVM (Java Virtual Machine)

Les options décrites ci-dessous sont inutiles et sans effet lorsque l'option -nwni est utilisée.

A partir de la version 5.0 de Scilab, l'interface graphique et le système de génération de la documentation sont basés sur des fonctionnalités Java. Dans certains cas, il peut être intéressant de modifier les options de la JVM (Java Virtual Machine).

Ces options sont accessibles via le fichier jvm_options.xml.

Dans les version 5.0.X et 5.1.X, ce fichier est accessible dans SCI/modules/jvm/etc/jvm_options.xml

Dans les versions >= 5.2.0, le fichier est accessible sous etc/jvm_options.xml

Par défault, les trois options suivantes sont facilement accessibles à partir du fichier de configuration:

-XmxXXXm

Cette option indique la quantité de mémoire mise à disposition de la machine virtuelle Java. Par défaut, la valeur est de 256M. Si vous changez cette valeur, assurez vous que cette valeur ne dépasse pas la quantité de mémoire accessible sur le système.

-Djava.compiler=JIT

Avec la valeur JIT, le compilateur Java Just In Time (JIT) est activé. Il est activé par défault. NONE désactive le JIT et diminue de manière importante les performances.

-verbose:jni / -Xcheck:jni

Ces options activent de nombreuses vérifications, message de débug et autres contrôles sur les appels JNI (appel natif Java). Ces options sont utiles pour le débuggage et désactivée par défaut à cause de l'impact sur les performances.

De nombreuses options sont disponibles. Elles peuvent améliorer les performances, changer le rendu graphique, la gestion de la mémoire... Voir: http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html

Exemples

# Lançons Scilab en mode profilage sans qu'un gdb soit lancé à chaque SIGSEGV.
# On est sous Bash
export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
scilab -profiling

# Lançons Scilab en mode debug sans s'arrêter à chaque SIGSEGV
# D'abord écrivons un petit fichier de commandes
echo "handle SIGSEGV nostop" > debug.txt
# On règle l'option de gdb
# On est sous Bash
export SCILAB_GDB_OPT="--command=debug.txt"
# Lançons Scilab en mode debug
scilab -debug 

# Sous GNU/Linux, Mac OS X or Unix:
$ echo "disp(%pi)"|scilab-cli
ou
$ echo "disp(%pi)"|scilab -nwni

# Ouvre uniquement la fenêtre d'aide Scilab:
$ scilab-adv-cli -e "help()"
or
$ scilab -nw -e "help()"

# Scilab utilisé en tant que moteur de scripting
echo "if 1<>2 then exit(99) end"|scilab-cli
echo $? 

Voir aussi

• startup — startup file
• sciargs — arguments sur la ligne de commande Scilab
• getpid — renvoie le numéro de processus de Scilab
• getenv — renvoie la valeur d'une variable d'environnement
• getversion — get scilab and modules version information
• consolebox — affiche ou cache le terminal Windows de lancement de Scilab
• exit — Termine la session courante de scilab

Historique