MDL-57791 analytics: Always absolute full class names
[moodle.git] / analytics / classes / local / indicator / binary.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Abstract binary indicator.
19  *
20  * @package   core_analytics
21  * @copyright 2017 David Monllao {@link http://www.davidmonllao.com}
22  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 namespace core_analytics\local\indicator;
27 defined('MOODLE_INTERNAL') || die();
29 /**
30  * Abstract binary indicator.
31  *
32  * @package   core_analytics
33  * @copyright 2017 David Monllao {@link http://www.davidmonllao.com}
34  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
35  */
36 abstract class binary extends discrete {
38     /**
39      * get_classes
40      *
41      * @return array
42      */
43     public static final function get_classes() {
44         // It does not really matter, all \core_analytics\local\indicator\discrete get_classes calls have been overwriten as we
45         // only need 1 column here.
46         return array(0);
47     }
49     /**
50      * get_display_value
51      *
52      * @param float $value
53      * @param string $subtype
54      * @return string
55      */
56     public function get_display_value($value, $subtype = false) {
58         // No subtypes for binary values by default.
59         if ($value == -1) {
60             return get_string('no');
61         } else if ($value == 1) {
62             return get_string('yes');
63         } else {
64             throw new \moodle_exception('errorpredictionformat', 'analytics');
65         }
66     }
68     /**
69      * get_calculation_outcome
70      *
71      * @param float $value
72      * @param string $subtype
73      * @return int
74      */
75     public function get_calculation_outcome($value, $subtype = false) {
77         // No subtypes for binary values by default.
78         if ($value == -1) {
79             return self::OUTCOME_NEGATIVE;
80         } else if ($value == 1) {
81             return self::OUTCOME_OK;
82         } else {
83             throw new \moodle_exception('errorpredictionformat', 'analytics');
84         }
85     }
87     /**
88      * get_feature_headers
89      *
90      * @return array
91      */
92     public static function get_feature_headers() {
93         // Just 1 single feature obtained from the calculated value.
94         return array('\\' . get_called_class());
95     }
97     /**
98      * to_features
99      *
100      * @param array $calculatedvalues
101      * @return array
102      */
103     protected function to_features($calculatedvalues) {
104         // Indicators with binary values have only 1 feature for indicator, here we do nothing else
105         // than converting each sample scalar value to an array of scalars with 1 element.
106         array_walk($calculatedvalues, function(&$calculatedvalue) {
107             // Just return it as an array.
108             $calculatedvalue = array($calculatedvalue);
109         });
111         return $calculatedvalues;
112     }