Downloading Statistics Data

From Unofficial BOINC Wiki

[edit] General

All BOINC Powered Projects can export statistics data describing Teams, Participants (uesrs), and Hosts. This data can be imported and used to produce web sites that show statistics and leaderboards for one or more BOINC Powered Projects. Examples of such sites are listed at Project Statistics.

Statistics data is exported in XML-format files. XML schemas for these files are shown in text format and a graphical representation.

NOTE:

These examples are both somewhat out of date. Just look at the actual files - they're pretty self-explanatory.

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).

The download directory contains the following files:

<tables>
    <update_time>1046220857</update_time>

    <nusers>127</nusers>
    <nteams>14</nteams>
    <nhosts>681</nhosts>
    <total_credit>1234.234</total_credit>

    <applications>
        <application>
            <name>setiathome</name>
            <results_unsent>100</results_unsent>
            <results_in_progress>1000</results_in_progress>

            <results_over>10000</results_over>
        </application>
        ...
    </applications>
</tables>

The format of the various XML elements in the output files are as follows.

Notes:

• <cpid> ('Cross-Project Identifier') is a unique identifier across multiple projects. Accounts with the same email address on different projects will have the same cross-project identifier (as long as at least one computer is attached to both accounts).
• All 'expavg_credit' values were computed at some point in the past (given by 'expavg_time'). To compute their current values, they must be scaled according to the formula given here.

[edit] Team Summary

<team>
 <id>5</id>
 <name>Broadband Reports Team Starfire</name>

 <total_credit>153402.872429</total_credit>
 <expavg_credit>503030.483254</expavg_credit>
 <expavg_time>1087542007.701900</expavg_time>
 <nusers>14</nusers>

</team>

[edit] User Summary

<user>
 <id>12</id>
 <name>John Keck</name>

 <total_credit>42698.813543</total_credit>
 <expavg_credit>117348.653646</expavg_credit>
 <expavg_time>1087542007.701900</expavg_time>
 <cpid>283472938743489759837498347</cpid>

 [ <teamid>5</teamid> ]
 [ <has_profile/> ]
</user>

[edit] Host Summary

<host>
  <id>102</id>
  <userid>3</userid>
  <total_credit>0.000000</total_credit>

  <expavg_credit>0.000000</expavg_credit>
  <expavg_time>1087542007.701900</expavg_time>
  <p_vendor>GenuineIntel</p_vendor>
  <p_model>Pentium</p_model>

  <os_name>Windows XP</os_name>
  <os_version>5.1</os_version>
  <create_time>1040170006</create_time>
  <timezone>28800</timezone>

  <ncpus>2</ncpus>
  <p_fpops>45724737.082762</p_fpops>
  <p_iops>43233895.373973</p_iops>
  <p_membw>4032258.064516</p_membw>

  <m_nbytes>670478336.000000</m_nbytes>
  <m_cache>1000000.000000</m_cache>
  <m_swap>1638260736.000000</m_swap>
  <d_total>9088008192.000000</d_total>

  <d_free>3788505088.000000</d_free>
  <n_bwup>24109.794088</n_bwup>
  <n_bwdown>57037.049858</n_bwdown>
  <avg_turnaround>465609.562145</avg_turnaround>

  <host_cpid>e129b5fa44ed8ba58e41c472822f2807</host_cpid>
</host>

NOTE: YOU CAN IGNORE THE FOLLOWING; ALL PROJECTS EXPORT THE SAME INFO NOW.

A project can decide what data to export, and how it is divided into files. This is described by a file db_dump.xml of the following form:

<boinc_db_dump_spec>

  <enumeration>
    <table>x</table>
    <filename>x</filename>
    <sort>x</sort>

    <output>
      <recs_per_file>n</recs_per_file>
      <detail/>
      <compression>x</compression>
    </output>

    ...
  </enumeration>
  ...
</boinc_db_dump_spec>

An 'enumeration' is a listing of particular table. The fields are:

   'total_credit', 'expavg_credit', or 'id'.

An 'output' is a file or set of files containing an enumeration. The fields are:

   and team records include a list of users.

[edit] UCB Source

• Downloadable statistics data