# The &kappname; Handbook

## Introduction

### Documentation

The documentation for &kappname; isn't ready yet. For now, I recommend you consult the documentation for &ksetispy;, whose interface and options are, for the most part, very similar.

In the following, I will briefly describe some features that are either unique to &kappname; or present major changes with respect to &ksetispy;.

#### Calibration

&kappname; offers a self-learning calibration algorithm for the SETI@home client, instead of a list of fixed calibration presets like &ksetispy; did. This can be considered a major improvement, since now the calibration values used are those which are a perfect fit for your computer, rather than some preset that was computer on some other machine that may or may not approximate yours. The downside of this change is that calibration will require a short initial training period (no user interaction whatsoever is needed for this training, however).

After monitoring the entire execution of a SETI@home workunit, &kappname; will generate a set of calibration values for that execution. The overall calibration values will be computed as the weighted average of the sets of values obtained from each workunit, where each of these sets has weight 1. The system will start with a set of null calibration values (i.e. the reported and effective are the same) with weight 1.

You can use the Calibration panel to inspect the current calibration, and optionally reset to its initial values.

#### Log Formats

&kappname; adopts the BOINCLogX format for its logs. This format can be divided in three parts. There's a project-independent log (file `boinc.csv`), and two project-dependent ones, for AstroPulse (file `ap_boinc.csv`) and for SETI@home (file `sah_boinc.csv`). For SETI@home, &kappname; offers additional formats from many popular SETI@home Classic add-ons.

These three parts can be set separately. The settings for the project-independent part are in the General entry of the Preferences panel. It's recommended that you set up the project-independent log, since it is used in the Credits Calendar panel to display the credits you were awarded (or, more appropriately, you should have been awarded, based on the amout of work done) by the server.

## Credits and License

&kboincspy; 0.9

Program Copyright 2005 Roberto Virga rvirga@users.sf.net

Documentation Copyright 2004 Roberto Virga rvirga@users.sf.net

&underFDL; &underGPL;