<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "kst">
 <!ENTITY package "kdeextragear-2">
 <!ENTITY kst "<application
>KST</application
>">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % French "INCLUDE"
> <!-- change language only here -->
 ]>

<book lang="&language;">
<bookinfo>
<title
>Le Guide de &kst;</title>
<authorgroup>
<author
><firstname
>Barth</firstname
> <surname
>Netterfield</surname
> <affiliation
> <address
><email
>kst@omega.astro.utoronto.ca</email
></address>
</affiliation>
</author>
&traducteurSimonDepiets; 
</authorgroup>

<date
>2002-07-27</date>
<releaseinfo
>0.72</releaseinfo>

<abstract>
<para
>Kst est un programme de visionnage de courbes et de données, avec des arguments en ligne de commande simples, un zoom de la souris et du clavier puissant et enfin un enregistreur graphique en temps réel. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kst</keyword>

</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introduction</title>

<sect1 id="features">
<title
>Fonctionnalités</title>

<para
>La documentation de kst n'était pas complète au moment de l'installation de cette application. Si vous voulez en écrire, faites-le savoir à cbn. Si vous connaissez cbn, vous pouvez l'aider à en écrire. Sinon, soyez patient.... </para>

</sect1>
</chapter>

<chapter id="command-line">
<title
>Usage de la Ligne de Commande et Exemples</title>


<para
>Une utilisation typique de kst est de faire des courbes X Y de fichiers de données depuis la ligne de commande. Kst peut lire les données ASCII ou les fichiers binaires compatibles readdata. Les options sont : </para>

<sect1 id="command-line-synopsis">
<title
>Syntaxe de la ligne de commande</title>

<synopsis
>kst [Options-Qt] [Options-KDE] [options] [Fichiers]
</synopsis>

<para
><option
>[Fichiers]</option
> Un fichier .kst, un ou plusieurs fichiers données. Les formats supportés sont les caractères de la table ASCII, les fichiers BOOMERANG ou BLAST. Les options pouvant être mises en place via les paramètres sont stockées dans les fichiers .kst. Les paramètres suivants peuvent être utilisés pour remplacer les options des fichiers .kst : <option
>-F fichier_de_données</option
>, <option
>-n NS</option
>, <option
>-s NS</option
>, <option
>-f F0</option
>, <option
>-a</option
>. Le reste ne peut être remplacé. Si un paramètre remplacé est donné, il est appliqué à tous les vecteurs de la courbe. </para>
<para
>Les données ASCII venant de stdin peuvent être mises en courbe en incluant « stdin » dans la liste des <option
>Fichiers</option
>. </para>

<para
><option
>-y Y</option
> La source pour les données de l'axe Y. Pour les fichiers ASCII, c'est la colonne. Pour les fichiers binaires, c'est le nom du champ. Pour dessiner plusieurs courbes, il peut être spécifié plusieurs fois. Le même fichier source, le pas, et les données de l'axe X sont gérées. </para>

<para
><option
>-e E</option
> Barres d'erreurs pour les données de l'axe Y. Pour les fichiers ASCII, cela réfère à la colonne contenant les données. Pour les fichiers binaires, utilisez le nom du champ. Si plusieurs options <option
>-y Y</option
> sont données, il devrait aussi être utilisé plusieurs fois. Les entrées Y individuelles sont associées en ordre avec plusieurs entrées E. </para>

<para
><option
>-x X</option
> La source pour les données de l'axe X. Pour les fichiers ASCII, c'est la colonne. Pour les fichiers readdata, c'est le nom du champ. Si cette option n'est pas spécifiée, le numéro de ligne du fichier est utilisée. Cette option ne peut être donnée qu'une seule fois. </para>

<para
><option
>-p P</option
> La source pour le spectre de puissance. Pour les fichiers ASCII, c'est la colonne. Pour les fichiers binaires, c'est le nom du champ. Pour dessiner un spectre de puissance constitué de plusieurs courbes, cela peut être spécifié plusieurs fois. Le même fichier source, les pas et longueurs FFT sont utilisées pour tous les spectres de puissance appelés depuis la ligne de commande. </para>

<para
><option
>-l P</option
> La longueur du FFT utilisé dans une estimation de spectre de puissance est de 2^P. </para>

