wiki:CreditStats

Version 6 (modified by Nicolas, 17 years ago) (diff)

Server-relative links

Credit statistics web sites and services

Statistics data is the number of credit units? granted to hosts, participants and teams by the various BOINC projects. This can be used for various purposes, such as:

  • Web sites that show statistics and leaderboards for one or more BOINC projects. Examples are listed at here.
  • Dynamically-generated images (typically used as message-board signatures) that show user and/or team credit, possible across projects. Examples are listed at here.
  • Displays of current credit on cell phones and PDAs.

Displays that use colors to distinguish BOINC projects should use these colors.

BOINC provides a flexible architecture for distributing statistics data, with the goal of enabling new display applications.


http://boinc.berkeley.edu/stats.png
The BOINC statistics data architecture


Getting data from projects

Each BOINC project provides data in two forms:

  • As 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.
  • As a set of Web RPCs that return an XML-format description of a given participant's credit, based on that participant's database ID.

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.

Aggregate data

A data aggregator is a service that collects XML files from several projects, and computes the totals for participants and hosts (based on cross-project IDs?) across these projects. This aggregate data is then exported in two ways:

Application developers are encouraged to concentrate on aggregate rather than per-project data. This will encourage participants to join multiple projects.

Code examples

Developing a system that collects, analyzes, and stores credit data from all BOINC projects is a large development task. The code for BOINC Combined Stats, a web site/service that provides per-project and aggregate data, can be downloaded via Subversion from

http://boinc.berkeley.edu/svn/trunk/boinc_stats

Attachments (1)

Download all attachments as: .zip