For a full list of contributors, see "credits.txt".
The full license can be read in "license.txt".
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
See the GNU General Public License for more details.
Contact: Dokeos, 181 rue Royale, B-1000 Brussels, Belgium, info@dokeos.com
==============================================================================
*/
/**
==============================================================================
* This class provides some functions for statistics
* @package dokeos.statistics
==============================================================================
*/
class Statistics
{
/**
* Converts a number of bytes in a formatted string
* @param int $size
* @return string Formatted file size
*/
function make_size_string($size) {
if ($size < pow(2,10)) return $size." bytes";
if ($size >= pow(2,10) && $size < pow(2,20)) return round($size / pow(2,10), 0)." KB";
if ($size >= pow(2,20) && $size < pow(2,30)) return round($size / pow(2,20), 1)." MB";
if ($size > pow(2,30)) return round($size / pow(2,30), 2)." GB";
}
/**
* Count courses
* @param bool $curriculum True if only curriculum-courses should be counted
* @param $string faculty Code of a faculty. Default: count all courses.
* @return int Number of courses counted
*/
function count_courses($curriculum, $faculty = NULL, $count_invisible_courses = true)
{
$course_table = Database :: get_main_table(MAIN_COURSE_TABLE);
$sql = "SELECT COUNT(*) AS number FROM ".$course_table." ";
if ($curriculum)
{
$sql .= "WHERE visual_code NOT LIKE 'ALG%'";
}
else
{
$sql .= "WHERE visual_code LIKE 'ALG%'";
}
if (isset ($faculty))
{
$sql .= " AND category_code = '$faculty'";
}
$res = api_sql_query($sql, __FILE__, __LINE__);
$obj = mysql_fetch_object($res);
return $obj->number;
}
/**
* Count users
* @param int $status COURSEMANAGER or STUDENT
* @param $string faculty Code of a faculty. Default: count all students.
* @return int Number of students counted
*/
function count_users($status, $faculty = NULL, $count_invisible_courses = true)
{
$course_user_table = Database :: get_main_table(MAIN_COURSE_USER_TABLE);
$course_table = Database :: get_main_table(MAIN_COURSE_TABLE);
$sql = "SELECT COUNT(DISTINCT(cu.user_id)) AS number FROM $course_user_table cu, $course_table c WHERE cu.status = $status AND cu.course_code = c.code";
if (isset ($faculty))
{
$sql = "SELECT COUNT(DISTINCT(cu.user_id)) AS number FROM $course_user_table cu, $course_table c WHERE cu.status = $status AND c.code = cu.course_code AND c.category_code = '$faculty'";
}
$res = api_sql_query($sql, __FILE__, __LINE__);
$obj = mysql_fetch_object($res);
return $obj->number;
}
/**
* Get all faculties
* @return array All faculties (code => name)
*/
function get_faculties()
{
$category_table = Database :: get_main_table(MAIN_CATEGORY_TABLE);
$sql = "SELECT * FROM $category_table ORDER BY tree_pos";
$res = api_sql_query($sql, __FILE__, __LINE__);
$faculties = array ();
while ($fac = mysql_fetch_object($res))
{
$faculties[$fac->code] = $fac->name;
}
return $faculties;
}
/**
* Rescale data
* @param array $data The data that should be rescaled
* @param int $max The maximum value in the rescaled data (default = 500);
* @return array The rescaled data, same key as $data
*/
function rescale($data, $max = 500)
{
$data_max = 1;
foreach ($data as $index => $value)
{
$data_max = ($data_max < $value ? $value : $data_max);
}
reset($data);
$result = array ();
$delta = $max / $data_max;
foreach ($data as $index => $value)
{
$result[$index] = (int) round($value * $delta);
}
return $result;
}
/**
* Show statistics
* @param string $title The title
* @param array $stats
* @param bool $show_total
* @param bool $is_file_size
*/
function print_stats($title, $stats, $show_total = true, $is_file_size = false)
{
$total = 0;
$data = Statistics::rescale($stats);
echo '
