# Le manuel de Ksetiwatch

Gordon
Machel

    gmachel@users.sourceforge.net

2000-2001
2002
Gordon Machel
&FDLNotice;
01/25/2002
2.2.5

Ksetiwatch est un outil d'information (ndt: monitor tool) pour le projet de calcul distribué Seti@home, 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.

KDE
Ksetiwatch
Applications
seti@home
seti
monitoring

## Introduction

Ksetiwatch est un outil d'information (ndt: monitor tool) pour le projet de calcul distribué Seti@home, 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.

Ksetiwatch possède le même look-and-feel que le programme populaire SETIWatch, écrit pour les plateformes Windows95/98/NT par Mark Loukko. Il partage beaucoup des fonctionnalités offertes par SETIWatch, et fourni certaines autres. Les points importants sont:

- contrôle d'autant de clients que vous voulez,

- incorporation dans le panneau KDE,

- vous prévient lors de la découverte de nouveaux signaux,

- enregistrement automatique des résultats des unités de travail complétées,

- enregistrement automatique de tous les signaux intéressant renvoyés au serveur SETI@home, cela inclus leur profil pour une représentation graphique,

- affiche la liste des unités de travail complétées et des signaux intéressants,

- entièrement compatible avec les fichiers d'archives de SETIWatch/SETILog,

- affiche les unités de travail en cours de calcul ainsi que les UT archivées sur une carte du ciel,

- démarre et arrête les clients SETI@home; les clients peuvent être exécutés avec des options configurables,

- offre l'affichage d'un statut détaillé (en cours, arrêté, fini, chargement),

- affiche les graphiques de gaussiennes, pulses et triplets.

## Guide de démarrage

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.

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.

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.

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 `setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1.tar`), et qu'elle est stockée dans votre répertoire personnel.

Donc, ouvrez un terminal, et assurez-vous d'être dans votre répertoire personnel.

     % pwd
    /home/gordon
    %

Si ce n'est pas le cas, placez-vous vers votre répertoire personnel avec `cd ~`, ou `cd $HOME`. Maintenant, décompactez l'archive.

     % tar xvf setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1.tar
    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
    %

Cette commande a créé un nouveau répertoire `setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1` 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 `mv setiathome-3.03.i386-pc-linux-gnu-gnulibc2.1 setiathome`.

Il est maintenant temps de se placer dans ce nouvel emplacement SETI@home et de démarrer le client SETI@home. Notez le petit `./` au début de la commande de démarrage. Il signifie que le fichier exécutable `setiathome` 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).

     % cd setiathome
    %
    % ./setiathome
    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):

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).

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:

Une capture d'écran de Ksetiwatch après le premier démarrage.
Démarrage de Ksetiwatch.

Pour ajouter votre client à la liste des emplacements SETI@home faites un click droit sur la liste (vide) (le grand emplacement blanc) dans l'ongletAnalyse. Vous obtiendrez un menu déroulant, choisissez Add.... Une boîte de dialogue apparaîtra, où vous devrez remplir les champs requis.

Une capture d'écran de la boîte de dialogue d'ajout ou de modification d'un emplacement SETI@home.
dialogue d'ajout/modification.

Entrez un nom décrivant votre emplacement SETI@home dans le champ Description:, 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 OK, Ksetiwatch devrait contrôler votre emplacement SETI@home.

Une explication détaillée de toutes les options des autres boîtes de dialogue peut être trouvée à . 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

## Utiliser Ksetiwatch

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.

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.

Si vous avez mis à jour le client SETI@home à une version 3.x, Ksetiwatch modifie automatiquement le fichier d'archivage (`SETILog.csv`) 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 `SETILog.old`. 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.

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.

Nous allons maintenant décrire en détail le contenu des onglets ainsi que les options.

### L'onglet Analyse

Une capture d'écran de l'onglet Analyse.
L'onglet Analyse.

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:

#### Emplacement

Le nom que vous avez choisi pour le client SETI@home.

#### Statu

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).

#### Décalage

Le décalage (ndt:chirp rate) auquel le client est en train de calculer.

#### % Effectué

Cette entrée affiche la progression en pourcents du client SETI@home.

#### Temps CPU

Le temps que le client a passé à analyser l'unité de travail actuelle.

#### Temps restant

Une estimation du temps de calcul restant pour terminer l'unité de travail.

#### %/heures CPU

Ceci vous donne une idée du taux de progression du client en une heure de temps CPU.