<para
><option
>-h H</option
> La source pour les histogrammes. Pour les fichiers ASCII, c'est la colonne. Pour les fichiers binaires, c'est le nom du champ. Plusieurs histogrammes peuvent être définis depuis la ligne de commande. </para>

<para
><option
>-m NC</option
> Utilisé quand plusieurs courbes ont été définies. Au lieu de mettre toutes les courbes sur le même graphique, crée un graphique par courbe. </para>

<para
><option
>-f F0</option
> Le premier numéro de cadre (pour les fichiers readdata) ou de rangée (pour les fichiers ASCII) à lire. </para>

<para
><option
>-n</option
> Le nombre de cadres (pour les fichiers readdata) ou de rangées (pour les fichiers ASCII) à lire. </para>

<para
><option
>-s NS</option
> Le nombre de cadres ou de rangées à sauter à chaque lecture. Cela est utile lorsque vous travailler avec des fichiers de données très lourds, pour accélérer la procédure et conserver de la mémoire, si les données varient très peu. </para>

<para
><option
>-a</option
> Utilisée avec le <option
>-s NS</option
> : mieux que sauter tous les NS cadres, faites en une moyenne. Cela propose une combinaison de filtres très basiques et une conservation de la mémoire. </para>
<para
><option
>-F Fichier_de_données</option
> Surpasser le fichier d'où les données seront lues pour tous les vecteurs listés dans le fichier .kst. Ne peut être utilisée qu'en conjonction avec un fichier kst. </para>

<para
><option
>--print fichierps</option
> Au lieu d'afficher le graphique, exportez l'image à un fichier PostScript et quittez. *Note de BUG : souvent quand aucune fenêtre n'est ouverte à l'écran, un accès au serveur X est encore nécessaire.* </para>

<para
><option
>--png fichierpng</option
> Au lieu d'afficher le graphique, exportez l'image vers un fichier png de dimensions 640x480 et quittez. *Note de BUG : souvent quand aucune fenêtre n'est ouverte, l'accès au serveur X est encore nécessaire.* </para>

</sect1>

<sect1>
<title
>Exemples en ligne de commande</title>

<para
>Beaucoup d'exemples d'utilisation typique suivent : </para>

<para
>Pour mettre en courbe la première colonne d'un fichier (tmp.dat) de données ASCII : </para>

<synopsis
>omega% kst -y 1 tmp.dat
</synopsis>

<para
>Pour mettre en courbe les colonnes 2, 3 et 4 en fonction de la colonne 1 d'un fichier ASCII, en une courbe : </para>

<synopsis
>omega% kst -x 1 -y 2 -y 3 -y 4 tmp.dat
</synopsis>

<para
>Pour mettre en courbe les colonnes 2, 3 et 4 en fonction de la colonne 1 d'un fichier ASCII, en trois courbes, arrangées en une colonne : </para>

<synopsis
>omega% kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat
</synopsis>

<para
>Pour mettre en courbe 500 rangées de la colonne 2 d'un fichier ASCII, en commençant à la ligne 100 : </para>

<synopsis
>omega% kst -y 2 -f 100 -n 500 tmp.dat
</synopsis>

<para
>Pour mettre en courbe les 100 000 rangées de la colonne 2 d'un fichier ASCII, en faisant les moyennes par groupe de 100 rangées : </para>

<synopsis
>omega% kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat
</synopsis>

</sect1>

</chapter>

<chapter id="questions-answers-and-tips">
<title
>Questions, Réponses et Astuces</title>

<sect1 id="question-1">
<title
>Question 1</title>

<para
>La réponse</para>

</sect1>

</chapter>

<appendix id="installation">
<title
>Installation</title>

<para
>Pas encore écrit </para>

<sect1 id="how-to-obtain-pab">
<title
>Comment obtenir kst</title>

<para
>Pas encore écrit </para>

</sect1>

<sect1 id="requirements">
<title
>Configuration minimale</title>

<para
>Pas encore écrit </para>

</sect1>

<sect1 id="compilation-and-installation">
<title
>Compilation et Installation</title>

<para
>Compiler kst est très simple. Vous devriez faire ce qui suit : <screen
>&percnt; ./configure
&percnt; make
&percnt; make install
</screen>
</para>

<para
>Cela devrait marcher ! Si vous rencontriez des problèmes, veuillez les rapporter à l'auteur sur <email
>cbn@omega.astro.utoronto.ca</email
></para>
&underFDL; </sect1>
</appendix>

</book>

