From 9a790726c6ba6dc200745f04e2fab5c48acc91b2 Mon Sep 17 00:00:00 2001
From: David Anderson <davea@ssl.berkeley.edu>
Date: Thu, 15 Jan 2004 01:18:25 +0000
Subject: [PATCH] *** empty log message ***

svn path=/trunk/boinc/; revision=2879
---
 checkin_notes   |  7 +++++++
 doc/contact.php |  2 ++
 doc/credit.php  | 40 +++++++++++++++++++++++++++++++++++++---
 doc/teams.php   |  6 ++++--
 4 files changed, 50 insertions(+), 5 deletions(-)

diff --git a/checkin_notes b/checkin_notes
index 5140bc8999..bccc6a33d9 100755
--- a/checkin_notes
+++ b/checkin_notes
@@ -9183,6 +9183,13 @@ David  Jan 14 2004
     sched/
         start
 
+David  Jan 14 2004
+    - add <core_client_version> element to <stderr_out>
+        of results when send to server
+
+    client/
+        client_types.C
+
 David  Jan 14 2004
 	- don't blink sys tray icon more than 10 sec (from Rom Walton)
 
diff --git a/doc/contact.php b/doc/contact.php
index 5350831528..eec7ddf38f 100644
--- a/doc/contact.php
+++ b/doc/contact.php
@@ -31,6 +31,8 @@ Tim Lan
 <br>
 Stephen Pellicer
 <br>
+Jens Seidler
+<br>
 Rom Walton
 <br>
 Oliver Wang
diff --git a/doc/credit.php b/doc/credit.php
index 0f9d2db724..2033ba2f47 100644
--- a/doc/credit.php
+++ b/doc/credit.php
@@ -11,7 +11,7 @@ individuals, teams, and categories (countries, CPU types, etc.)
 ranked by credit.
 
 <p>
-BOINC's credit system is based on a 'reference computer' that does
+BOINC's credit system is based on a 'reference computer' that can do
 <ul>
 <li>1 billion floating-point multiplies per second
 <li>1 billion integer multiplies per second
@@ -19,7 +19,7 @@ BOINC's credit system is based on a 'reference computer' that does
 (sequential, half reads and half writes)
 </ul>
 BOINC's unit of credit, the <b>Cobblestone</b> <sup>1</sup>,
-is one day of CPU time on the reference computer.
+is 1/300 day of CPU time on the reference computer.
 
 <p>
 Each project maintains two types of credit:
@@ -28,7 +28,8 @@ Each project maintains two types of credit:
 The total number of Cobblestones performed.
 <li> <b>Recent average credit</b>:
 The average number of Cobblestones per day performed recently.
-This average decreases by a factor of two every week.
+This average decreases by a factor of two every week,
+according to algorithms given below.
 </ul>
 
 <p>
@@ -62,6 +63,39 @@ projects supply their own benchmarking functions.
 This will also handle the situation where a project's
 application does e.g. all integer arithmetic.
 </ul>
+
+<h3>How 'Recent Average Credit' is computed</h3>
+Each time new credit granted,
+the following function is used to update the
+recent average credit of the host, user and team:
+<pre>
+
+// decay an exponential average of credit per day,
+// and possibly add an increment for new credit
+//
+void update_average(
+    double credit_assigned_time,        // when work was started for new credit
+                                        // (or zero if no new credit)
+    double credit,                      // amount of new credit
+    double& avg,                        // average credit per day (in and out)
+    double& avg_time                    // when average was last computed
+) {
+    double now = dtime();
+
+    if (avg_time) {
+        double diff = now - avg_time;
+        double diff_days = diff/SECONDS_IN_DAY;
+        double weight = exp(-diff*LOG2/AVG_HALF_LIFE);
+        avg *= weight;
+        avg += (1-weight)*(credit/diff_days);
+    } else {
+        double dd = (now - credit_assigned_time)/SECONDS_IN_DAY;
+        avg = credit/dd;
+    }
+    avg_time = now;
+}
+</pre>
+
 <hr noshade size=1>
 <sup>1</sup> Named after Jeff Cobb of SETI@home
 ";
diff --git a/doc/teams.php b/doc/teams.php
index 47e80f4d49..ba6444ca9f 100644
--- a/doc/teams.php
+++ b/doc/teams.php
@@ -11,8 +11,10 @@ The participant who created the team is called its <b>founder</b>.
 A team is local to a project.
 There is currently no provision for teams that span projects.
 <p>
-Total and average credit is accounted for teams;
-a team's credit is the sum of the credits of its members.
+Total and average credit is accounted for teams,
+and reflects all work done by participants
+while they belong to the team
+(even if they later quit the team).
 
 <p>
 A team has the following attributes: