Many Thanks to Aurelien Gautier
French Translation: Aurelien Gautier


==========
HOWTO.TXT
==========
- Allez  la rubrique "O puis-je obtenir UniGNUPlot" pour 
obtenir une version PDF de ce document.

-UniGNUPlot- Interface GNUPlot TK/TCL version 2.0.0B -
Document de travail!!!

A propos de cette documentation: ce document a pour 
vocation de rendre le premier contact utilisateur avec 
UniGNUPlot plus simple. Vous tes libre d'y effectuer des 
ajouts ou des corrections mais PAS D'EFFACER des 
paragraphes.

Historique: Quand j'tais tudiant, il y a quelques annes, j'ai 
eut  tracer des fonctions mathmatiques, et j'utilisais 
l'application GNUPlot pour faire des tracs de qualits, et un 
jour quelqu'un m'a dit : "Tes tracs sont vraiment sympas !  
Comment fais-tu ?" ... J'ai rpondu  la question de mon ami 
et je lui ai expliqu comment tracer simplement des 
fonctions avec GNUPlot....

Pour la plupart des personnes, faire un trac avec GNUPlot 
est souvent difficile, les graphes simples ne ncessitent pas 
beaucoup d'effort, mais ds que l'on veut utiliser les 
tiquettes, les intervalles, etc... cela devient fastidieux si l'on 
ne sait pas comment procder. 

Pourquoi ? ... Parce que le pilotage de GNUPlot par ligne 
de commande est simple  comprendre, mais les lignes 
sont parfois trs longues si l'on veut peaufiner son graphe, et 
il est difficile de mmoriser toutes les commandes et autres 
paramtres. Si tout ce travail pouvait tre fait en seulement 
quelque clics pour que GNUPlot face tout le travail, a serait 
plus simple ...

Comment faire ? Tous les boutons proposs par 
UniGNUPlot sont associs  une ligne de commande 
GNUPlot, les donnes entres par l'utilisateur sont alors 
places dans des variables et quand vous pressez la touche 
ENTREE dans la bote de dialogue de saisie d'expression, 
tout est envoy  GNUPlot en utilisant les options par dfaut 
si l'utilisateur ne les a pas modifies. Un graphe est alors 
trac dans la fentre d'UniGNUPlot.

Quelle est la diffrence entre GNUPlot et UniGNUPlot ? 
GNUPlot est le moteur qui servira  gnrer les graphes et 
UniGNUPlot est l'outil qui permet d'exploiter de manire 
conviviale ce programme, pour vous rendre la vie plus facile.

Prrequis :

* Un ordinateur avec Linux (test sur une DEBIAN 3.0 rc0 
Kernel 2.4.19). Wish 8.0 et plus. GNUPlot Xwindows (test 
avec une version 4.1.0). Une imprimante qui fonctionne 
(facultative) si vous voulez imprimer votre travail.

* Utilisation : avant de lancer UniGNUPlot vous devez  
l'installer. 

* Installation de l'application : 

* 1)Rcuprer les fichiers dinstallation : 
  http://unicalculus.sourceforge.net 

* 2)gunzip unignuplot-X.X.X.tar.gz (X = numro de contrle 
de version)

* 3)tar -xvf unignuplot-X.X.X.tar

* -Ouvrez un XTERM ou ce que vous voulez pour disposer 
d'un affichage dans XWindows

* Vous devez maintenant avoir le dossier suivant: unignuplot/ 

* Placez-vous  la racine de ce dossier: $ cd unignuplot 

* Lancez le programme: ./unignuplot-2.0.0B.tcl 

* Vous devez maintenant voir l'cran suivant:


<Graphic file:instantnea0.jpg>


Organisation de l'cran et utilisation de l'interface.

Vous pouvez ds maintenant utiliser le programme:

* Allez dans la zone de saisie d'expression et entrez la 
fonction  tracer : 


<Graphic file:instantnea1.jpg>


Comme vous pouvez le voir j'ai utilis la fonction sin(x) et j'ai 
ensuite press la touche ENTREE pour obtenir le rsultat 
affich ci-dessus.

La plupart du temps, il est ncessaire de tracer plusieurs 
fonctions simultanment. Pour cela, il faut sparer les 
fonctions par des virgules :


<Graphic file:multiplot.jpg>


Pour raliser l'exemple ci-dessus, j'ai entr l'expression sin
(x), cos(x/4), tan(x) et j'ai ensuite press la touche ENTREE.

