|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
declare(strict_types=1); |
|
4
|
|
|
|
|
5
|
|
|
namespace Phpml\Classification\DecisionTree; |
|
6
|
|
|
|
|
7
|
|
|
use Phpml\Math\Comparison; |
|
8
|
|
|
|
|
9
|
|
|
class DecisionTreeLeaf |
|
10
|
|
|
{ |
|
11
|
|
|
/** |
|
12
|
|
|
* @var string|int |
|
13
|
|
|
*/ |
|
14
|
|
|
public $value; |
|
15
|
|
|
|
|
16
|
|
|
/** |
|
17
|
|
|
* @var float |
|
18
|
|
|
*/ |
|
19
|
|
|
public $numericValue; |
|
20
|
|
|
|
|
21
|
|
|
/** |
|
22
|
|
|
* @var string |
|
23
|
|
|
*/ |
|
24
|
|
|
public $operator; |
|
25
|
|
|
|
|
26
|
|
|
/** |
|
27
|
|
|
* @var int |
|
28
|
|
|
*/ |
|
29
|
|
|
public $columnIndex; |
|
30
|
|
|
|
|
31
|
|
|
/** |
|
32
|
|
|
* @var DecisionTreeLeaf|null |
|
33
|
|
|
*/ |
|
34
|
|
|
public $leftLeaf; |
|
35
|
|
|
|
|
36
|
|
|
/** |
|
37
|
|
|
* @var DecisionTreeLeaf|null |
|
38
|
|
|
*/ |
|
39
|
|
|
public $rightLeaf; |
|
40
|
|
|
|
|
41
|
|
|
/** |
|
42
|
|
|
* @var array |
|
43
|
|
|
*/ |
|
44
|
|
|
public $records = []; |
|
45
|
|
|
|
|
46
|
|
|
/** |
|
47
|
|
|
* Class value represented by the leaf, this value is non-empty |
|
48
|
|
|
* only for terminal leaves |
|
49
|
|
|
* |
|
50
|
|
|
* @var string |
|
51
|
|
|
*/ |
|
52
|
|
|
public $classValue = ''; |
|
53
|
|
|
|
|
54
|
|
|
/** |
|
55
|
|
|
* @var bool |
|
56
|
|
|
*/ |
|
57
|
|
|
public $isTerminal = false; |
|
58
|
|
|
|
|
59
|
|
|
/** |
|
60
|
|
|
* @var bool |
|
61
|
|
|
*/ |
|
62
|
|
|
public $isContinuous = false; |
|
63
|
|
|
|
|
64
|
|
|
/** |
|
65
|
|
|
* @var float |
|
66
|
|
|
*/ |
|
67
|
|
|
public $giniIndex = 0; |
|
68
|
|
|
|
|
69
|
|
|
/** |
|
70
|
|
|
* @var int |
|
71
|
|
|
*/ |
|
72
|
|
|
public $level = 0; |
|
73
|
|
|
|
|
74
|
|
|
/** |
|
75
|
|
|
* HTML representation of the tree without column names |
|
76
|
|
|
*/ |
|
77
|
|
|
public function __toString(): string |
|
78
|
|
|
{ |
|
79
|
|
|
return $this->getHTML(); |
|
80
|
|
|
} |
|
81
|
|
|
|
|
82
|
|
|
public function evaluate(array $record): bool |
|
83
|
|
|
{ |
|
84
|
|
|
$recordField = $record[$this->columnIndex]; |
|
85
|
|
|
|
|
86
|
|
|
if ($this->isContinuous) { |
|
87
|
|
|
return Comparison::compare((string) $recordField, $this->numericValue, $this->operator); |
|
88
|
|
|
} |
|
89
|
|
|
|
|
90
|
|
|
return $recordField == $this->value; |
|
91
|
|
|
} |
|
92
|
|
|
|
|
93
|
|
|
/** |
|
94
|
|
|
* Returns Mean Decrease Impurity (MDI) in the node. |
|
95
|
|
|
* For terminal nodes, this value is equal to 0 |
|
96
|
|
|
*/ |
|
97
|
|
|
public function getNodeImpurityDecrease(int $parentRecordCount): float |
|
98
|
|
|
{ |
|
99
|
|
|
if ($this->isTerminal) { |
|
100
|
|
|
return 0.0; |
|
101
|
|
|
} |
|
102
|
|
|
|
|
103
|
|
|
$nodeSampleCount = (float) count($this->records); |
|
104
|
|
|
$iT = $this->giniIndex; |
|
105
|
|
|
|
|
106
|
|
|
if ($this->leftLeaf !== null) { |
|
107
|
|
|
$pL = count($this->leftLeaf->records) / $nodeSampleCount; |
|
108
|
|
|
$iT -= $pL * $this->leftLeaf->giniIndex; |
|
109
|
|
|
} |
|
110
|
|
|
|
|
111
|
|
|
if ($this->rightLeaf !== null) { |
|
112
|
|
|
$pR = count($this->rightLeaf->records) / $nodeSampleCount; |
|
113
|
|
|
$iT -= $pR * $this->rightLeaf->giniIndex; |
|
114
|
|
|
} |
|
115
|
|
|
|
|
116
|
|
|
return $iT * $nodeSampleCount / $parentRecordCount; |
|
117
|
|
|
} |
|
118
|
|
|
|
|
119
|
|
|
/** |
|
120
|
|
|
* Returns HTML representation of the node including children nodes |
|
121
|
|
|
*/ |
|
122
|
|
|
public function getHTML(?array $columnNames = null): string |
|
123
|
|
|
{ |
|
124
|
|
|
if ($this->isTerminal) { |
|
125
|
|
|
$value = "<b>${this}->classValue</b>"; |
|
126
|
|
|
} else { |
|
127
|
|
|
$value = $this->value; |
|
128
|
|
|
if ($columnNames !== null) { |
|
129
|
|
|
$col = $columnNames[$this->columnIndex]; |
|
130
|
|
|
} else { |
|
131
|
|
|
$col = "col_$this->columnIndex"; |
|
132
|
|
|
} |
|
133
|
|
|
|
|
134
|
|
|
if ((bool) preg_match('/^[<>=]{1,2}/', (string) $value) === false) { |
|
135
|
|
|
$value = "=${value}"; |
|
136
|
|
|
} |
|
137
|
|
|
|
|
138
|
|
|
$value = "<b>${col} ${value}</b><br>Gini: ".number_format($this->giniIndex, 2); |
|
139
|
|
|
} |
|
140
|
|
|
|
|
141
|
|
|
$str = "<table ><tr><td colspan=3 align=center style='border:1px solid;'>${value}</td></tr>"; |
|
142
|
|
|
|
|
143
|
|
|
if ($this->leftLeaf !== null || $this->rightLeaf !== null) { |
|
144
|
|
|
$str .= '<tr>'; |
|
145
|
|
|
if ($this->leftLeaf !== null) { |
|
146
|
|
|
$str .= '<td valign=top><b>| Yes</b><br>'.$this->leftLeaf->getHTML($columnNames).'</td>'; |
|
147
|
|
|
} else { |
|
148
|
|
|
$str .= '<td></td>'; |
|
149
|
|
|
} |
|
150
|
|
|
|
|
151
|
|
|
$str .= '<td> </td>'; |
|
152
|
|
|
if ($this->rightLeaf !== null) { |
|
153
|
|
|
$str .= '<td valign=top align=right><b>No |</b><br>'.$this->rightLeaf->getHTML($columnNames).'</td>'; |
|
154
|
|
|
} else { |
|
155
|
|
|
$str .= '<td></td>'; |
|
156
|
|
|
} |
|
157
|
|
|
|
|
158
|
|
|
$str .= '</tr>'; |
|
159
|
|
|
} |
|
160
|
|
|
|
|
161
|
|
|
$str .= '</table>'; |
|
162
|
|
|
|
|
163
|
|
|
return $str; |
|
164
|
|
|
} |
|
165
|
|
|
} |
|
166
|
|
|
|