CID3
This is a full-featured Decision Trees and Random Forests learner. It can save trees or forests to disk for later use. It is possible to query trees and Random Forests and to fill out an unlabeled file with the predicted classes. Documentation is not yet available, although the program options can be shown with command:
% java -jar cid3.jar -h
usage: java -jar cid3.jar
-a,--analysis <name> show causal analysis report
-c,--criteria <name> input criteria: c[Certainty], e[Entropy], g[Gini]
-f,--file <name> input file
-h,--help print this message
-o,--output <name> output file
-p,--partition partition train/test data
-q,--query <type> query model, enter: t[Tree] or r[Random forest]
-r,--forest <amount> create random forest, enter # of trees
-s,--save save tree/random forest
-t,--threads <amount> maximum number of threads (default is 500)
-v,--validation create 10-fold cross-validation
-ver,--version version
List of features
- It uses a new Certainty formula as splitting criteria.
- Provides causal analysis report, which shows how some attribute values cause a particular classification.
- Creates full trees, showing error rates for train and test data, attribute importance, causes and false positives/negatives.
- If no test data is provided, it can split the train dataset in 80% for training and 20% for testing.
- Creates random forests, showing error rates for train and test data, attribute importance, causes and false positives/negatives. Random forests are created in parallel, so it is very fast.
- Creates 10 Fold Cross-Validation for trees and random forests, showing error rates, mean and Standard Error and false positives/negatives. Cross-Validation folds are created in parallel.
- Saves trees and random forests to disk in a compressed file. (E.g. model.tree, model.forest)
- Query trees and random forest from saved files. Queries can contain missing values, just enter the character: “?”.
- Make predictions and fill out cases files with those predictions, either from single trees or random forests.
- Missing values imputation for train and test data is implemented. Continuous attributes are imputed as the mean value. Discrete attributes are imputed as MODE, which selects the value that is most frequent.
- Ignoring attributes is implemented. In the .names file just set the attribute type as: ignore.
- Three different splitting criteria can be used: Certainty, Entropy and Gini. If no criteria is invoked then Certainty will be used.
Example run with titanic dataset
[email protected] datasets % java -jar cid3.jar -f titanic
CID3 [Version 1.1] Saturday October 30, 2021 06:34:11 AM
------------------
[ ✓ ] Read data: 891 cases for training. (10 attributes)
[ ✓ ] Decision tree created.
Rules: 276
Nodes: 514
Importance Cause Attribute Name
---------- ----- --------------
0.57 yes ············ Sex
0.36 yes ········· Pclass
0.30 yes ··········· Fare
0.28 yes ······· Embarked
0.27 yes ·········· SibSp
0.26 yes ·········· Parch
0.23 no ············ Age
[==== TRAIN DATA ====]
Correct guesses: 875
Incorrect guesses: 16 (1.8%)
# Of Cases False Pos False Neg Class
---------- --------- --------- -----
549 14 2 ····· 0
342 2 14 ····· 1
Time: 0:00:00
Requirements
CID3 requires JDK 15 or higher.
The data format is similar to that of C4.5 and C5.0. The data file format is CSV, and it could be split in two separated files, like: titanic.data and titanic.test. The class attribute column must be the last column of the file. The other necessary file is the "names" file, which should be named like: titanic.names, and it contains the names and types of the attributes. The first line is the class attribute possible values. This line could be left empty with just a dot(.) Below is an example of the titanic.names file:
0,1.
PassengerId: ignore.
Pclass: 1,2,3.
Sex : male,female.
Age: continuous.
SibSp: discrete.
Parch: discrete.
Ticket: ignore.
Fare: continuous.
Cabin: ignore.
Embarked: discrete.
Example of causal analysis
% java -jar cid3.jar -f adult -a education
From this example we can see that attribute "education" is a cause, which is based on the certainty-raising inequality. Once we know that it is a cause we then compare the causal certainties of its values. When it's value is "Doctorate" it causes the earnings to be greater than $50,000, with a probability of 0.73. A paper will soon be published with all the formulas used to calculate the Certainty for splitting the nodes and the certainty-raising inequality, used for causal analysis.
Importance Cause Attribute Name
---------- ----- --------------
0.56 yes ······ education
Report of causal certainties
----------------------------
[ Attribute: education ]
1st-4th --> <=50K (0.97)
5th-6th --> <=50K (0.95)
7th-8th --> <=50K (0.94)
9th --> <=50K (0.95)
10th --> <=50K (0.94)
11th --> <=50K (0.95)
12th --> <=50K (0.93)
Assoc-acdm --> <=50K (0.74)
Assoc-voc --> <=50K (0.75)
Bachelors --> Non cause.
Doctorate --> >50K (0.73)
HS-grad --> <=50K (0.84)
Masters --> >50K (0.55)
Preschool --> <=50K (0.99)
Prof-school --> >50K (0.74)
Some-college --> <=50K (0.81)
30 Nov 18, 2022
5 Jan 26, 2022
2.5k Jan 8, 2023
1 Dec 25, 2021
150 Dec 14, 2022
1 Jan 8, 2022
28 Nov 25, 2022
35 Nov 16, 2022
212 Dec 30, 2022
2k Jan 09, 2023
116 Jan 04, 2023
4 Aug 20, 2021
245 Jan 01, 2023
7 Aug 02, 2022
18 Nov 18, 2022
41 Dec 19, 2022
92 Dec 21, 2022
117 Nov 05, 2022
221 Dec 26, 2022
2 Dec 20, 2021
16 Dec 08, 2022
2 Oct 12, 2022
3 Sep 30, 2022
5 Jul 18, 2022
114 Nov 30, 2022
5 Sep 28, 2022
232 Dec 31, 2022
46 Jan 01, 2023
25 Nov 08, 2022