#### MFlops

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.

#### Pique

Le pic le plus haut trouvé jusqu'ici.

#### Gaussienne la plus intense

La gaussienne la plus intense, d'après son score, trouvée jusqu'ici. Le score est déterminé par (puissance/fit).

#### Pulse le plus intense

le pulse le plus intense, d'après son score, trouvé jusqu'ici.

#### Triplet le plus intense

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.

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

Ajouter...

  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 ici pour plus de détails.

Modifier...

  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.

Supprimer

  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é.

Démarrer le client

  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).

Arrêter le client

  Essaye d'arrêter le client SETI@home. Les remarques précédentes sont également d'application ici.

Afficher...

  Si des signaux importants (Gaussienne, pulse, ou triplet) ont été trouvé, vous pouvez les afficher dans une fenêtre séparée. Voyez ici pour plus de détails. Cette fonction ne fonctionne que pour des clients SETI@home de version 2.0 ou supérieure.

Quelques éléments de contrôle supplémentaires peuvent être trouvés au bas de cet onglet.

  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.

  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.

  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.

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.

Si vous avez activé l'option "minimiser dans le panneau" (voir ), 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!

### L'onglet Infos données

Une capture d'écran de l'onglet Infos données.
Onglet Infos données.

L'onglet Infos données contient toutes les informations importantes concernant les unités de travail en cours de traitement. Cela inclus:

#### Origine

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 Skymap en bas à gauche. Vous pourrez trouver plus de détails concernant la carte du ciel à .

#### Enregistré le

La date et l'heure à laquelle cette unité de travail a été enregistrée. Le temps est donné en GMT.

#### Source

Le radio télescope ayant enregistré cette unité de travail.

#### Fréquence de base

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.

#### Ouverture angulaire

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.

#### TeraFlops

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.

### L'onglet Info utilisateur

L'onglet Info utilisateur fourni des détails concernant les utilisateurs qui exécutent les emplacements SETI@home spécifiques:

Une capture d'écran de l'onglet Info utilisateur.
Onglet Info utilisateur.

#### Nom

Le nom sous lequel l'utilisateur s'est enregistré sur SETI@home.

#### UT complétées

Le nombre d'unités de travail que l'utilisateur a terminées.

#### Temps CPU total

Le temps CPU total de toutes les unités de travail complétées.

#### Temps CPU moyen

Le temps CPU moyen par unité de travail complétée.

#### Dernier résultat

Date et heure à laquelle l'utilisateur a renvoyé la dernière unité de travail à SETI@home.

#### Temps d'enregistrement

Date et heure à laquelle l'utilisateur s'est enregistré sur SETI@home.

### L'onglet Unités de travail achevées

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.
Onglet Unités de travail complétées, liste des UT.

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:

#### Date d'enregistrement

La date et l'heure à laquelle l'unité de travail a été archivée. Récupéré à partir du fichier `result.sah`.

#### Nom de l'unité de travail

Que dire de plus?

#### Temps CPU

Temps nécessaire à l'accomplissement de l'unité de travail.

#### % par heures CPU

Le taux de travail auquel le client a calculé l'unité de travail en une heure de temps CPU.

#### Pic

Le pic le plus intense trouvé dans cette unité de travail.

#### Gaussienne la plus intense

La gaussienne la plus intense, d'après son score, trouvée dans cette unité de travail.

#### Pulse le plus intense

Le pulse la plus intense, d'après son score, trouvé dans cette unité de travail.

#### Triplet le plus intense

Le triplet la plus intense, d'après son score, trouvé dans cette unité de travail.

#### Enregistré le

Date et heure d'enregistrement de l'unité de travail.

#### Fréquence de base

La fréquence de base de l'unité de travail.

#### Ouverture angulaire

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.

#### TeraFlops

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.

Une capture d'écran de l'onglet unités de travail achevées, affichant une liste de tous les emplacements.
Onglet unités de travail complétées, liste des emplacements.

Cliquer sur "Emplacements SETI" dans l'arborescence vous donnera une liste de tous les emplacements SETI@home. Vous obtiendrez ensuite les informations suivantes:

#### Unités de travail

Le nombre d'unités de travail complétées par l'emplacement SETI@home.

#### Temps CPU total

Le temps CPU total utilisé par cet emplacement SETI@home.

#### Temps CPU moyen

Le temps CPU moyen utilisé par cet emplacement SETI@home pour terminer une unité de travail.

#### Pic record