A propos des intervalles: ils sont utiles pour slectionner des 
parties du graphe qui viennent d'tre traces. Par exemple 
si l'on veut seulement afficher une rgion bien prcise du 
trac obtenu dans l'exemple ci-dessus, il est possible de 
renseigner les coordonnes souhaites dans les zones de 
saisies d'intervalles,  droite de l'cran. NOTE: faites 
attention  ne pas demander un intervalle qui soit en dehors 
du trac affich  l'cran (dans cet exemple de -10  10 sur 
l'axe des X, -30  30 pour l'axe des Y qui utilise des 
intervalles dfinis automatiquement par le programme) car 
dans ce cas le rsultat affich sera la plupart du temps un 
cran vierge.


<Graphic file:ranges.jpg>


Ici, j'ai utilis l'intervalle x(0,5) et laiss l'intervalle 
automatique pour l'axe des Y. Pour utiliser le mode intervalle 
automatique, il faut utiliser le caractre * (astrisque). Une 
fois les diffrents intervalles renseigns, il faut utiliser le 
bouton Appliquer dans la partie Intervalles de l'interface.

Vous avez maintenant obtenu un joli trac en 2D (deux 
dimensions). Si vous voulez effectuer le trac en 3D (trois 
dimensions), il faut utiliser le bouton "Type de trac" de 
l'interface et choisir l'option 3D.


<Graphic file:plottype.jpg>


Pour obtenir le trac en trois dimensions, il vous suffit alors 
d'aller dans la zone de saisie d'expression et de presser la 
touche ENTREE.


<Graphic file:3Dplot.jpg>


Les intervalles sont utiliss aussi dans ce type de trac.

Si vous voulez trac une fonction polaire, il faut procder de 
la mme faon que pour effectuer un trac en 3D: le 
bouton "Type de trac" permet de slectionner 
l'option "Polaire". Dsormais, ce n'est plus "x" qui est utilis, 
mais "t", et le trac sera automatiquement effectu en 2D 
(deux dimensions).
 

<Graphic file:polar.jpg>


Pour changer le type de ligne utilis pour le trac, vous 
devez utiliser le bouton "Type de ligne" de l'interface et 
slectionner celui qui vous intresse.


<Graphic file:linetype.jpg>


Pour moi, le mode de trac ligne est le plus intressant, 
mais suivant le trac  effectuer il peut tre plus confortable 
de choisir un autre mode daffichage du trac.

Si vous voulez obtenir un trac lisse trs utile quand le 
programme est utilis en mode donnes (suite de 
coordonnes  tracer) et non en mode expression il faut 
utiliser le bouton  Lissage  et slectionner loption 
daffichage qui vous intresse.


<Graphic file:smooth.jpg>


Exemple : Jai utilis un fichier nomm  dummi.gnup  avec 
une srie de coordonnes  tracer.


<Graphic file:sinsmooth.jpg>


Le trac correspond bien aux coordonnes du fichier, mais 
pour lisser le trac obtenu, jai slectionn  csplines  
grce au bouton  Lisser  et obtenu le trac ci-dessous : 


<Graphic file:csplines.jpg>


En utilisant le bouton  Lisser  et en slectionnant loption  
sbezier  (courbe de bzier) voici le rsultat :

<Graphic file:bezier.jpg>


Vous pouvez maintenant essayer deffectuer vos propres 
tracs, car vous connaissez dsormais toutes les options 
utiles pour commencer  travailler : trac  partir 
dexpression,  partir dun fichier et manipulation des 
options daffichage.

Passons maintenant  la cration dtiquette  lintrieur du 
trac. Il existe deux types dtiquettes :


1. Etiquetage dlments prdfinis 

2. Etiquetage libre

Il existe quatre types dlment prdfinis  tiqueter :

* Titre

* Axe des X

* Axe des Y

* Axe des Z

Les voici :


<Graphic file:labels.jpg>


Ces tiquettes apparatront dans des emplacements 
prdfinis du trac.


<Graphic file:labels1.jpg>


Pressez le bouton  Appliquer , et les tiquettes seront 
alors mises  jour dans lcran daffichage des tracs. Pour 
fermer la fentre de saisie des tiquettes, pressez le 
bouton  Fermer . Le bouton  Rinitialiser les valeurs  
permet de saisir de nouvelles valeurs.


<Graphic file:with_main_labels.jpg>


Pour utiliser les tiquettes libres, il suffit de double-cliquer 
sur lcran daffichage des tracs et dentrer le libell 
souhait dans la zone de saisie qui doit apparatre.


<Graphic file:labeling.jpg>


Pressez ensuite la touche entre. Ltiquette est alors cre 
et apparat automatiquement  lcran.


<Graphic file:labeling2.jpg>


Vous pouvez placer beaucoup de commentaires sur vos 
tracs, mais faites attention car si vous changez les 
intervalles de travail, le texte restera  la mme place sur le 
trac.


<Graphic file:labeling3.jpg>


Pour effacer toutes les tiquettes libres, il faut cliquer droit  
lintrieur de lcran daffichage des tracs et toutes les 
tiquettes libres disparatront (pas les tiquettes 
prdfinies).
