diff --git a/doc/db_dump.php b/doc/db_dump.php index 332eb18c4c..b40a5d24ec 100644 --- a/doc/db_dump.php +++ b/doc/db_dump.php @@ -1,42 +1,11 @@ -BOINC projects can export statistics data -describing teams, users and hosts. -This data can be used for various purposes: - - -

-Statistics data is exported in XML-format files. -

+Projects export statistics data in XML-format files. Most projects regenerate the files every 24 hours. -

These files are contained in a download directory, linked to from the project's web site (generally X/stats/, where X is the project URL). diff --git a/doc/stats.odg b/doc/stats.odg index 42e2b2e34b..8b8a6c3f02 100644 Binary files a/doc/stats.odg and b/doc/stats.odg differ diff --git a/doc/stats.php b/doc/stats.php index cc7a599189..7916726ec1 100644 --- a/doc/stats.php +++ b/doc/stats.php @@ -4,8 +4,88 @@ require_once("docutil.php"); page_head("Statistics data"); echo " -Stati +Statistics data is the number of +Cobblestones (credit units) +granted to hosts, participants and teams by the +various BOINC projects. +This data can be used for various purposes, such as: +

+ +

+BOINC provides a flexible architecture for distributing +statistics data, with the intent of enabling new uses of this data. +

+

+

The BOINC statistics data architecture
+ +

Project data

+

+Each BOINC project provides data in two forms: +

+ +

+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: +

+

+Examples are here: + +http://www.boinc.dk/index.php?page=download_stats_xml and +http://www.boincstats.com/xml/xml_user_example.php. + +

+Application developers are encouraged to concentrate +on aggregate rather than per-project data. +This will encourage participants to join multiple projects, +and will make it possible for new projects to quickly get +many participants. "; page_tail();