Changes between Version 14 and Version 15 of CreditStats


Ignore:
Timestamp:
06/08/14 22:13:58 (3 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • CreditStats

    v14 v15  
     1[[PageOutline]]
    12= Credit statistics web sites and services =
    23
     
    45granted to hosts, participants and teams by the various BOINC projects.
    56This can be used for various purposes, such as:
    6  * Web sites that show statistics and leaderboards for one or more BOINC projects. Examples are available on the [http://boinc.berkeley.edu/links.php#stats list of stats sites].
    7  * Dynamically-generated images (typically used as message-board signatures) that show user and/or team credit, possible across projects. Examples are listed [http://boinc.berkeley.edu/links.php#sigs here].
     7 * Web sites that show statistics and leaderboards for one or more BOINC projects.
     8   Examples are available on the [http://boinc.berkeley.edu/links.php#stats list of stats sites].
     9 * Dynamically-generated images (typically used as message-board signatures)
     10   that show user and/or team credit, possible across projects.
     11   Examples are listed [http://boinc.berkeley.edu/links.php#sigs here].
    812 * Displays of current credit on cell phones and PDAs.
    913
    10 Displays that use colors to distinguish BOINC projects should use [http://boinc.netsoft-online.com/e107_plugins/forum/forum_viewtopic.php?3 these colors].
     14Displays that use colors to distinguish BOINC projects should use
     15[http://boinc.netsoft-online.com/e107_plugins/forum/forum_viewtopic.php?3 these colors].
    1116
    1217BOINC provides a flexible architecture for distributing statistics data, with the goal of enabling new display applications.
     
    2025Each BOINC project provides data in two forms:
    2126
    22  * As [XmlStats a set of downloadable files] (in a compressed XML format) that contain the project's complete current statistics. These files are typically updated once every 24 hours.
    23  * As [WebRpc a set of Web RPCs] that return an XML-format description of a given participant's credit, based on that participant's database ID.
     27 * As [XmlStats a set of downloadable files] (in a compressed XML format) that contain the project's complete current statistics.
     28   These files are typically updated once every 24 hours.
     29 * As [WebRpc a set of Web RPCs] that return an XML-format description of a given participant's credit,
     30   based on that participant's database ID.
    2431
    2532
    26 Applications should access these data sources as infrequently as possible, to avoid imposing unnecessary load on project servers. For example, a Web RPCs to get a particular participant's data should made at most once per hour.
     33Applications should access these data sources as infrequently as possible,
     34to avoid imposing unnecessary load on project servers.
     35For example, a Web RPCs to get a particular participant's data should made at most once per hour.
    2736
    2837== Aggregate data == #aggregate
    29 A '''data aggregator''' is a service that collects XML files from several projects, and computes the totals for participants and hosts (based on [CrossProjectId cross-project IDs]) across these projects. This aggregate data is then exported in two ways:
     38A '''data aggregator''' is a service that collects XML files from several projects,
     39and computes the totals for participants and hosts (based on [CrossProjectId cross-project IDs]) across these projects.
     40This aggregate data is then exported in two ways:
    3041
    31  * As [StatsXml a set of downloadable files] (in a compressed XML format). An example is at  http://boinc.netsoft-online.com/stats/.
    32  * As [StatsXml#WebRPCs a set of Web RPCs] that return an XML-format description of a given participant or host's credit, based on the cross-project ID. Example: !http://boinc.netsoft-online.com/get_host.php?cpid=???? and !http://boinc.netsoft-online.com/get_host_tot.php?cpid=????
     42 * As [StatsXml a set of downloadable files] (in a compressed XML format).
     43   An example is at  http://boinc.netsoft-online.com/stats/.
     44 * As [StatsXml#WebRPCs a set of Web RPCs] that return an XML-format description
     45   of a given participant or host's credit, based on the cross-project ID.
     46   Example: !http://boinc.netsoft-online.com/get_host.php?cpid=????
     47   and !http://boinc.netsoft-online.com/get_host_tot.php?cpid=????
    3348
    34 Application developers are encouraged to concentrate on aggregate rather than per-project data. This will encourage participants to join multiple projects.
     49Application developers are encouraged to concentrate on aggregate rather than per-project data.
     50This will encourage participants to join multiple projects.
    3551
    3652== Code examples == #code-examples
    3753
    3854Developing a system that collects, analyzes, and stores credit data from all BOINC projects is a large development task.
    39 The code for [http://boinc.netsoft-online.com/ BOINC Combined Stats], a web site/service that provides per-project and aggregate data, can be downloaded via git using
     55The code for [http://boinc.netsoft-online.com/ BOINC Combined Stats],
     56a web site/service that provides per-project and aggregate data, can be downloaded via git using
    4057{{{
    4158git clone git://boinc.berkeley.edu/boinc-combined-stats.git
     
    4562
    4663== Computing the current value of Recent Average Credit == #rac-decay
    47 BOINC updates 'recent average credit' (RAC) only when new credit is granted. Interfaces that export RAC also export that time at which it was last updated. To obtain the current value of RAC, you must 'decay' it based on the time that has elapsed since it was updated:
     64BOINC updates 'recent average credit' (RAC) only when new credit is granted.
     65Interfaces that export RAC also export that time at which it was last updated.
     66To obtain the current value of RAC,
     67you must 'decay' it based on the time that has elapsed since it was updated:
    4868
    4969{{{
     
    6282If you don't apply this decay, inactive entities will have incorrectly high RAC.
    6383
    64 PHP code for the decay function can be found in [source:boinc/html/inc/credit.inc html/inc/credit.inc] and [source:boinc/html/inc/host.inc html/inc/host.inc].
     84PHP code for the decay function can be found in [source:boinc/html/inc/credit.inc html/inc/credit.inc]
     85and [source:boinc/html/inc/host.inc html/inc/host.inc].