<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
<!ENTITY package "others">
<!ENTITY % addindex "IGNORE">
<!ENTITY % French "INCLUDE" > <!-- change language only here -->
]>
<book lang="&language;">
<title>Le manuel de Ksetiwatch</title>
<bookinfo>
<authorgroup>
<author>
<firstname>Gordon</firstname><surname>Machel</surname>
<affiliation>
<address><email>gmachel@users.sourceforge.net</email></address>
</affiliation>
</author>
</authorgroup>
<copyright>
<year>2000-2003</year>
<year>2004</year>
<holder>Gordon Machel</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>01/25/2002</date>
<releaseinfo>2.2.5</releaseinfo>
<abstract>
<para>
Ksetiwatch est un outil d'information (ndt: monitor tool) pour le projet de calcul distribué
<ulink url="http://setiathome.ssl.berkeley.edu">Seti@home</ulink>, dont le but est la
recherche de signaux provenant de formes de vies extraterrestres.
Il affiche l'état de client(s) Seti@home en cours d'exécution sur votre ordinateur ou sur
votre réseau local, et archive/gère les unités de travail complétées. De plus, Ksetiwatch
dispose d'une carte du ciel affichant toutes les unités de travail calculées, d'un affichage
graphique des données scientifiques (gaussiennes, pulses, et triplets), une icône incorporée
au panneau avec des informations de statut détaillées concernant le client, la possibilité de
démarrer/arrêter les clients SETI@home, et beaucoup plus.
</para>
</abstract>
<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
of your application, and a few relevant keywords. -->
<keywordset>
<keyword>KDE</keyword>
<keyword>Ksetiwatch</keyword>
<keyword>Applications</keyword>
<keyword>seti@home</keyword>
<keyword>seti</keyword>
<keyword>monitoring</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Introduction</title>
<para>
Ksetiwatch est un outil d'information (ndt: monitor tool) pour le projet de calcul distribué
<ulink url="http://setiathome.ssl.berkeley.edu">Seti@home</ulink>, dont le but est la
recherche de signaux provenant de formes de vies extraterrestres. Il comble (ndt: circumvents??)
toutes les fonctionnalités des clients SETI@home en mode texte: le manque d'information à
propos de l'état du(des) client(s), la progression de l'analyse de données, les unités de travail
en cours, et les unités de travail terminées.
</para>
<para>
Ksetiwatch possède le même look-and-feel que le programme populaire
<ulink url="http://members.shaw.ca/mloukko/SETI.html">SETIWatch</ulink>,
écrit pour les plateformes Windows95/98/NT par
<ulink url="mailto:mloukko@shaw.ca">Mark Loukko</ulink>.
Il partage beaucoup des fonctionnalités offertes par SETIWatch, et fourni certaines
autres. Les points importants sont:
<itemizedlist>
<listitem><para>contrôle d'autant de clients que vous voulez,</para></listitem>
<listitem><para>incorporation dans le panneau KDE,</para></listitem>
<listitem><para>vous prévient lors de la découverte de nouveaux signaux,</para></listitem>
<listitem><para>enregistrement automatique des résultats des unités de travail complétées,</para></listitem>
<listitem><para>enregistrement automatique de tous les signaux intéressant renvoyés au serveur SETI@home,
cela inclus leur profil pour une représentation graphique,</para></listitem>
<listitem><para>affiche la liste des unités de travail complétées et des signaux intéressants,</para></listitem>
<listitem><para>entièrement compatible avec les fichiers d'archives de SETIWatch/SETILog,</para></listitem>
<listitem><para>affiche les unités de travail en cours de calcul ainsi que les UT archivées sur une carte du
ciel,</para></listitem>
<listitem><para>démarre et arrête les clients SETI@home; les clients peuvent être exécutés avec des
options configurables,</para></listitem>
<listitem><para>offre l'affichage d'un statut détaillé (en cours, arrêté, fini, chargement),</para></listitem>
<listitem><para>affiche les graphiques de gaussiennes, pulses et triplets.</para></listitem>
</itemizedlist>
</para>
</chapter>
<chapter id="getting-started">
<title>Guide de démarrage</title>
<para>
Cette section est prévue pour les nouveaux utilisateurs. Si vous n'avez jamais
utilisé le client SETI@home avant vous devriez lire ce qui suit.
</para>
<para>
Si c'est la première fois que vous essayez d'utiliser le client SETI@home
n'essayer pas via Ksetiwatch! Car vous allez devoir créer un nouveau compte utilisateur,
et cela ne peut être fait que de manière interractive.
</para>
<note><para>
Notez que cela ne doit être fait qu'une fois. après une installation correcte du
programme, le client peut facilement être contrôlé via Ksetiwatch.
</para></note>
<para>
Ce chapitre va vous guider dans l'installation du client SETI@home dans votre
répertoire personnel (ndt: home directory), et la configuration de Ksetiwatch pour contrôler
le client nouvellement installé. Nous assumerons que vous avez téléchargé l'archive avec le
programme client (par exemple
<filename>setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1.tar</filename>), et qu'elle est
stockée dans votre répertoire personnel.
</para>
<para>
Donc, ouvrez un terminal, et assurez-vous d'être dans votre répertoire personnel.
<screen width="40">
<prompt> %</prompt> <userinput>pwd</userinput>
/home/gordon
<prompt>%</prompt>
</screen>
</para>
<para>
Si ce n'est pas le cas, placez-vous vers votre répertoire personnel avec
<command>cd ~</command>, ou <command>cd $HOME</command>. Maintenant, décompactez
l'archive.
<screen width="40">
<prompt> %</prompt> <userinput>tar xvf setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1.tar</userinput>
setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1/README
setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1/README.xsetiathome
setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1/setiathome
setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1/xsetiathome
<prompt>%</prompt>
</screen>
</para>
<para>
Cette commande a créé un nouveau répertoire
<filename>setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1</filename>
dans votre répertoire personnel et copié tous les fichiers à cet endroit. Si vous le désirez,
vous pouvez renommer ce long nom répertoire à l'aide de la commande
<command>mv setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1 setiathome</command>.
</para>
<para>
Il est maintenant temps de se placer dans ce nouvel emplacement SETI@home et de démarrer
le client SETI@home. Notez le petit <command>./</command> au début de la commande
de démarrage. Il signifie que le fichier exécutable <filename>setiathome</filename> dans
le répertoire courant doit être exécuté (par défaut, le répertoire courant n'est pas dans les
chemins de recherche par défaut sous Unix/Linux).
<screen width="40">
<prompt> %</prompt> <userinput>cd setiathome</userinput>
<prompt>%</prompt>
<prompt>%</prompt> <userinput>./setiathome</userinput>
SETI@home client.
Platform: i386-pc-linux-gnu-gnulibc2.1
Version: 3.03
SETI@home is sponsored by individual donors around the world.
If you'd like to contribute to the project,
please visit the SETI@home web site at
http://setiathome.ssl.berkeley.edu.
The project is also sponsored by the Planetary Society,
the University of California, Sun Microsystems, Paramount Pictures,
Fujifilm Computer Products, Informix, Engineering Design Team Inc,
The Santa Cruz Operation (SCO), Intel, Quantum Corporation,
and the SETI Institute.
SETI@home was developed by David Gedye (Founder),
David Anderson (Director), Dan Werthimer (Chief Scientist),
Leonard Chung, Hiram Clawson, Jeff Cobb, Charles Congdon, Charlie Fenton,
Kyle Granger, Eric Heien, Mike Hill, Michael Kang, Eric Korpela,
Matt Lebofsky, Peter Leiser, Brad Silen, Woody Sullivan, and Adam Wight.
Welcome to SETI@home.
We use your email address to identify you.
Please type:
1 to set up a new account (first-time users);
2 to log into an existing account (returning users).
Your choice (1 or 2):
</screen>
</para>
<para>
Maintenant suivez simplement les instructions fournies par le client. Vous devez être connecté
à l'internet pour que le client puisse télécharger la première unité de travail. Après avoir
téléchargé l'UT, le client devrait immédiatement commencer à analyser les données
(vous ne pourrez pas vous en rendre compte, car le client n'affiche aucune information de statu).
</para>
<para>
Vous pouvez maintenant démarrer Ksetiwatch s'il n'était pas déjà en cours de fonctionnement.
Clickez sur le gros K dans le panneau pour obtenir le menu K, déplacez-vous sur application, et
sélectionnez Ksetiwatch. La fenêtre suivante vous sera présentée:
</para>
<screenshot>
<screeninfo>Une capture d'écran de Ksetiwatch après le premier démarrage.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="start-window.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Démarrage de Ksetiwatch.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Pour ajouter votre client à la liste des emplacements SETI@home faites un click droit sur
la liste (vide) (le grand emplacement blanc) dans l'onglet<guibutton>Analyse</guibutton>.
Vous obtiendrez un menu déroulant, choisissez <guimenuitem>Add...</guimenuitem>.
Une boîte de dialogue apparaîtra, où vous devrez remplir les champs requis.
</para>
<screenshot>
<screeninfo>Une capture d'écran de la boîte de dialogue d'ajout ou de modification d'un
emplacement SETI@home.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="addedit-location.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>dialogue d'ajout/modification.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Entrez un nom décrivant votre emplacement SETI@home dans le champ
<guibutton>Description:</guibutton>, entrez le répertoire ou se trouve le client
SETI@home (vous pouvez également utiliser le bouton à ,droite du champ de texte
pour parcourir l'arborescence de répertoires), et choisissez une couleur. C'est tout, vous voilà prêt.
après avoir clické sur <guibutton>OK</guibutton>, Ksetiwatch devrait contrôler votre
emplacement SETI@home.
</para>
<note><para>
Une explication détaillée de toutes les options des autres boîtes de dialogue peut être trouvée
à <xref linkend="addeditbox"/>. Par exemple, vous pouvez dire à Ksetiwatch de démarrer
le client SETI@home lorsque Ksetiwatch démarre. Ce faisant, il ne sera plus nécessaire
de démarrer manuellement le client SETI@home dans un terminal lors de sessions futures
</para></note>
</chapter>
<chapter id="using-ksetiwatch">
<title>Utiliser Ksetiwatch</title>
<para>
La fenêtre Ksetiwatch consiste simplement en une série d'onglets où l'information
concernant les emplacements SETI@home en cours d'exécution est triée de façon
plus ou moins logique. Ksetiwatch étant capable de contrôler autant de clientsSETI@home
que vous le désirez, toute l'information est organisée en listes mises à jour à intervalle
régulier. Les entrées des listes peuvent facilement être triées en ordre croissant ou
décroissant en cliquant sur l'en-tête de colonne correspondant.
</para>
<para>
Par défaut Ksetiwatch archive automatiquement les unités de travail complétées. Bien sur,
pour que l'archivage soit réussi Ksetiwatch doit fonctionner en arrière-plan lorsque le
client SETI@home a terminé son unité de travail.
</para>
<note><para>
Si vous avez mis à jour le client SETI@home à une version 3.x, Ksetiwatch
modifie automatiquement le fichier d'archivage (<filename>SETILog.csv</filename>)
de manière à ce que les nouvelles données concernant les pulses et les triplets puissent
être également archivées. L'ancien fichier d'archive sera stocké dans
<filename>SETILog.old</filename>. Veuillez noter que cette fonctionnalité n'a
pas été testée avec des répertoires réseaux, donc si le fichier d'archives vous est important,
pensez à faire un backup.
</para></note>
<para>
Ksetiwatch utilise le gestionnaire de session de KDE. Cela signifie qu'il n'est pas nécessaire
de fermer le programme lorsque vous quittez KDE, ou de le redémarrer lors de votre
prochaine session KDE. De plus, Ksetiwatch pourra également démarrer le(s) client(s)
SETI@home à votre place au démarrage.
</para>
<para>
Nous allons maintenant décrire en détail le contenu des onglets ainsi que les options.
</para>
<sect1 id="analysis-tab">
<title>L'onglet Analyse</title>
<para> </para>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet Analyse.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="analysis.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>L'onglet Analyse.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Cet onglet affiche l'état actuel de vos clients SETI@home. Il affiche la progression
de l'analyse des données, l'efficience du processus, et les meilleurs résultats de
l'unité de travail actuelle. En détail:
</para>
<formalpara>
<title>Emplacement</title>
<para>
Le nom que vous avez choisi pour le client SETI@home.
</para>
</formalpara>
<formalpara>
<title>Statu</title>
<para>
Le statu du client SETI@home. Peut être dans l'un des états
suivants: en cours (icône bleue), Arrêté (sigle stop rouge), terminé
(marque cochée verte), ou en chargement (éclair jaune).
</para>
</formalpara>
<formalpara>
<title>Décalage</title>
<para>
Le décalage (ndt:chirp rate) auquel le client est en train de calculer.
</para>
</formalpara>
<formalpara>
<title>% Effectué</title>
<para>
Cette entrée affiche la progression en pourcents du client SETI@home.
</para>
</formalpara>
<formalpara>
<title>Temps CPU</title>
<para>
Le temps que le client a passé à analyser l'unité de travail actuelle.
</para>
</formalpara>
<formalpara>
<title>Temps restant</title>
<para>
Une estimation du temps de calcul restant pour terminer l'unité de travail.
</para>
</formalpara>
<formalpara>
<title>%/heures CPU</title>
<para>
Ceci vous donne une idée du taux de progression du client en une heure
de temps CPU.
</para>
</formalpara>
<formalpara>
<title>MFlops</title>
<para>
Si l'on s'en réfère au site web SETI@home chaque unité de travail
nécessite entre 3.2*10^12 et 4.2*10^12 opération à virgules flottantes (Flops)
(la valeur exacte dépendant de l'ouverture angulaire). Cette entrée affiche
combien de Flops votre ordinateur effectue par secondes.
</para>
</formalpara>
<formalpara>
<title>Pique</title>
<para>
Le pic le plus haut trouvé jusqu'ici.
</para>
</formalpara>
<formalpara>
<title>Gaussienne la plus intense</title>
<para>
La gaussienne la plus intense, d'après son score, trouvée jusqu'ici.
Le score est déterminé par (puissance/fit).
</para>
</formalpara>
<formalpara>
<title>Pulse le plus intense</title>
<para>
le pulse le plus intense, d'après son score, trouvé jusqu'ici.
</para>
</formalpara>
<formalpara>
<title>Triplet le plus intense</title>
<para>
Le triplet le plus intense, d'après son score, trouvé jusqu'ici.
Il est à noter que le score et la puissance son identique pour les triplets,
l'affichage de la puissance est donc inutile.
</para>
</formalpara>
<para>
L'onglet Analyse est également l'endroit ou peut être gérée la liste des clients
SETI@home que vous désirez contrôler. Pour ce faire, utilisez le menu déroulant
qui apparaît lorsque vous cliquez sur le bouton droit de votre souris au-dessus
de la liste des emplacements SETI@home. Ce menu déroulant contient les
options suivantes
</para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenuitem>Ajouter...</guimenuitem>
</menuchoice></term>
<listitem><para>
Ajoute un nouvel emplacement SETI@home à la liste. Il vous sera présenté
une boîte de dialogue vous permettant de fournir toutes les informations
nécessaires à Ksetiwatch pour contrôler le client. Voyez
<link linkend="addeditbox">ici</link> pour plus de détails.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Modifier...</guimenuitem>
</menuchoice></term>
<listitem><para>
Faire un click droit sur une entrée existante et choisir cette fonction
vous permet de modifier la configuration de l'emplacement SETI@home
sélectionné. comme précédemment, une boîte de dialogue apparaîtra.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Supprimer</guimenuitem>
</menuchoice></term>
<listitem><para>
Supprime de la liste l'emplacement SETI@home sélectionné. Bien entendu,
tous les fichiers SETI@home ainsi que la liste des unités de travail archivées
seront conservé.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Démarrer le client</guimenuitem>
</menuchoice></term>
<listitem><para>
Essayer de démarrer le client SETI@home. Vous devez posséder
les droits nécessaires à l'exécution du client dans l'emplacement SETI@home
correspondant. Cette fonction ne fonctionnera vraisemblablement pas pour
des clients sur des emplacements partagés en réseau (Samba ou NFS).
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Arrêter le client</guimenuitem>
</menuchoice></term>
<listitem><para>
Essaye d'arrêter le client SETI@home. Les remarques précédentes sont également
d'application ici.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Afficher...</guimenuitem>
</menuchoice></term>
<listitem><para>
Si des signaux importants (Gaussienne, pulse, ou triplet) ont été trouvé, vous pouvez
les afficher dans une fenêtre séparée. Voyez
<link linkend="signal-windows">ici</link> pour plus de détails. Cette fonction
ne fonctionne que pour des clients SETI@home de version 2.0 ou supérieure.
</para><para> </para></listitem>
</varlistentry>
</variablelist>
<para>
Quelques éléments de contrôle supplémentaires peuvent être trouvés au bas de cet onglet.
</para>
<variablelist>
<varlistentry>
<term><guilabel>
<inlinemediaobject><imageobject>
<imagedata fileref="startall-button.png" format="PNG"/>
</imageobject></inlinemediaobject>
</guilabel></term>
<listitem><para>
Cliquer sur ce bouton démarrera une tentative d'exécution de tous les clients
SETI@home. Seuls les clients pour lesquels vous avez les droits d'exécution
seront démarrés.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
<inlinemediaobject><imageobject>
<imagedata fileref="refresh-button.png" format="PNG"/>
</imageobject></inlinemediaobject>
</guilabel></term>
<listitem><para>
Si vous voulez mettre à jour les entrées de la liste vous pouvez cliquer sur
ce bouton. Remarquez que cliquer sur ce bouton peut ne pas avoir d'effet,
étant donné que les versions récentes du client SETI@home ne mettent à
jour leurs fichiers qu'une fois par minutes.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
<inlinemediaobject><imageobject>
<imagedata fileref="stopall-button.png" format="PNG"/>
</imageobject></inlinemediaobject>
</guilabel></term>
<listitem><para>
Essayer d'arrêter tous les clients de la liste. Seuls les clients pour lesquels vous
avez les droits d'exécution seront arrêtés.
</para><para> </para></listitem>
</varlistentry>
</variablelist>
<para>
En plus de cela, il y a une liste déroulante qui vous permet de décider quels clients
doivent être affichés dans la liste. Vous pouvez, par exemple, n'afficher que les clients
en cours d'exécution, ou les clients qui ont terminé une unité de travail. Ceci est
particulièrement utile pour les personnes qui contrôlent une longue liste de clients SETI@home.
Enfin, deux boutons permettent d'accéder à cette aide et à la page web de Ksetiwatch.
</para>
<para>
Si vous avez activé l'option "minimiser dans le panneau"
(voir <xref linkend="options"/>),
la petite icône dans le panneau de KDE peut vous informer du l'état et de la progression
du client SETI@home sélectionné. Choisissez simplement l'emplacement que vous voulez
garder en vue en cliquant dessus. Vous pouvez même afficher deux emplacements différents
dans le panneau de KDE en démarrant une deuxième instance de Ksetiwatch!
</para>
</sect1>
<sect1 id="datainfo-tab">
<title>L'onglet Infos données</title>
<para> </para>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet Infos données.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="datainfo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet Infos données.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
L'onglet Infos données contient toutes les informations importantes concernant les unités de
travail en cours de traitement. Cela inclus:
</para>
<formalpara>
<title>Origine</title>
<para>
La position dans le ciel à laquelle cette unité de travail a été enregistrée. Vous pouvez
obtenir une représentation graphique en cliquant sur le bouton <guibutton>Skymap</guibutton>
en bas à gauche. Vous pourrez trouver plus de détails concernant la carte du ciel
à <xref linkend="skymap"/>.
</para>
</formalpara>
<formalpara>
<title>Enregistré le</title>
<para>
La date et l'heure à laquelle cette unité de travail a été enregistrée.
Le temps est donné en GMT.
</para>
</formalpara>
<formalpara>
<title>Source</title>
<para>
Le radio télescope ayant enregistré cette unité de travail.
</para>
</formalpara>
<formalpara>
<title>Fréquence de base</title>
<para>
La fréquence de base de l'unité de travail. Les données brutes utilisées par SETI@home
couvre une bande de 2.5 MHz. Pour séparer celle-ci en morceaux plus utilisables, elle
est séparée en 256 sous bandes. Chacune de ces sous bandes a une fréquence minimum
appelée fréquence de base.
</para>
</formalpara>
<formalpara>
<title>Ouverture angulaire</title>
<para>
suivant la vitesse du télescope, chaque unité de travail a une ouverture
angulaire de couverture du ciel unique. Le client détermine, sur base de
cette valeur, quelle quantité de travail sera nécessaire pour cette unité
de travail.
</para>
</formalpara>
<formalpara>
<title>TeraFlops</title>
<para>
Le nombre d'opérations en virgule flottante (ndt: flops) nécessaires à achever
cette unité de travail (donné en TeraFlops = 10^12 Flops). Le calcul de cette
valeur est basé sur les recherches faîtes par Roelof Engelbrecht et Lawrence Kirby.
</para>
</formalpara>
</sect1>
<sect1 id="userinfo-tab">
<title>L'onglet Info utilisateur</title>
<para>
L'onglet Info utilisateur fourni des détails concernant les utilisateurs qui exécutent les
emplacements SETI@home spécifiques:
</para>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet Info utilisateur.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="userinfo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet Info utilisateur.</phrase>
</textobject>
</mediaobject>
</screenshot>
<formalpara>
<title>Nom</title>
<para>
Le nom sous lequel l'utilisateur s'est enregistré sur SETI@home.
</para>
</formalpara>
<formalpara>
<title>UT complétées</title>
<para>
Le nombre d'unités de travail que l'utilisateur a terminées.
</para>
</formalpara>
<formalpara>
<title>Temps CPU total</title>
<para>
Le temps CPU total de toutes les unités de travail complétées.
</para>
</formalpara>
<formalpara>
<title>Temps CPU moyen</title>
<para>
Le temps CPU moyen par unité de travail complétée.
</para>
</formalpara>
<formalpara>
<title>Dernier résultat</title>
<para>
Date et heure à laquelle l'utilisateur a renvoyé la dernière unité de travail à SETI@home.
</para>
</formalpara>
<formalpara>
<title>Temps d'enregistrement</title>
<para>
Date et heure à laquelle l'utilisateur s'est enregistré sur SETI@home.
</para>
</formalpara>
</sect1>
<sect1 id="cwu-tab">
<title>L'onglet Unités de travail achevées</title>
<para> </para>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet Unités de travail complétées, affichant la liste
des unités de travail complétées.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cwu-wulist.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet Unités de travail complétées, liste des UT.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Vous trouverez ici les unités de travail déjà calculées classées par
emplacements. Pour accéder aux unités de travail archivées pour un emplacement
spécifique, il vous suffit de sélectionner l'emplacement SETI@home dans l'arborescence
située à gauche (si l'arborescence est en mode refermé, double-cliquez sur
"SETI Locations"). Sur la droite, vous trouverez la liste correspondante.
elle contient les détails suivants:
</para>
<formalpara>
<title>Date d'enregistrement</title>
<para>
La date et l'heure à laquelle l'unité de travail a été archivée. Récupéré à partir du
fichier <filename>result.sah</filename>.
</para>
</formalpara>
<formalpara>
<title>Nom de l'unité de travail</title>
<para>
Que dire de plus?
</para>
</formalpara>
<formalpara>
<title>Temps CPU</title>
<para>
Temps nécessaire à l'accomplissement de l'unité de travail.
</para>
</formalpara>
<formalpara>
<title>% par heures CPU</title>
<para>
Le taux de travail auquel le client a calculé l'unité de travail en une heure
de temps CPU.
</para>
</formalpara>
<formalpara>
<title>Pic</title>
<para>
Le pic le plus intense trouvé dans cette unité de travail.
</para>
</formalpara>
<formalpara>
<title>Gaussienne la plus intense</title>
<para>
La gaussienne la plus intense, d'après son score, trouvée dans cette unité
de travail.
</para>
</formalpara>
<formalpara>
<title>Pulse le plus intense</title>
<para>
Le pulse la plus intense, d'après son score, trouvé dans cette unité
de travail.
</para>
</formalpara>
<formalpara>
<title>Triplet le plus intense</title>
<para>
Le triplet la plus intense, d'après son score, trouvé dans cette unité
de travail.
</para>
</formalpara>
<formalpara>
<title>Enregistré le</title>
<para>
Date et heure d'enregistrement de l'unité de travail.
</para>
</formalpara>
<formalpara>
<title>Fréquence de base</title>
<para>
La fréquence de base de l'unité de travail.
</para>
</formalpara>
<formalpara>
<title>Ouverture angulaire</title>
<para>
Suivant le téléscope utilisé, chaque unité de travail aura une certaine ouverture
angulaire de couverture du ciel. Le client détermine la quantité de travail à
effectuer sur l'UT sur base de cette valeur.
</para>
</formalpara>
<formalpara>
<title>TeraFlops</title>
<para>
Le nombre d'opérations en virgule flotante requises au calcul de l'unité de
de travail (donné en TeraFlops = 10^12 Flops). Le calcul de cette valeur est
basé sur des recherches effectuées par Roelof Engelbrecht et Lawrence Kirby.
</para>
</formalpara>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet unités de travail achevées, affichant une
liste de tous les emplacements.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cwu-locsum.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet unités de travail complétées, liste des emplacements.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Cliquer sur "Emplacements SETI" dans l'arborescence vous donnera une liste de
tous les emplacements SETI@home. Vous obtiendrez ensuite les informations suivantes:
</para>
<formalpara>
<title>Unités de travail</title>
<para>
Le nombre d'unités de travail complétées par l'emplacement SETI@home.
</para>
</formalpara>
<formalpara>
<title>Temps CPU total</title>
<para>
Le temps CPU total utilisé par cet emplacement SETI@home.
</para>
</formalpara>
<formalpara>
<title>Temps CPU moyen</title>
<para>
Le temps CPU moyen utilisé par cet emplacement SETI@home pour terminer une unité de travail.
</para>
</formalpara>
<formalpara>
<title>Pic record</title>
<para>
Le pic record pour cet emplacement SETI@home.
</para>
</formalpara>
<formalpara>
<title>Gaussienne record</title>
<para>
La gaussienne record pour cet emplacement SETI@home.
</para>
</formalpara>
<formalpara>
<title>Pulse record</title>
<para>
Le pulse record pour cet emplacement SETI@home.
</para>
</formalpara>
<formalpara>
<title>Triplet Record</title>
<para>
Le triplet record pour cet emplacement SETI@home.
</para>
</formalpara>
<para>
Cliquer sur <guilabel>Signaux renvoyés</guilabel> dans l'arborescence vous
fournira des statistiques concernant les signaux intéressents trouvés et renvoyés
au serveur SETI@home. En sélectionnant un emplacement spécifique dans la
branche <guilabel>Signaux renvoyés</guilabel>, vous pourrez examiner combien
et quel type de signaux ont été trouvés dans chaque unité de travail.
</para>
<screenshot>
<screeninfo>Une capture d'écran de l'onglet unités de travail complétées, affiche un résumé
de tous les signaux renvoyés.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cwu-sigsum.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet unités de travail complétées, résumé des signaux.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
La colonne <guilabel>Pics totaux (Gaussiennes, Pulses, Triplets)</guilabel> affiche
le nombre de signaux des types respectifs à avoir été trouvés et renvoyés pour un
emplacement spécifique. Les valeurs entre parenthèses représentent la moyenne par
unité de travail. La colonne <guilabel>Meilleur pic (Gaussienne, Pulse, Triplet)</guilabel>
vous informe concernant les meilleurs signaux dans la liste des signaux retournés.
</para>
<screenshot>
<screeninfo>Une capture d'acran de l'onglet unités de travail complétée, affiche quel type
de signaux ont été trouvés dans les unités de travail.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cwu-siglist.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Onglet unités de travail complétée, liste des signaux.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Just like above, this list shows the amount of signals and the best signals, this
time only on work unit level.
</para>
<para>
Both the tree view at the left and the list of work units have a right-click
popup menu with a few extra functions. Selecting a location in the tree view
with a right-mouse-button click and choosing
<guimenuitem>Show on Skymap</guimenuitem> opens the skymap window with all
completed work units of the respective location. Doing the same with
"SETI Locations" all logged work units will be displayed
on the skymap. Alternatively, choosing
<guimenuitem>Reload Locations</guimenuitem> updates all entries in the
"Completed Work Unit" tab. This may be useful if you think that the displayed
list is not up-to-date.
</para>
<para>
Selecting a work unit in the list of completed work units and choosing
<guimenuitem>Show on Skymap</guimenuitem> opens the skymap window only with
the highlighted work unit. If you leave the skymap window open and repeat
the same thing with other entries, these work units will just be added to
the skymap (without deleting the old from the skymap). This way you can
build a customized view of your favorite work units.
</para>
<para>
Selecting the <guimenuitem>Show Logged Signals</guimenuitem> popup menu item
opens a dialog window which presents more details about all the signals that have
been returned to the SETI@home server. More details can be found in the
following section, <xref linkend="logsigs"/>.
</para>
<sect2 id="logsigs">
<title>The Logged Signals Dialog</title>
<para>
This window allows you to browse through all the signals that have been logged
by Ksetiwatch and returned to the SETI@home server. The window basically
consists of a tab widget, with each tab showing details about the four
different types of signals.
</para>
<formalpara>
<title>1. Spikes</title>
<para>
Logged spike data is presented in a list view with the following columns:
<itemizedlist>
<listitem>
<para>
<command>Power:</command> The power of the spike in absolute values.
</para>
</listitem>
<listitem>
<para>
<command>Resolution:</command> The frequency resolution of the
FFT-generated data set, in which the spike was found.
</para>
</listitem>
<listitem>
<para>
<command>Signal Ratio:</command> By the nature of the FFT, the power
of spikes decreases with decreasing frequency resolution. The
calculated signal ratio parameter compensates this effect and allows a
resolution-independent comparison of spikes. Spikes with signal
ratios larger than 22.0 are reported back to SETI@home.
</para>
</listitem>
<listitem>
<para>
<command>RA, Dec:</command> The spike's position in the sky,
shown as a right ascension (RA, in hr), declination (Dec, in deg)
pair.
</para>
</listitem>
<listitem>
<para>
<command>Frequency:</command> The frequency of the receiver in GHz.
</para>
</listitem>
<listitem>
<para>
<command>Chirp Rate:</command> The chirp (or drift) rate in Hz/s.
</para>
</listitem>
</itemizedlist>
</para>
</formalpara>
<formalpara>
<title>2. Gaussians</title>
<para>
Logged gaussians are displayed in graphical form. By use of the navigation
buttons below the graph, you can browse through the list of logged
gaussians. A text box to the right shows the corresponding numeric
parameters:
<itemizedlist>
<listitem>
<para>
<command>Power:</command> The fitted power of the gaussian in
absolute values.
</para>
</listitem>
<listitem>
<para>
<command>Mean:</command> The fitted mean value (i.e. the average
background signal) of the gaussian profile.
</para>
</listitem>
<listitem>
<para>
<command>Sigma:</command> This parameter represents the width of
the gaussian.
</para>
</listitem>
<listitem>
<para>
<command>Fit:</command> The quality of the fit to the recorded data.
Lower is better.
</para>
</listitem>
<listitem>
<para>
<command>Score:</command> The score of the gaussian. This value is
determined by calculating (power/fit).
</para>
</listitem>
<listitem>
<para>
<command>RA, Dec:</command> The position of the gaussian in the sky,
shown as a right ascension (RA), declination (Dec) pair.
</para>
</listitem>
<listitem>
<para>
<command>Frequency:</command> The frequency of the receiver in GHz.
</para>
</listitem>
<listitem>
<para>
<command>Chirp Rate:</command> The chirp (or drift) rate in Hz/s.
</para>
</listitem>
</itemizedlist>
</para>
</formalpara>
<formalpara>
<title>3. Pulses</title>
<para>
Logged pulses are displayed and can be browsed in the same way as
gaussians. Please note, however, that due to limitations of the
SETI@home client some pulse profiles may not be available sometimes.
The following parameters are listed:
<itemizedlist>
<listitem>
<para>
<command>Power:</command> The power of the pulse in
absolute values.
</para>
</listitem>
<listitem>
<para>
<command>Mean:</command> The average background signal of the
pulse profile.
</para>
</listitem>
<listitem>
<para>
<command>Period:</command> The period of the pulse signal in seconds.
</para>
</listitem>
<listitem>
<para>
<command>Score:</command> The score of the pulse.
</para>
</listitem>
<listitem>
<para>
<command>RA, Dec:</command> The position of the pulse in the sky,
shown as a right ascension (RA), declination (Dec) pair.
</para>
</listitem>
<listitem>
<para>
<command>Frequency:</command> The frequency of the receiver in GHz.
</para>
</listitem>
<listitem>
<para>
<command>Chirp Rate:</command> The chirp (or drift) rate in Hz/s.
</para>
</listitem>
</itemizedlist>
</para>
</formalpara>
<para>
<screenshot>
<screeninfo>A screenshot of the Logged Signals dialog.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="loggedsignals.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Logged Signals dialog.</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<formalpara>
<title>4. Triplets</title>
<para>
Logged triplets are displayed and can be browsed in the same way as
gaussians. Please note, however, that due to limitations of the
SETI@home client some triplet profiles may not be available sometimes.
The following parameters are listed:
<itemizedlist>
<listitem>
<para>
<command>Power:</command> The power of the triplet in
absolute values.
</para>
</listitem>
<listitem>
<para>
<command>Mean:</command> The average background signal of the
pulse profile.
</para>
</listitem>
<listitem>
<para>
<command>Period:</command> The period of the triplet signal in
seconds.
</para>
</listitem>
<listitem>
<para>
<command>Score:</command> The score of the triplet. Identical to
power.
</para>
</listitem>
<listitem>
<para>
<command>RA, Dec:</command> The position of the triplet in the sky,
shown as a right ascension (RA), declination (Dec) pair.
</para>
</listitem>
<listitem>
<para>
<command>Frequency:</command> The frequency of the receiver in GHz.
</para>
</listitem>
<listitem>
<para>
<command>Chirp Rate:</command> The chirp (or drift) rate in Hz/s.
</para>
</listitem>
</itemizedlist>
</para>
</formalpara>
<para>
By clicking the <guibutton>Save..</guibutton> button, you can save the
currently displayed signal to disk. The picture is saved in the png graphics
format, adjusted to the standard size of 350x200 pixels.
</para>
</sect2>
</sect1>
<sect1 id="options">
<title>The Options Tab</title>
<para> </para>
<screenshot>
<screeninfo>A screenshot of the Options tab.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="options.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Options tab.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
Ksetiwatch has some global settings which you can modify here.
</para>
<formalpara>
<title>Refresh Interval</title>
<para>
This slider allows you to adjust the time interval between subsequent
refreshs of the list entries. Since the latest SETI@home clients update
their state files approximately once a minute, a value around 60 seconds
is sufficient.
</para>
</formalpara>
<formalpara>
<title>Time Format</title>
<para>
Here you can switch between two time formats: either hours:minutes:seconds
(hh:mm:ss) or days:hours:minutes:seconds (dd:hh:mm:ss).
</para>
</formalpara>
<formalpara>
<title> Report New Signals</title>
<para>
When Ksetiwatch has found a new high signal, it can report this event
to you via a message box. You can easily specify for which kind of
signal you wish to be notified: <guibutton>Spikes</guibutton>,
<guibutton>Gaussians</guibutton>, <guibutton>Pulses</guibutton>,
and/or <guibutton>Triplets</guibutton>. If you additionally check
<guibutton>Only Records</guibutton>, Ksetiwatch will report signals
only if they reach an all-time high (compared to the data found in
the log files). This will keep the amount of report events to an
absolute minimum.
In addition, if you like to play a notification sound along with the popup
of the message box, check <guibutton>Play Sound</guibutton> and enter
the file name of the sound sample in the field below (.wav files are
supported). To test the sound, just click on the arrow button beside
the edit box.
</para>
</formalpara>
<formalpara>
<title>Minimize to Panel</title>
<para>
When you minimize Ksetiwatch this switch allows you to minimize to the
panel, thus freeing up precious space in the taskbar. To open the
Ksetiwatch window again just click on the icon in the panel.
Right-clicking the icon provides a popup menu with some commands to
control the selected SETI@home client.
</para>
</formalpara>
<formalpara>
<title>Show Grid in List Views</title>
<para>
Here you can decide whether you want to have a grid in all list views.
Especially for large lists a grid enhances readability.
</para>
</formalpara>
</sect1>
<sect1 id="addeditbox">
<title>Adding or Editing a SETI@home Location</title>
<para> </para>
<para>
Adding or editing a SETI@home location is done via a dialog box. This window
consists of several pages where all options are clearly arranged.
</para>
<screenshot>
<screeninfo>A screenshot of the add/edit dialog box: general settings
of the SETI@home location.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="addedit-location.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Add/edit dialog.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
The first page, <guibutton>Location</guibutton>, presents general settings of
the SETI@home location. Mandatory entries are <guibutton>Description</guibutton>,
which must contain a descriptive name for your SETI@home location, and
<guibutton>Seti@home Directory</guibutton>, the directory where the SETI@home
client is located. Optionally you can use the Browse button to the right of the
edit box to select the SETI@home directory. Make sure that
each SETI@home location has a unique color by pressing the
<guibutton>Color</guibutton> button and selecting a color you like. This
color will be used in the skymap window to mark the position in the sky
where the work units have been recorded.
</para>
<para>
By default, Ksetiwatch assumes that the name of the SETI@home client executable is
<filename>setiathome</filename>, and tries to start the client it finds in the
corresponding SETI@home directory. If you have renamed the client executable, or
moved it somewhere else, you can customize the file path and the name of the
executable by checking <guibutton>SETI@home client executable</guibutton>. Name and
path can be entered in the edit box below.
</para>
<para>
The second page, <guibutton>SETI@home Client</guibutton>, allows to adjust the settings
and options for the SETI@home client. For instance, Ksetiwatch can start the SETI@home
client for you at start-up. Enable this by checking <guibutton>Invoke SETI@home Client
at Startup</guibutton>. Similarly, you can tell Ksetiwatch to stop the SETI@home client
whenever you close Ksetiwatch by checking <guibutton>Stop SETI@home Client on
Exit</guibutton>. This is useful if you are running a multi-user PC, and you don't want
to hog the machine with running SETI@home clients while other users are working on it.
</para>
<screenshot>
<screeninfo>A screenshot of the add/edit dialog box: settings
of the SETI@home client.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="addedit-client.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Add/edit dialog.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
The priority of the client process can be adjusted by a slider. It is recommended to use
a low priority for the client so as to allow other applications to use the CPU when they
need it.
</para>
<para>
If you are connecting to the SETI@home server via a proxy server, you can enable the use
of the proxy settings by clicking on the <guibutton> Proxy Server</guibutton> checkbox,
and entering the server's URL and port in the respective edit boxes.
</para>
<para>
Command line arguments for the SETI@home client can conveniently be selected
by several checkboxes. You can choose from:
</para>
<formalpara>
<title>-stop_after_process</title>
<para>
If a work_unit.sah file is present, the client processes this work unit
and stops after processing is complete. Results are not returned. If the
client is started with this option, and there is a completed result.sah
file present, the client will first return the results, then pick up a
new work unit, process to completion, then exit.
</para>
</formalpara>
<formalpara>
<title>-stop_after_send</title>
<para>
Enabling this option causes the client to finish up your current work
unit, and to return the result. A new work unit is <command>not</command>
downloaded.
</para>
</formalpara>
<formalpara>
<title>-email</title>
<para>
Sends an email (to the login email address) on errors. This option is
not available for all clients.
</para>
</formalpara>
<formalpara>
<title>-graphics</title>
<para>
Generates a data stream for the xsetiathome graphical interface (see
README.xsetiathome). This option is not available for all clients.
</para>
</formalpara>
<para>
If command line parameters are required which are not covered by the GUI elements on
this page, additional arguments can be passed to the client by entering
the desired options in the <guibutton>Command Line Arguments</guibutton>
edit box. See the SETI@home README file for details on valid command line parameters.
</para>
<note><para>
You have to restart the SETI@home client to make any changes in the settings take effect.
</para></note>
<para> </para>
<screenshot>
<screeninfo>A screenshot of the add/edit dialog box: logging of completed work units.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="addedit-wulogging.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Add/edit dialog.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
The third page, finally, is dedicated to the logging of completed work units.
By default, Ksetiwatch logs completed work units automatically. If you prefer
not to log completed work units, or you are doing your logging with other
programs, you can switch off this feature by unchecking
<guibutton>Enable logging of work units</guibutton>. Starting with version
2.2.0, there is a new feature that allows you to redirect the log files to
directories other than the default folder of the location. Enable this by
checking <guibutton>Redirect Log Files to:</guibutton>. Of course, you will
have to enter the new log directory in the edit box below or select a
directory via the browse button. This feature is especially useful if you
don't have write permission in the default folder (maybe on a remote
computer), or you want to collect the logs of many different SETI@home
locations in one big log file.
</para>
<para>
Clicking the <guibutton>OK</guibutton> button saves all entries to disk
and closes the dialog. All settings are reloaded automatically whenever you
restart Ksetiwatch. Clicking <guibutton>Cancel</guibutton> discards all
changes made in this dialog window.
</para>
</sect1>
<sect1 id="skymap">
<title>The Skymap Window</title>
<para>
The skymap window provides a convenient way for you to see in which part
of the sky your work units have been recorded. The work units are represented
by circle markers which are painted in the color you have chosen for the
respective SETI@home location. The appearance can be customized via a
right-click popup menu. You have the following options:
</para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenuitem>Show Text</guimenuitem>
</menuchoice></term>
<listitem><para>
Each marker can be decorated with some text explaining when the
corresponding work unit was recorded, and which SETI@home location
it belongs to.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Small Marker</guimenuitem>
</menuchoice></term>
<listitem><para>
Draw small-sized markers.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Normal Marker</guimenuitem>
</menuchoice></term>
<listitem><para>
Draw markers in normal size.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Large Marker</guimenuitem>
</menuchoice></term>
<listitem><para>
Draw large markers.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Small Marker</guimenuitem>
</menuchoice></term>
<listitem><para>
Markers can be filled for better visibility.
</para><para> </para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="signal-windows">
<title>The Gaussian, Pulse, and Triplet Windows</title>
<para>
SETI@home clients version 2.0 or higher provide more detailed information
on the signals found, thus allowing a graphical representation of the data.
Three different kind of signals can be shown:
</para>
<formalpara>
<title>Gaussians</title>
<para>
Experimental data is drawn in red, whereas fit results are depicted in
white (available since version 2.0 of the SETI@home client).
</para>
</formalpara>
<formalpara>
<title>Pulses</title>
<para>
Pulse graphs are drawn in the standard way the GUI SETI@home clients
draw them. To illustrate the periodicity of the pulses, the pulse profile
is displayed twice (available since version 3.0 of the SETI@home client).
</para>
</formalpara>
<formalpara>
<title>Triplets</title>
<para>
Again, triplet graphs look very similar to that of the GUI SETI@home
clients. Three little green markers show the position of the triplet
(available since version 3.0 of the SETI@home client).
</para>
</formalpara>
<para>
The appearance of the graphs can be customized via a right-click popup menu.
You have the following options:
</para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenuitem>Bar Chart</guimenuitem>
</menuchoice></term>
<listitem><para>
This is the way the GUI SETI@home clients draw the experimental data
(not available for pulses and triplets).
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Scatter Chart</guimenuitem>
</menuchoice></term>
<listitem><para>
An alternative way to display the experimental data. Data is depicted
by markers and connecting lines (not available for pulses and triplets).
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Style</guimenuitem>
</menuchoice></term>
<listitem><para>
Here you can customize the scatter chart. You can decide whether to
draw markers, connecting lines, or both (not available for pulses and
triplets).
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Show Info</guimenuitem>
</menuchoice></term>
<listitem><para>
Prints the name of the work unit and the numerical parameters in the
window.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Text Position</guimenuitem>
</menuchoice></term>
<listitem><para>
The info text might interfer with the curves. Select here the
preferred position, <guimenuitem>top-left</guimenuitem> or
<guimenuitem>top-right</guimenuitem>.
</para><para> </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenuitem>Save Gaussian...</guimenuitem>
</menuchoice></term>
<listitem><para>
Saves the current Gaussian graph to disk. Only the PNG file format
is supported.
</para><para> </para></listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter>
<chapter id="faq">
<title>Questions and Answers</title>
&reporting.bugs;
&updating.documentation;
<qandaset id="faqlist">
<qandaentry>
<question>
<para>
When I start Ksetiwatch it doesn't show me anything.
</para>
</question>
<answer>
<para>
Ksetiwatch cannot actively search for SETI@home locations on your
computer. Instead, you have to let Ksetiwatch know where you have stored
your SETI@home client. See <link linkend="getting-started">here</link>
for details.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
When trying to start a client via Ksetiwatch the status first
shows "Running", but switches back to "Stop" after some time. What
happened?
</para>
</question>
<answer>
<para>
This indicates that Ksetiwatch wasn't able to start the SETI@home
client. Most probably you don't have the permission execute the client.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
Sometimes Ksetiwatch tells me that the client is still running, although
the work unit has been completed, and no client task can be found in the
process table. How is this possible?
</para>
</question>
<answer>
<para>
This seems to be a bug on the client's side. Obviously the SETI@home
client sometimes fails to write the `result.sah' file after it has
finished a work unit. Just restart Ksetiwatch and the SETI@home client,
and everything should be ok again.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
Ksetiwatch crashes when I try to start the program, or when I click
on the little Ksetiwatch icon in the taskbar.
</para>
</question>
<answer>
<para>
This is most probably due to a buggy portable network graphics (png)
system library installed on your system. Please upgrade your png library
to the most recent version.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
Why are all icons missing (display shows "?"), and why can't I open the
skymap?
</para>
</question>
<answer>
<para>
You obviously installed a binary rpm package that wasn't built for your
distribution. Please ask the vendor of your distribution if he can provide
binary packages of Ksetiwatch. Alternatively, check out
<ulink url="http://rpmfind.net">rpmfind.net</ulink> to see whether somebody
else has already built a binary package matching your system.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>
I'm using RedHat 7.x with the gcc 2.96 compiler, and my self-compiled version
of Ksetiwatch crashes right after startup. What happens here?
</para>
</question>
<answer>
<para>
The binary code produced by gcc 2.96 is incompatible to the latest official
releases of the GNU compiler (2.95.2 or 2.95.3). As a work-around,
recompile Ksetiwatch with --enable debug (./configure --enable-debug). In
addition, visit the RedHat website and grab the latest revision of gcc 2.96,
which hopefully fixes the abovementioned incompatibilities.
</para>
</answer>
</qandaentry>
</qandaset>
</chapter>
<chapter id="credits">
<title>Credits and License</title>
<para>
Ksetiwatch
</para>
<para>
Program copyright 1999-2001, 2002 Gordon Machel <email>gmachel@users.sourceforge.net</email>
</para>
<para>
Documentation copyright 2000-2001, 2002 Gordon Machel <email>gmachel@users.sourceforge.net</email>
</para>
&underFDL; <!-- FDL: do not remove -->
&underGPL; <!-- GPL License -->
</chapter>
<appendix id="installation">
<title>Installation</title>
<sect1 id="getting-ksetiwatch">
<title>How to obtain Ksetiwatch</title>
<para>
You will find the most up-to-date version and new information about this
program at the Ksetiwatch homepage:
<ulink url="http://ksetiwatch.sourceforge.net">http://ksetiwatch.sourceforge.net</ulink>.
</para>
</sect1>
<sect1 id="requirements">
<title>Requirements</title>
<para>
This version of Ksetiwatch is designed for KDE 2.x and Qt 2.2.x. Additionally,
you will need SETI@home 2.0 or higher to make full use of this program.
Beginning with Ksetiwatch 2.1.0, clients with version number 1.x are not
supported any more (this is not a problem, of course, since only the latest
version of the client (3.03) is allowed to be used) . You can get the SETI@home
client at the
<ulink url="http://setiathome.ssl.berkeley.edu">SETI@home web site</ulink>.
</para>
<para>
You can find a list of changes at
<ulink url="http://ksetiwatch.sourceforge.net/ChangeLog">
http://ksetiwatch.sourceforge.net/ChangeLog</ulink>.
</para>
</sect1>
<sect1 id="compilation">
<title>Compilation and installation</title>
<para>
In order to compile and install Ksetiwatch on your system, type the following
in the base directory of the Ksetiwatch distribution:
<screen width="40">
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>
</para>
<para>Since Ksetiwatch uses autoconf and automake you should not have
trouble compiling it. Should you run into problems please report them to
the author at <email>gmachel@users.sourceforge.net</email>, or have a look
at the <ulink url="http://ksetiwatch.sourceforge.net/download.php3">
Ksetiwatch download page</ulink>,
where more information can be found. In addition, there is a
<ulink url="http://sourceforge.net/forum/?group_id=1045">
discussion forum</ulink> and a
<ulink url="http://sourceforge.net/forum/?group_id=1045">
help forum</ulink> at <ulink url="http://sourceforge.net">Sourceforge</ulink>
where the author or other users will do their best to help you.
</para>
</sect1>
<sect1 id="configuration">
<title>Configuration</title>
<para>
Please read the Getting Started chapter first if you plan to run the
SETI@home client for the first time.
</para>
</sect1>
</appendix>
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
distrib
>
Mandriva
>
2007.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1acd272f00a0b6846b08c87d93691f12
>
files
>
80
