Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.3.x will end 7 October 2024 (12 months).
  • Bug fixes for security issues in 4.3.x will end 21 April 2025 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.2.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle 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 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Unit tests for grading evaluation method "best"
 *
 * @package    workshopeval_best
< * @category phpunit
> * @category test
* @copyright 2009 David Mudrak <david.mudrak@gmail.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */
> namespace workshopeval_best; > defined('MOODLE_INTERNAL') || die(); > use workshop; > use workshop_best_evaluation;
// Include the code to test global $CFG; require_once($CFG->dirroot . '/mod/workshop/locallib.php'); require_once($CFG->dirroot . '/mod/workshop/eval/best/lib.php'); require_once($CFG->libdir . '/gradelib.php');
< < class workshopeval_best_evaluation_testcase extends advanced_testcase {
> /** > * Unit tests for grading evaluation lib.php > */ > class lib_test extends \advanced_testcase {
/** workshop instance emulation */ protected $workshop; /** instance of the grading evaluator being tested */ protected $evaluator; /** * Setup testing environment */
< protected function setUp() {
> protected function setUp(): void {
parent::setUp(); $this->resetAfterTest(); $this->setAdminUser(); $course = $this->getDataGenerator()->create_course(); $workshop = $this->getDataGenerator()->create_module('workshop', array('evaluation' => 'best', 'course' => $course)); $cm = get_fast_modinfo($course)->instances['workshop'][$workshop->id]; $this->workshop = new workshop($workshop, $cm, $course); $this->evaluator = new testable_workshop_best_evaluation($this->workshop); }
< protected function tearDown() {
> protected function tearDown(): void {
$this->workshop = null; $this->evaluator = null; parent::tearDown(); } public function test_normalize_grades() { // fixture set-up $assessments = array(); $assessments[1] = (object)array( 'dimgrades' => array(3 => 1.0000, 4 => 13.42300), ); $assessments[3] = (object)array( 'dimgrades' => array(3 => 2.0000, 4 => 19.1000), ); $assessments[7] = (object)array( 'dimgrades' => array(3 => 3.0000, 4 => 0.00000), ); $diminfo = array( 3 => (object)array('min' => 1, 'max' => 3), 4 => (object)array('min' => 0, 'max' => 20), ); // exercise SUT $norm = $this->evaluator->normalize_grades($assessments, $diminfo); // validate $this->assertEquals(gettype($norm), 'array'); // the following grades from a scale $this->assertEquals($norm[1]->dimgrades[3], 0); $this->assertEquals($norm[3]->dimgrades[3], 50); $this->assertEquals($norm[7]->dimgrades[3], 100); // the following grades from an interval 0 - 20 $this->assertEquals($norm[1]->dimgrades[4], grade_floatval(13.423 / 20 * 100)); $this->assertEquals($norm[3]->dimgrades[4], grade_floatval(19.1 / 20 * 100)); $this->assertEquals($norm[7]->dimgrades[4], 0); } public function test_normalize_grades_max_equals_min() { // fixture set-up $assessments = array(); $assessments[1] = (object)array( 'dimgrades' => array(3 => 100.0000), ); $diminfo = array( 3 => (object)array('min' => 100, 'max' => 100), ); // exercise SUT $norm = $this->evaluator->normalize_grades($assessments, $diminfo); // validate $this->assertEquals(gettype($norm), 'array'); $this->assertEquals($norm[1]->dimgrades[3], 100); } public function test_average_assessment_same_weights() { // fixture set-up $assessments = array(); $assessments[18] = (object)array( 'weight' => 1, 'dimgrades' => array(1 => 50, 2 => 33.33333), ); $assessments[16] = (object)array( 'weight' => 1, 'dimgrades' => array(1 => 0, 2 => 66.66667), ); // exercise SUT $average = $this->evaluator->average_assessment($assessments); // validate $this->assertEquals(gettype($average->dimgrades), 'array'); $this->assertEquals(grade_floatval($average->dimgrades[1]), grade_floatval(25)); $this->assertEquals(grade_floatval($average->dimgrades[2]), grade_floatval(50)); } public function test_average_assessment_different_weights() { // fixture set-up $assessments = array(); $assessments[11] = (object)array( 'weight' => 1, 'dimgrades' => array(3 => 10.0, 4 => 13.4, 5 => 95.0), ); $assessments[13] = (object)array( 'weight' => 3, 'dimgrades' => array(3 => 11.0, 4 => 10.1, 5 => 92.0), ); $assessments[17] = (object)array( 'weight' => 1, 'dimgrades' => array(3 => 11.0, 4 => 8.1, 5 => 88.0), ); // exercise SUT $average = $this->evaluator->average_assessment($assessments); // validate $this->assertEquals(gettype($average->dimgrades), 'array'); $this->assertEquals(grade_floatval($average->dimgrades[3]), grade_floatval((10.0 + 11.0*3 + 11.0)/5)); $this->assertEquals(grade_floatval($average->dimgrades[4]), grade_floatval((13.4 + 10.1*3 + 8.1)/5)); $this->assertEquals(grade_floatval($average->dimgrades[5]), grade_floatval((95.0 + 92.0*3 + 88.0)/5)); } public function test_average_assessment_noweight() { // fixture set-up $assessments = array(); $assessments[11] = (object)array( 'weight' => 0, 'dimgrades' => array(3 => 10.0, 4 => 13.4, 5 => 95.0), ); $assessments[17] = (object)array( 'weight' => 0, 'dimgrades' => array(3 => 11.0, 4 => 8.1, 5 => 88.0), ); // exercise SUT $average = $this->evaluator->average_assessment($assessments); // validate $this->assertNull($average); } public function test_weighted_variance() { // fixture set-up $assessments[11] = (object)array( 'weight' => 1, 'dimgrades' => array(3 => 11, 4 => 2), ); $assessments[13] = (object)array( 'weight' => 3, 'dimgrades' => array(3 => 11, 4 => 4), ); $assessments[17] = (object)array( 'weight' => 2, 'dimgrades' => array(3 => 11, 4 => 5), ); $assessments[20] = (object)array( 'weight' => 1, 'dimgrades' => array(3 => 11, 4 => 7), ); $assessments[25] = (object)array( 'weight' => 1, 'dimgrades' => array(3 => 11, 4 => 9), ); // exercise SUT $variance = $this->evaluator->weighted_variance($assessments); // validate // dimension [3] have all the grades equal to 11 $this->assertEquals($variance[3], 0); // dimension [4] represents data 2, 4, 4, 4, 5, 5, 7, 9 having stdev=2 (stdev is sqrt of variance) $this->assertEquals($variance[4], 4); } public function test_assessments_distance_zero() { // fixture set-up $diminfo = array( 3 => (object)array('weight' => 1, 'min' => 0, 'max' => 100, 'variance' => 12.34567), 4 => (object)array('weight' => 1, 'min' => 1, 'max' => 5, 'variance' => 98.76543), ); $assessment1 = (object)array('dimgrades' => array(3 => 15, 4 => 2)); $assessment2 = (object)array('dimgrades' => array(3 => 15, 4 => 2)); $settings = (object)array('comparison' => 5); // exercise SUT and validate $this->assertEquals($this->evaluator->assessments_distance($assessment1, $assessment2, $diminfo, $settings), 0); } public function test_assessments_distance_equals() { /* // fixture set-up $diminfo = array( 3 => (object)array('weight' => 1, 'min' => 0, 'max' => 100, 'variance' => 12.34567), 4 => (object)array('weight' => 1, 'min' => 0, 'max' => 100, 'variance' => 12.34567), ); $assessment1 = (object)array('dimgrades' => array(3 => 25, 4 => 4)); $assessment2 = (object)array('dimgrades' => array(3 => 75, 4 => 2)); $referential = (object)array('dimgrades' => array(3 => 50, 4 => 3)); $settings = (object)array('comparison' => 5); // exercise SUT and validate $this->assertEquals($this->evaluator->assessments_distance($assessment1, $referential, $diminfo, $settings), $this->evaluator->assessments_distance($assessment2, $referential, $diminfo, $settings)); */ // fixture set-up $diminfo = array( 1 => (object)array('min' => 0, 'max' => 2, 'weight' => 1, 'variance' => 625), 2 => (object)array('min' => 0, 'max' => 3, 'weight' => 1, 'variance' => 277.7778888889), ); $assessment1 = (object)array('dimgrades' => array(1 => 0, 2 => 66.66667)); $assessment2 = (object)array('dimgrades' => array(1 => 50, 2 => 33.33333)); $referential = (object)array('dimgrades' => array(1 => 25, 2 => 50)); $settings = (object)array('comparison' => 9); // exercise SUT and validate $this->assertEquals($this->evaluator->assessments_distance($assessment1, $referential, $diminfo, $settings), $this->evaluator->assessments_distance($assessment2, $referential, $diminfo, $settings)); } public function test_assessments_distance_zero_variance() { // Fixture set-up: an assessment form of the strategy "Number of errors", // three assertions, same weight. $diminfo = array( 1 => (object)array('min' => 0, 'max' => 1, 'weight' => 1), 2 => (object)array('min' => 0, 'max' => 1, 'weight' => 1), 3 => (object)array('min' => 0, 'max' => 1, 'weight' => 1), ); // Simulate structure returned by {@link workshop_best_evaluation::prepare_data_from_recordset()} $assessments = array( // The first assessment has weight 0 and the assessment was No, No, No. 10 => (object)array( 'assessmentid' => 10, 'weight' => 0, 'reviewerid' => 56, 'gradinggrade' => null, 'submissionid' => 99, 'dimgrades' => array( 1 => 0, 2 => 0, 3 => 0, ), ), // The second assessment has weight 1 and assessments was Yes, Yes, Yes. 20 => (object)array( 'assessmentid' => 20, 'weight' => 1, 'reviewerid' => 76, 'gradinggrade' => null, 'submissionid' => 99, 'dimgrades' => array( 1 => 1, 2 => 1, 3 => 1, ), ), // The third assessment has weight 1 and assessments was Yes, Yes, Yes too. 30 => (object)array( 'assessmentid' => 30, 'weight' => 1, 'reviewerid' => 97, 'gradinggrade' => null, 'submissionid' => 99, 'dimgrades' => array( 1 => 1, 2 => 1, 3 => 1, ), ), ); // Process assessments in the same way as in the {@link workshop_best_evaluation::process_assessments()} $assessments = $this->evaluator->normalize_grades($assessments, $diminfo); $average = $this->evaluator->average_assessment($assessments); $variances = $this->evaluator->weighted_variance($assessments); foreach ($variances as $dimid => $variance) { $diminfo[$dimid]->variance = $variance; } // Simulate the chosen comparison of assessments "fair" (does not really matter here but we need something). $settings = (object)array('comparison' => 5); // Exercise SUT: for every assessment, calculate its distance from the average one. $distances = array(); foreach ($assessments as $asid => $assessment) { $distances[$asid] = $this->evaluator->assessments_distance($assessment, $average, $diminfo, $settings); } // Validate: the first assessment is far far away from the average one ... $this->assertTrue($distances[10] > 0); // ... while the two others were both picked as the referential ones. $this->assertTrue($distances[20] == 0); $this->assertTrue($distances[30] == 0); } } /** * Test subclass that makes all the protected methods we want to test public. */ class testable_workshop_best_evaluation extends workshop_best_evaluation { public function normalize_grades(array $assessments, array $diminfo) { return parent::normalize_grades($assessments, $diminfo); } public function average_assessment(array $assessments) { return parent::average_assessment($assessments); } public function weighted_variance(array $assessments) { return parent::weighted_variance($assessments); }
< public function assessments_distance(stdclass $assessment, stdclass $referential, array $diminfo, stdclass $settings) {
> public function assessments_distance(\stdClass $assessment, \stdClass $referential, array $diminfo, \stdClass $settings) {
return parent::assessments_distance($assessment, $referential, $diminfo, $settings); } }