Le pic record pour cet emplacement SETI@home.

#### Gaussienne record

La gaussienne record pour cet emplacement SETI@home.

#### Pulse record

Le pulse record pour cet emplacement SETI@home.

#### Triplet Record

Le triplet record pour cet emplacement SETI@home.

Cliquer sur Signaux renvoyés 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 Signaux renvoyés, vous pourrez examiner combien et quel type de signaux ont été trouvés dans chaque unité de travail.

Une capture d'écran de l'onglet unités de travail complétées, affiche un résumé de tous les signaux renvoyés.
Onglet unités de travail complétées, résumé des signaux.

La colonne Pics totaux (Gaussiennes, Pulses, Triplets) 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 Meilleur pic (Gaussienne, Pulse, Triplet) vous informe concernant les meilleurs signaux dans la liste des signaux retournés.

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.
Onglet unités de travail complétée, liste des signaux.

Just like above, this list shows the amount of signals and the best signals, this time only on work unit level.

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 Show on Skymap 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 Reload Locations 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.

Selecting a work unit in the list of completed work units and choosing Show on Skymap 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.

Selecting the Show Logged Signals 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, .

#### The Logged Signals Dialog

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.

##### 1. Spikes

Logged spike data is presented in a list view with the following columns:

- `Power:` The power of the spike in absolute values.

- `Resolution:` The frequency resolution of the FFT-generated data set, in which the spike was found.

- `Signal Ratio:` 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.

- `RA, Dec:` The spike's position in the sky, shown as a right ascension (RA, in hr), declination (Dec, in deg) pair.

- `Frequency:` The frequency of the receiver in GHz.

- `Chirp Rate:` The chirp (or drift) rate in Hz/s.

##### 2. Gaussians

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:

- `Power:` The fitted power of the gaussian in absolute values.

- `Mean:` The fitted mean value (i.e. the average background signal) of the gaussian profile.

- `Sigma:` This parameter represents the width of the gaussian.

- `Fit:` The quality of the fit to the recorded data. Lower is better.

- `Score:` The score of the gaussian. This value is determined by calculating (power/fit).

- `RA, Dec:` The position of the gaussian in the sky, shown as a right ascension (RA), declination (Dec) pair.

- `Frequency:` The frequency of the receiver in GHz.

- `Chirp Rate:` The chirp (or drift) rate in Hz/s.

##### 3. Pulses

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:

- `Power:` The power of the pulse in absolute values.

- `Mean:` The average background signal of the pulse profile.

- `Period:` The period of the pulse signal in seconds.

- `Score:` The score of the pulse.

- `RA, Dec:` The position of the pulse in the sky, shown as a right ascension (RA), declination (Dec) pair.

- `Frequency:` The frequency of the receiver in GHz.

- `Chirp Rate:` The chirp (or drift) rate in Hz/s.

A screenshot of the Logged Signals dialog. Logged Signals dialog.

##### 4. Triplets

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:

- `Power:` The power of the triplet in absolute values.

- `Mean:` The average background signal of the pulse profile.

- `Period:` The period of the triplet signal in seconds.

- `Score:` The score of the triplet. Identical to power.

- `RA, Dec:` The position of the triplet in the sky, shown as a right ascension (RA), declination (Dec) pair.

- `Frequency:` The frequency of the receiver in GHz.

- `Chirp Rate:` The chirp (or drift) rate in Hz/s.

By clicking the Save.. 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.

### The Options Tab

A screenshot of the Options tab.
Options tab.

Ksetiwatch has some global settings which you can modify here.

#### Refresh Interval

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.

#### Time Format

Here you can switch between two time formats: either hours:minutes:seconds (hh:mm:ss) or days:hours:minutes:seconds (dd:hh:mm:ss).

#### Report New Signals

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: Spikes, Gaussians, Pulses, and/or Triplets. If you additionally check Only Records, 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 Play Sound 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.

#### Minimize to Panel

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.

#### Show Grid in List Views

Here you can decide whether you want to have a grid in all list views. Especially for large lists a grid enhances readability.

### Adding or Editing a SETI@home Location

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.

A screenshot of the add/edit dialog box: general settings of the SETI@home location.
Add/edit dialog.

The first page, Location, presents general settings of the SETI@home location. Mandatory entries are Description, which must contain a descriptive name for your SETI@home location, and Seti@home Directory, 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 Color 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.

By default, Ksetiwatch assumes that the name of the SETI@home client executable is `setiathome`, 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 SETI@home client executable. Name and path can be entered in the edit box below.

