The BNDiscretizer Class¶
| 
| 
| 
Most of the functionality of pyAgrum works only on discrete data. However data in the real world can be often continous. This class can be used to create dizcretized variables from continous data. Since this class was made for the purposes of the class BNClassifier, this class accepts data in the form of ndarrays. To transform data from a csv file to an ndarray we can use the function in BNClassifier XYfromCSV.
Creation of an instance and setting parameters¶
To create an instance of this class we need to specify the default parameters (the discretization method and the number of bins) for discretizing data. We create a discretizer which uses the EWD (Equal Width Discretization) method with 5 bins. The threshold is used for determining if a variable is already discretized. In this case, if a variable has more than 10 unique values we treat it as continous. we can use the setDiscretizationParameters method to set the discretization parameters for a specific variable
import pyAgrum.skbn as skbn
discretizer=skbn.BNDiscretizer(defaultDiscretizationMethod='uniform',defaultNumberOfBins=5,discretizationThreshold=10)
Auditing data¶
To see how certain data will be treated by the discretizer we can use the audit method.
import pandas
X = pandas.DataFrame.from_dict({
'var1': [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2, 3],
'var2': ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n'],
'var3': [1, 2, 5, 1, 2, 5, 1, 2, 5, 1, 2, 5, 1, 2],
'var4': [1.11, 2.213, 3.33, 4.23, 5.42, 6.6, 7.5, 8.9, 9.19, 10.11, 11.12, 12.21, 13.3, 14.5],
'var5': [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 1]
})
print(X)
auditDict=discretizer.audit(X)
print()
print("** audit **")
for var in auditDict:
print(f"- {var} : ")
for k,v in auditDict[var].items():
print(f" + {k} : {v}")
var1 var2 var3 var4 var5
0 1 a 1 1.110 1
1 2 b 2 2.213 2
2 3 c 5 3.330 3
3 4 d 1 4.230 4
4 5 e 2 5.420 5
5 6 f 5 6.600 6
6 7 g 1 7.500 7
7 8 h 2 8.900 8
8 9 i 5 9.190 9
9 10 j 1 10.110 10
10 11 k 2 11.120 11
11 1 l 5 12.210 12
12 2 m 1 13.300 13
13 3 n 2 14.500 1
** audit **
- var1 :
+ method : uniform
+ nbBins : 5
+ type : Continuous
- var2 :
+ method : NoDiscretization
+ values : ['a' 'b' 'c' 'd' 'e' 'f' 'g' 'h' 'i' 'j' 'k' 'l' 'm' 'n']
+ type : Discrete
- var3 :
+ method : NoDiscretization
+ values : [1 2 5]
+ type : Discrete
- var4 :
+ method : uniform
+ nbBins : 5
+ type : Continuous
- var5 :
+ method : uniform
+ nbBins : 5
+ type : Continuous
We can see that even though var1 has more unique values than var1, it is treated as a discrete variable. This is because the values of var2 are strings and therefore cannot be discretized.
Now we would like to discretized var1 using k-means, var4 using decille and we would like for var3 to stay not discretized but with all the value from 1 to 5...
discretizer=skbn.BNDiscretizer(defaultDiscretizationMethod='uniform',defaultNumberOfBins=5,discretizationThreshold=10)
discretizer.setDiscretizationParameters('var1','kmeans')
discretizer.setDiscretizationParameters('var4','quantile',10)
discretizer.setDiscretizationParameters('var3','NoDiscretization',[1,2,3,4,5])
auditDict=discretizer.audit(X)
print()
print("** audit **")
for var in auditDict:
print(f"- {var} : ")
for k,v in auditDict[var].items():
print(f" + {k} : {v}")
** audit **
- var1 :
+ method : kmeans
+ param : 5
+ type : Continuous
- var2 :
+ method : NoDiscretization
+ values : ['a' 'b' 'c' 'd' 'e' 'f' 'g' 'h' 'i' 'j' 'k' 'l' 'm' 'n']
+ type : Discrete
- var3 :
+ method : NoDiscretization
+ param : [1, 2, 3, 4, 5]
+ type : Discrete
- var4 :
+ method : quantile
+ param : 10
+ type : Continuous
- var5 :
+ method : uniform
+ nbBins : 5
+ type : Continuous
Creating variables from data¶
To create variables from data we can use the createVariable method for each column in our data matrix. This will use the parameters that we have already set to create discrete (or discretized) variables from our data.
var1=discretizer.createVariable('var1',X['var1'])
var2=discretizer.createVariable('var2',X['var2'])
var3=discretizer.createVariable('var3',X['var3'])
var4=discretizer.createVariable('var4',X['var4'])
var5=discretizer.createVariable('var5',X['var5'])
print(var1)
print(var2)
print(var3)
print(var4)
print(var5)
var1:Discretized(<(1;2.625[,[2.625;5.125[,[5.125;7.5[,[7.5;9.5[,[9.5;11)>)
var2:Labelized({a|b|c|d|e|f|g|h|i|j|k|l|m|n})
var3:Range([1,5])
var4:Discretized(<(1.11;2.5481[,[2.5481;3.87[,[3.87;5.301[,[5.301;6.78[,[6.78;8.2[,[8.2;9.132[,[9.132;10.211[,[10.211;11.556[,[11.556;12.973[,[12.973;14.5)>)
var5:Discretized(<(1;3.4[,[3.4;5.8[,[5.8;8.2[,[8.2;10.6[,[10.6;13)>)
For supervised discretization algorithms (MDLP and CAIM) the list of class labels for each datapoint is also needed.
y=[True,False,False,True,False,False,True,True,False,False,True,True,False,True]
discretizer.setDiscretizationParameters('var4','CAIM')
var4=discretizer.createVariable('var4',X['var4'],y)
print(var4)
discretizer.setDiscretizationParameters('var4','MDLP')
var4=discretizer.createVariable('var4',X['var4'],y)
print(var4)
var4:Discretized(<(1.11;10.615[,[10.615;14.5)>) var4:Discretized(<(1.11;1.6615[,[1.6615;14.5)>)
The discretizer keeps track of the number of discretized variables created by it and the number of bins used to discretize them. To reset these two numbers to 0 we can use the clear method. We can also use it to clear the specific parameteres we have set for each variable.
print(f"numberOfContinuous : {discretizer.numberOfContinuous}")
print(f"totalNumberOfBins : {discretizer.totalNumberOfBins}")
discretizer.clear()
print("\n")
print(f"numberOfContinuous : {discretizer.numberOfContinuous}")
print(f"totalNumberOfBins : {discretizer.totalNumberOfBins}")
discretizer.audit(X)
numberOfContinuous : 5 totalNumberOfBins : 24 numberOfContinuous : 0 totalNumberOfBins : 0
{'var1': {'method': 'kmeans', 'param': 5, 'type': 'Continuous'},
'var2': {'method': 'NoDiscretization',
'values': array(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
'n'], dtype=object),
'type': 'Discrete'},
'var3': {'method': 'NoDiscretization',
'param': [1, 2, 3, 4, 5],
'type': 'Discrete'},
'var4': {'method': 'MDLP', 'param': 10, 'type': 'Continuous'},
'var5': {'method': 'uniform', 'nbBins': 5, 'type': 'Continuous'}}
discretizer.clear(True)
discretizer.audit(X)
{'var1': {'method': 'uniform', 'nbBins': 5, 'type': 'Continuous'},
'var2': {'method': 'NoDiscretization',
'values': array(['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
'n'], dtype=object),
'type': 'Discrete'},
'var3': {'method': 'NoDiscretization',
'values': array([1, 2, 5], dtype=object),
'type': 'Discrete'},
'var4': {'method': 'uniform', 'nbBins': 5, 'type': 'Continuous'},
'var5': {'method': 'uniform', 'nbBins': 5, 'type': 'Continuous'}}
Using Discretizer with BNClassifier¶
import pyAgrum as gum
import pyAgrum.lib.notebook as gnb
import pyAgrum.skbn as skbn
import pandas as pd
X = pandas.DataFrame.from_dict({
'var1': [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2, 3],
'var2': ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n'],
'var3': [1, 2, 5, 1, 2, 5, 1, 2, 5, 1, 2, 5, 1, 2],
'var4': [1.11, 2.213, 3.33, 4.23, 5.42, 6.6, 7.5, 8.9, 9.19, 10.11, 11.12, 12.21, 13.3, 14.5],
'var5': [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 1]
})
Y= [1, 0, 1, 0, 0, 0, 1, 1, 1, 0, 1, 1, 0, 0]
classif=skbn.BNClassifier(learningMethod="TAN")
# by default number of bins is 5
classif.discretizer.setDiscretizationParameters('var1','kmeans')
# ... but 10 for var4
classif.discretizer.setDiscretizationParameters('var4','quantile',10)
# in the database, var3 only takes values 1,2 or 5 but 3 and 4 are also possible
classif.discretizer.setDiscretizationParameters('var3','NoDiscretization',[1,2,3,4,5])
classif.fit(X,Y)
gnb.showInference(classif.bn)
Using Discretizer with BNLearner¶
import pyAgrum as gum
import pyAgrum.lib.notebook as gnb
import pyAgrum.skbn as skbn
import pandas as pd
file_name = 'res/discretizable.csv'
data = pd.read_csv(file_name)
discretizer = skbn.BNDiscretizer(defaultDiscretizationMethod='quantile',
defaultNumberOfBins=10,
discretizationThreshold=25)
# creating a template explaining the variables proposed by the discretizer. This variables will be used by the learner
template = discretizer.discretizedBN(data)
learner = gum.BNLearner(file_name, template)
learner.useMIIC()
learner.useNMLCorrection()
bn = learner.learnBN()
gnb.showInference(bn,size="10!")