Skip to content

Commit 339f1c7

Browse files
committed
fix interestingness measure docstrings
1 parent 3c6b212 commit 339f1c7

File tree

1 file changed

+15
-20
lines changed

1 file changed

+15
-20
lines changed

src/niaarm/rule.py

Lines changed: 15 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ class Rule:
1515
Attributes:
1616
cls.metrics (tuple[str]): List of all available interestingness measures.
1717
support: Support is defined on an itemset as the proportion of transactions
18-
that contain the attribute :math:`X`.
18+
that contain the attribute :math:`X`.
1919
2020
:math:`supp(X) = \frac{n_{X}}{|D|},`
2121
@@ -32,7 +32,7 @@ class Rule:
3232
Interest Measures for Association Rules,
3333
2015, URL: https://mhahsler.github.io/arules/docs/measures
3434
confidence: Confidence of the rule, defined as the proportion of transactions
35-
that contain
35+
that contain
3636
the consequent in the set of transactions that contain the antecedent. This
3737
proportion is an estimate
3838
of the probability of seeing the consequent, if the antecedent is present in
@@ -46,8 +46,8 @@ class Rule:
4646
Interest Measures for Association Rules,
4747
2015, URL: https://mhahsler.github.io/arules/docs/measures
4848
lift: Lift measures how many times more often the antecedent and the
49-
consequent Y
50-
occur together than expected if they were statistically independent.
49+
consequent Y occur together than expected if they were statistically
50+
independent.
5151
5252
:math:`lift(X \implies Y) = \frac{conf(X \implies Y)}{supp(Y)}`
5353
@@ -57,10 +57,8 @@ class Rule:
5757
Interest Measures for Association Rules,
5858
2015, URL: https://mhahsler.github.io/arules/docs/measures
5959
coverage: Coverage, also known as antecedent support, is an estimate of the
60-
probability that
61-
the rule applies to a randomly selected transaction. It is the proportion of
62-
transactions
63-
that contain the antecedent.
60+
probability that the rule applies to a randomly selected transaction.
61+
It is the proportion of transactions that contain the antecedent.
6462
6563
:math:`cover(X \implies Y) = supp(X)`
6664
@@ -79,8 +77,7 @@ class Rule:
7977
Interest Measures for Association Rules,
8078
2015, URL: https://mhahsler.github.io/arules/docs/measures
8179
conviction: Conviction can be interpreted as the ratio of the expected
82-
frequency that the antecedent occurs without
83-
the consequent.
80+
frequency that the antecedent occurs without the consequent.
8481
8582
:math:`conv(X \implies Y) = \frac{1 - supp(Y)}{1 - conf(X \implies Y)}`
8683
@@ -91,8 +88,7 @@ class Rule:
9188
Interest Measures for Association Rules,
9289
2015, URL: https://mhahsler.github.io/arules/docs/measures
9390
inclusion: Inclusion is defined as the ratio between the number of attributes
94-
of the rule
95-
and all attributes in the database.
91+
of the rule and all attributes in the database.
9692
9793
:math:`inclusion(X \implies Y) = \frac{|X \cup Y|}{m},`
9894
@@ -108,7 +104,7 @@ class Rule:
108104
Computing and Optimization. ICO 2020. Advances in
109105
Intelligent Systems and Computing, vol 1324. Springer, Cham.
110106
amplitude: Amplitude measures the quality of a rule, preferring attributes
111-
with smaller intervals.
107+
with smaller intervals.
112108
113109
:math:`ampl(X \implies Y) = 1 - \frac{1}{n}\sum_{k = 1}^{n}{\frac{Ub_k -
114110
Lb_k}{max(o_k) - min(o_k)}},`
@@ -143,8 +139,7 @@ class Rule:
143139
intelligence-based algorithms for numerical
144140
association rule mining. arXiv preprint arXiv:2010.15524 (2020).
145141
comprehensibility: Comprehensibility of the rule. Rules with fewer attributes
146-
in the consequent are more
147-
comprehensible.
142+
in the consequent are more comprehensible.
148143
149144
:math:`comp(X \implies Y) = \frac{log(1 + |Y|)}{log(1 + |X \cup Y|)}`
150145
@@ -170,7 +165,7 @@ class Rule:
170165
Conference (UBMYK), 2019, pp. 1-6,
171166
doi: 10.1109/UBMYK48245.2019.8965539.
172167
yulesq: The Yule's Q metric represents the correlation between two possibly
173-
related dichotomous events.
168+
related dichotomous events.
174169
175170
:math:`yulesq(X \implies Y) =
176171
\frac{supp(X \implies Y)supp(\neg X \implies \neg Y) - supp(X \implies \neg
@@ -188,8 +183,8 @@ class Rule:
188183
Conference (UBMYK), 2019, pp. 1-6,
189184
doi: 10.1109/UBMYK48245.2019.8965539.
190185
zhang: Zheng's metric measures the strength of association (positive or
191-
negative) between the antecedent and consequent, taking into account both
192-
their co-occurrence and non-co-occurrence.
186+
negative) between the antecedent and consequent, taking into account both
187+
their co-occurrence and non-co-occurrence.
193188
194189
:math:`zhang(X \implies Y) =
195190
\frac{conf(X \implies Y) - conf(\neg X \implies Y)}{max\{conf(X \implies Y),
@@ -204,8 +199,8 @@ class Rule:
204199
Applications, 2000, pp. 245–256. doi: 10.1007/3-540-45571-X_31.
205200
206201
leverage: difference between the frequency of antecedent and the consequent
207-
appearing together and the expected
208-
frequency of them appearing separately based on their individual support
202+
appearing together and the expected frequency of them appearing separately
203+
based on their individual support
209204
210205
:math:`leverage(X \implies Y) = support(X \implies Y) - (support(X) \times
211206
support(Y))`

0 commit comments

Comments
 (0)