Changes between Version 14 and Version 15 of CreditStats
- Timestamp:
- Jun 8, 2014, 10:13:58 PM (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
CreditStats
v14 v15 1 [[PageOutline]] 1 2 = Credit statistics web sites and services = 2 3 … … 4 5 granted to hosts, participants and teams by the various BOINC projects. 5 6 This 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]. 8 12 * Displays of current credit on cell phones and PDAs. 9 13 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]. 14 Displays that use colors to distinguish BOINC projects should use 15 [http://boinc.netsoft-online.com/e107_plugins/forum/forum_viewtopic.php?3 these colors]. 11 16 12 17 BOINC provides a flexible architecture for distributing statistics data, with the goal of enabling new display applications. … … 20 25 Each BOINC project provides data in two forms: 21 26 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. 24 31 25 32 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. 33 Applications should access these data sources as infrequently as possible, 34 to avoid imposing unnecessary load on project servers. 35 For example, a Web RPCs to get a particular participant's data should made at most once per hour. 27 36 28 37 == 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: 38 A '''data aggregator''' is a service that collects XML files from several projects, 39 and computes the totals for participants and hosts (based on [CrossProjectId cross-project IDs]) across these projects. 40 This aggregate data is then exported in two ways: 30 41 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=???? 33 48 34 Application developers are encouraged to concentrate on aggregate rather than per-project data. This will encourage participants to join multiple projects. 49 Application developers are encouraged to concentrate on aggregate rather than per-project data. 50 This will encourage participants to join multiple projects. 35 51 36 52 == Code examples == #code-examples 37 53 38 54 Developing 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 55 The code for [http://boinc.netsoft-online.com/ BOINC Combined Stats], 56 a web site/service that provides per-project and aggregate data, can be downloaded via git using 40 57 {{{ 41 58 git clone git://boinc.berkeley.edu/boinc-combined-stats.git … … 45 62 46 63 == 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: 64 BOINC updates 'recent average credit' (RAC) only when new credit is granted. 65 Interfaces that export RAC also export that time at which it was last updated. 66 To obtain the current value of RAC, 67 you must 'decay' it based on the time that has elapsed since it was updated: 48 68 49 69 {{{ … … 62 82 If you don't apply this decay, inactive entities will have incorrectly high RAC. 63 83 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]. 84 PHP code for the decay function can be found in [source:boinc/html/inc/credit.inc html/inc/credit.inc] 85 and [source:boinc/html/inc/host.inc html/inc/host.inc].
