C:/xampp/htdocs/moodle/mod/quiz/report/statistics/responseanalysis.php

Go to the documentation of this file.

<?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/>.

defined('MOODLE_INTERNAL') || die();


class quiz_statistics_response_analyser {
    protected $questiondata;
    protected $loaded = false;

    public $responses = array();

    public $responseclasses = array();

    public function __construct($questiondata) {
        $this->questiondata = $questiondata;

        $this->responseclasses =
                question_bank::get_qtype($questiondata->qtype)->get_possible_responses(
                        $questiondata);
        foreach ($this->responseclasses as $subpartid => $responseclasses) {
            foreach ($responseclasses as $responseclassid => $notused) {
                $this->responses[$subpartid][$responseclassid] = array();
            }
        }
    }

    public function has_subparts() {
        return count($this->responseclasses) > 1;
    }

    public function has_response_classes() {
        foreach ($this->responseclasses as $partclasses) {
            if (count($partclasses) > 1) {
                return true;
            }
        }
        return false;
    }

    public function has_actual_responses() {
        foreach ($this->responseclasses as $subpartid => $partclasses) {
            foreach ($partclasses as $responseclassid => $modelresponse) {
                $numresponses = count($this->responses[$subpartid][$responseclassid]);
                if ($numresponses > 1) {
                    return true;
                }
                $actualresponse = key($this->responses[$subpartid][$responseclassid]);
                if ($numresponses == 1 && $actualresponse != $modelresponse->responseclass) {
                    return true;
                }
            }
        }
        return false;
    }

    public function analyse($qubaids) {
        // Load data.
        $dm = new question_engine_data_mapper();
        $questionattempts = $dm->load_attempts_at_question($this->questiondata->id, $qubaids);

        // Analyse it.
        foreach ($questionattempts as $qa) {
            $this->add_data_from_one_attempt($qa);
        }

        $this->loaded = true;
    }

    protected function add_data_from_one_attempt(question_attempt $qa) {
        $blankresponse = question_classified_response::no_response();

        $partresponses = $qa->classify_response();
        foreach ($partresponses as $subpartid => $partresponse) {
            if (!isset($this->responses[$subpartid][$partresponse->responseclassid]
                    [$partresponse->response])) {
                $resp = new stdClass();
                $resp->count = 0;
                if (!is_null($partresponse->fraction)) {
                    $resp->fraction = $partresponse->fraction;
                } else {
                    $resp->fraction = $this->responseclasses[$subpartid]
                            [$partresponse->responseclassid]->fraction;
                }

                $this->responses[$subpartid][$partresponse->responseclassid]
                        [$partresponse->response] = $resp;
            }

            $this->responses[$subpartid][$partresponse->responseclassid]
                    [$partresponse->response]->count += 1;
        }
    }

    public function load_cached($quizstatisticsid) {
        global $DB;

        $rows = $DB->get_records('quiz_question_response_stats',
                array('quizstatisticsid' => $quizstatisticsid,
                        'questionid' => $this->questiondata->id));
        if (!$rows) {
            return false;
        }

        foreach ($rows as $row) {
            $this->responses[$row->subqid][$row->aid][$row->response]->count = $row->rcount;
            $this->responses[$row->subqid][$row->aid][$row->response]->fraction = $row->credit;
        }
        $this->loaded = true;
        return true;
    }

    public function store_cached($quizstatisticsid) {
        global $DB;

        if (!$this->loaded) {
            throw new coding_exception(
                    'Question responses have not been analyised. Cannot store in the database.');
        }

        foreach ($this->responses as $subpartid => $partdata) {
            foreach ($partdata as $responseclassid => $classdata) {
                foreach ($classdata as $response => $data) {
                    $row = new stdClass();
                    $row->quizstatisticsid = $quizstatisticsid;
                    $row->questionid = $this->questiondata->id;
                    $row->subqid = $subpartid;
                    if ($responseclassid === '') {
                        $row->aid = null;
                    } else {
                        $row->aid = $responseclassid;
                    }
                    $row->response = $response;
                    $row->rcount = $data->count;
                    $row->credit = $data->fraction;
                    $DB->insert_record('quiz_question_response_stats', $row, false);
                }
            }
        }
    }
}