The second page, SETI@home Client, 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 Invoke SETI@home Client at Startup. Similarly, you can tell Ksetiwatch to stop the SETI@home client whenever you close Ksetiwatch by checking Stop SETI@home Client on Exit. 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.

A screenshot of the add/edit dialog box: settings of the SETI@home client.
Add/edit dialog.

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.

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 Proxy Server checkbox, and entering the server's URL and port in the respective edit boxes.

Command line arguments for the SETI@home client can conveniently be selected by several checkboxes. You can choose from:

#### -stop_after_process

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.

#### -stop_after_send

Enabling this option causes the client to finish up your current work unit, and to return the result. A new work unit is `not` downloaded.

#### -email

Sends an email (to the login email address) on errors. This option is not available for all clients.

#### -graphics

Generates a data stream for the xsetiathome graphical interface (see README.xsetiathome). This option is not available for all clients.

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 Command Line Arguments edit box. See the SETI@home README file for details on valid command line parameters.

You have to restart the SETI@home client to make any changes in the settings take effect.

A screenshot of the add/edit dialog box: logging of completed work units.
Add/edit dialog.

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 Enable logging of work units. 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 Redirect Log Files to:. 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.

Clicking the OK button saves all entries to disk and closes the dialog. All settings are reloaded automatically whenever you restart Ksetiwatch. Clicking Cancel discards all changes made in this dialog window.

### The Skymap Window

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:

Show Text

  Each marker can be decorated with some text explaining when the corresponding work unit was recorded, and which SETI@home location it belongs to.

Small Marker

  Draw small-sized markers.

Normal Marker

  Draw markers in normal size.

Large Marker

  Draw large markers.

Small Marker

  Markers can be filled for better visibility.

### The Gaussian, Pulse, and Triplet Windows

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:

#### Gaussians

Experimental data is drawn in red, whereas fit results are depicted in white (available since version 2.0 of the SETI@home client).

#### Pulses

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).

#### Triplets

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).

The appearance of the graphs can be customized via a right-click popup menu. You have the following options:

Bar Chart

  This is the way the GUI SETI@home clients draw the experimental data (not available for pulses and triplets).

Scatter Chart

  An alternative way to display the experimental data. Data is depicted by markers and connecting lines (not available for pulses and triplets).

Style

  Here you can customize the scatter chart. You can decide whether to draw markers, connecting lines, or both (not available for pulses and triplets).

Show Info

  Prints the name of the work unit and the numerical parameters in the window.

Text Position

  The info text might interfer with the curves. Select here the preferred position, top-left or top-right.

Save Gaussian...

  Saves the current Gaussian graph to disk. Only the PNG file format is supported.

## Questions and Answers

&reporting.bugs; &updating.documentation;

When I start Ksetiwatch it doesn't show me anything.

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 here for details.

When trying to start a client via Ksetiwatch the status first shows "Running", but switches back to "Stop" after some time. What happened?

This indicates that Ksetiwatch wasn't able to start the SETI@home client. Most probably you don't have the permission execute the client.

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?

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.

Ksetiwatch crashes when I try to start the program, or when I click on the little Ksetiwatch icon in the taskbar.

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.

Why are all icons missing (display shows "?"), and why can't I open the skymap?

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 rpmfind.net to see whether somebody else has already built a binary package matching your system.

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?

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.

## Credits and License

Ksetiwatch

Program copyright 1999-2001, 2002 Gordon Machel gmachel@users.sourceforge.net

Documentation copyright 2000-2001, 2002 Gordon Machel gmachel@users.sourceforge.net

&underFDL;

&underGPL;

## Installation

### How to obtain Ksetiwatch

You will find the most up-to-date version and new information about this program at the Ksetiwatch homepage: http://ksetiwatch.sourceforge.net.

### Requirements

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 SETI@home web site.

You can find a list of changes at http://ksetiwatch.sourceforge.net/ChangeLog.

### Compilation and installation

In order to compile and install Ksetiwatch on your system, type the following in the base directory of the Ksetiwatch distribution:

    % ./configure
    % make
    % make install

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 gmachel@users.sourceforge.net, or have a look at the Ksetiwatch download page, where more information can be found. In addition, there is a discussion forum and a help forum at Sourceforge where the author or other users will do their best to help you.

### Configuration

Please read the Getting Started chapter first if you plan to run the SETI@home client for the first time.