-i LSrSSKrSSKJr SSKJr SSKrSSKJ r SSK J r J r SSKJrJrJrJr SS KJr SS KJrJr S S KJr S rSr\"SS/SS/\"\SSSS9S/S/SS.SS9SS\R8S.Sj5r\"S/S/S.SS9S5r\"S/S/S.SS9S5r\"S/S/S.SS9S5r \"S/S/\"\SSSS9/S.SS9SS .S!j5r!\"S/S/S.SS9S"5r"\"S/S/S.SS9S#5r#\"S/S/\"\SSSS9/S.SS9SS .S$j5r$\"SS/SS//S%QS&.SS9SS'.S(j5r%\"S/S/\"1S)k5/S*.SS9S+S,.S-j5r&\"S/S/\"1S)k5/S*.SS9S+S,.S.j5r'\"S/S/S\"\"S/155/S0.SS9S/S.S1j5r(\"S2S/0SS9S35r)g)4zUtilities to evaluate the clustering performance of models. Functions named as *_score return a scalar value to maximize: the higher the better. N)log)Realsparse)_max_precision_float_dtypeget_namespace_and_device)HiddenInterval StrOptionsvalidate_params)type_of_target) check_arraycheck_consistent_length)expected_mutual_informationct[USSSS9n[USSSS9n[U5n[U5nSX24;a$SUSUS3n[R"U[5 UR S :wa[ S UR<35eUR S :wa[ S UR<35e[X5 X4$) zCheck that the labels arrays are 1D and of same dimension. Parameters ---------- labels_true : array-like of shape (n_samples,) The true labels. labels_pred : array-like of shape (n_samples,) The predicted labels. FrN) ensure_2densure_min_samplesdtype continuousz8Clustering metrics expects discrete values but received z values for label, and z values for targetrz!labels_true must be 1D: shape is z!labels_pred must be 1D: shape is ) rrwarningswarn UserWarningndim ValueErrorshaper) labels_true labels_pred type_label type_predmsgs V/var/www/html/venv/lib/python3.13/site-packages/sklearn/metrics/cluster/_supervised.pycheck_clusteringsr$s K K ,J{+I .. |29+>   c;'1+BSBSUVV1+BSBSUVVK5  ##cUS:Xa [X5$US:Xa[R"X-5$US:Xa[R"X/5$US:Xa [ X5$[ S5e)z(Return a particular mean of two numbers.min geometric arithmeticmaxzC'average_method' must be 'min', 'geometric', 'arithmetic', or 'max')r'npsqrtmeanr*r)UVaverage_methods r#_generalized_averager1Fsf1y ; &wwqu~ < 'wwv 5 1y Q  r% array-likeleft)closedboolean no_validation)rrepsrrT)prefer_skip_nested_validationF)r7rrcUbU(a [S5e[R"USS9upV[R"USS9upxURSn URSn [R "[R "URS5Xh44X4US9n U(a"U R5n U R5 U $U R5n UbX-n U $)aBuild a contingency matrix describing the relationship between labels. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,) Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,) Cluster labels to evaluate. eps : float, default=None If a float, that value is added to all values in the contingency matrix. This helps to stop NaN propagation. If ``None``, nothing is adjusted. sparse : bool, default=False If `True`, return a sparse CSR contingency matrix. If `eps` is not `None` and `sparse` is `True` will raise ValueError. .. versionadded:: 0.18 dtype : numeric type, default=np.int64 Output dtype. Ignored if `eps` is not `None`. .. versionadded:: 0.24 Returns ------- contingency : {array-like, sparse}, shape=[n_classes_true, n_classes_pred] Matrix :math:`C` such that :math:`C_{i, j}` is the number of samples in true class :math:`i` and in predicted class :math:`j`. If ``eps is None``, the dtype of this array will be integer unless set otherwise with the ``dtype`` argument. If ``eps`` is given, the dtype will be float. Will be a ``sklearn.sparse.csr_matrix`` if ``sparse=True``. Examples -------- >>> from sklearn.metrics.cluster import contingency_matrix >>> labels_true = [0, 0, 1, 1, 2, 2] >>> labels_pred = [1, 0, 2, 1, 0, 2] >>> contingency_matrix(labels_true, labels_pred) array([[1, 1, 0], [0, 1, 1], [1, 0, 1]]) z!Cannot set 'eps' when sparse=TrueT)return_inverser)rr) rr+uniquersp coo_matrixonestocsrsum_duplicatestoarray) rrr7rrclasses class_idxclusters cluster_idx n_classes n_clusters contingencys r#contingency_matrixrIVs| 6<==;tDGIIk$GH a I"J-- # $y&>?%K !'') ""$  "))+ ?%+K r%rrc[X5up[R"URS5n[ XS[RS9n[R "UR SS95n[R "UR SS95nURS-R 5n[R"S[RS9nXb- US 'URU5R 5U- US 'UR5RU5R 5U- US 'US-US - US - U- US 'U$) upPair confusion matrix arising from two clusterings. The pair confusion matrix :math:`C` computes a 2 by 2 similarity matrix between two clusterings by considering all pairs of samples and counting pairs that are assigned into the same or into different clusters under the true and predicted clusterings [1]_. Considering a pair of samples that is clustered together a positive pair, then as in binary classification the count of true negatives is :math:`C_{00}`, false negatives is :math:`C_{10}`, true positives is :math:`C_{11}` and false positives is :math:`C_{01}`. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,), dtype=integral Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,), dtype=integral Cluster labels to evaluate. Returns ------- C : ndarray of shape (2, 2), dtype=np.int64 The contingency matrix. See Also -------- sklearn.metrics.rand_score : Rand Score. sklearn.metrics.adjusted_rand_score : Adjusted Rand Score. sklearn.metrics.adjusted_mutual_info_score : Adjusted Mutual Information. References ---------- .. [1] :doi:`Hubert, L., Arabie, P. "Comparing partitions." Journal of Classification 2, 193–218 (1985). <10.1007/BF01908075>` Examples -------- Perfectly matching labelings have all non-zero entries on the diagonal regardless of actual label values: >>> from sklearn.metrics.cluster import pair_confusion_matrix >>> pair_confusion_matrix([0, 0, 1, 1], [1, 1, 0, 0]) array([[8, 0], [0, 4]]... Labelings that assign all classes members to the same clusters are complete but may be not always pure, hence penalized, and have some off-diagonal non-zero entries: >>> pair_confusion_matrix([0, 0, 1, 2], [0, 0, 1, 1]) array([[8, 2], [0, 2]]... Note that the matrix is not symmetric. rT)rrraxis)rNrN)r)rr)rr)rr)rr) r$r+int64rrIravelsumdataemptydot transpose)rr n_samplesrHn_cn_k sum_squaresCs r#pair_confusion_matrixr[s#F 1JK**1-.I%RXXK ((;???* +C ((;???* +C##Q&++-K rxx(A%AdGooc"&&(;6AdG##%))#.224{BAdGlQtW$qw.`. Parameters ---------- labels_true : array-like of shape (n_samples,), dtype=integral Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,), dtype=integral Cluster labels to evaluate. Returns ------- RI : float Similarity score between 0.0 and 1.0, inclusive, 1.0 stands for perfect match. See Also -------- adjusted_rand_score: Adjusted Rand Score. adjusted_mutual_info_score: Adjusted Mutual Information. References ---------- .. [1] :doi:`Hubert, L., Arabie, P. "Comparing partitions." Journal of Classification 2, 193–218 (1985). <10.1007/BF01908075>`. .. [2] `Wikipedia: Simple Matching Coefficient `_ .. [3] `Wikipedia: Rand Index `_ Examples -------- Perfectly matching labelings have a score of 1 even >>> from sklearn.metrics.cluster import rand_score >>> rand_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 Labelings that assign all classes members to the same clusters are complete but may not always be pure, hence penalized: >>> rand_score([0, 0, 1, 2], [0, 0, 1, 1]) 0.83 r?)r[diagonalrQfloat)rrrH numerator denominators r# rand_scorerbsRF( AK$$&**,I//#K;!#3 ( ))r%c[X5uup#upE[U5[U5[U5[U54up#pEUS:XaUS:XagSXR-XC-- -XT-XB--XS-X2---- $)u Rand index adjusted for chance. The Rand Index computes a similarity measure between two clusterings by considering all pairs of samples and counting pairs that are assigned in the same or different clusters in the predicted and true clusterings. The raw RI score is then "adjusted for chance" into the ARI score using the following scheme:: ARI = (RI - Expected_RI) / (max(RI) - Expected_RI) The adjusted Rand index is thus ensured to have a value close to 0.0 for random labeling independently of the number of clusters and samples and exactly 1.0 when the clusterings are identical (up to a permutation). The adjusted Rand index is bounded below by -0.5 for especially discordant clusterings. ARI is a symmetric measure:: adjusted_rand_score(a, b) == adjusted_rand_score(b, a) Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,), dtype=int Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,), dtype=int Cluster labels to evaluate. Returns ------- ARI : float Similarity score between -0.5 and 1.0. Random labelings have an ARI close to 0.0. 1.0 stands for perfect match. See Also -------- adjusted_mutual_info_score : Adjusted Mutual Information. References ---------- .. [Hubert1985] L. Hubert and P. Arabie, Comparing Partitions, Journal of Classification 1985 https://link.springer.com/article/10.1007%2FBF01908075 .. [Steinley2004] D. Steinley, Properties of the Hubert-Arabie adjusted Rand index, Psychological Methods 2004 .. [wk] https://en.wikipedia.org/wiki/Rand_index#Adjusted_Rand_index .. [Chacon] :doi:`Minimum adjusted Rand index for two clusterings of a given size, 2022, J. E. Chacón and A. I. Rastrojo <10.1007/s11634-022-00491-w>` Examples -------- Perfectly matching labelings have a score of 1 even >>> from sklearn.metrics.cluster import adjusted_rand_score >>> adjusted_rand_score([0, 0, 1, 1], [0, 0, 1, 1]) 1.0 >>> adjusted_rand_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 Labelings that assign all classes members to the same clusters are complete but may not always be pure, hence penalized:: >>> adjusted_rand_score([0, 0, 1, 2], [0, 0, 1, 1]) 0.57 ARI is symmetric, so labelings that have pure clusters with members coming from the same classes but unnecessary splits are penalized:: >>> adjusted_rand_score([0, 0, 1, 1], [0, 0, 1, 2]) 0.57 If classes members are completely split across different clusters, the assignment is totally incomplete, hence the ARI is very low:: >>> adjusted_rand_score([0, 0, 0, 0], [0, 1, 2, 3]) 0.0 ARI may take a negative value for especially discordant labelings that are a worse choice than the expected value of random labels:: >>> adjusted_rand_score([0, 0, 1, 1], [0, 1, 0, 1]) -0.5 See :ref:`sphx_glr_auto_examples_cluster_plot_adjusted_for_chance_measures.py` for a more detailed example. rr]g@)r[int)rrtnfpfntps r#adjusted_rand_scoreriVs|J/{HHRhrWc"gs2wB7NBB Qw27 "'BG# $RW(=RW@U(U VVr%rrbetar]rkcB[X5up[U5S:Xag[U5n[U5n[XSS9n[ SSUS9nU(aXc- OSnU(aXd- OSnXx-S:XaSn OS U-U-U-X'-U-- n [ U5[ U5[ U 54$) aCompute the homogeneity and completeness and V-Measure scores at once. Those metrics are based on normalized conditional entropy measures of the clustering labeling to evaluate given the knowledge of a Ground Truth class labels of the same samples. A clustering result satisfies homogeneity if all of its clusters contain only data points which are members of a single class. A clustering result satisfies completeness if all the data points that are members of a given class are elements of the same cluster. Both scores have positive values between 0.0 and 1.0, larger values being desirable. Those 3 metrics are independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score values in any way. V-Measure is furthermore symmetric: swapping ``labels_true`` and ``label_pred`` will give the same score. This does not hold for homogeneity and completeness. V-Measure is identical to :func:`normalized_mutual_info_score` with the arithmetic averaging method. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,) Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,) Cluster labels to evaluate. beta : float, default=1.0 Ratio of weight attributed to ``homogeneity`` vs ``completeness``. If ``beta`` is greater than 1, ``completeness`` is weighted more strongly in the calculation. If ``beta`` is less than 1, ``homogeneity`` is weighted more strongly. Returns ------- homogeneity : float Score between 0.0 and 1.0. 1.0 stands for perfectly homogeneous labeling. completeness : float Score between 0.0 and 1.0. 1.0 stands for perfectly complete labeling. v_measure : float Harmonic mean of the first two. See Also -------- homogeneity_score : Homogeneity metric of cluster labeling. completeness_score : Completeness metric of cluster labeling. v_measure_score : V-Measure (NMI with arithmetic mean option). Examples -------- >>> from sklearn.metrics import homogeneity_completeness_v_measure >>> y_true, y_pred = [0, 0, 1, 1, 2, 2], [0, 0, 1, 2, 2, 2] >>> homogeneity_completeness_v_measure(y_true, y_pred) (0.71, 0.771, 0.74) r)r]r]r]TrNrHr]r)r$lenentropyrImutual_info_scorer_) rrrk entropy_C entropy_KrHMI homogeneity completenessv_measure_scores r#"homogeneity_completeness_v_measurerysT 1JK ;1 $I $I$[dKK 4; ?B&/""SK'02#cL!S(X  !L0 2   u\2E/4J JJr%c[X5S$)aHomogeneity metric of a cluster labeling given a ground truth. A clustering result satisfies homogeneity if all of its clusters contain only data points which are members of a single class. This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is not symmetric: switching ``label_true`` with ``label_pred`` will return the :func:`completeness_score` which will be different in general. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,) Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,) Cluster labels to evaluate. Returns ------- homogeneity : float Score between 0.0 and 1.0. 1.0 stands for perfectly homogeneous labeling. See Also -------- completeness_score : Completeness metric of cluster labeling. v_measure_score : V-Measure (NMI with arithmetic mean option). References ---------- .. [1] `Andrew Rosenberg and Julia Hirschberg, 2007. V-Measure: A conditional entropy-based external cluster evaluation measure `_ Examples -------- Perfect labelings are homogeneous:: >>> from sklearn.metrics.cluster import homogeneity_score >>> homogeneity_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 Non-perfect labelings that further split classes into more clusters can be perfectly homogeneous:: >>> print("%.6f" % homogeneity_score([0, 0, 1, 1], [0, 0, 1, 2])) 1.000000 >>> print("%.6f" % homogeneity_score([0, 0, 1, 1], [0, 1, 2, 3])) 1.000000 Clusters that include samples from different classes do not make for an homogeneous labeling:: >>> print("%.6f" % homogeneity_score([0, 0, 1, 1], [0, 1, 0, 1])) 0.0... >>> print("%.6f" % homogeneity_score([0, 0, 1, 1], [0, 0, 0, 0])) 0.0... rryrJs r#homogeneity_scorer|+R .k G JJr%c[X5S$)a^Compute completeness metric of a cluster labeling given a ground truth. A clustering result satisfies completeness if all the data points that are members of a given class are elements of the same cluster. This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is not symmetric: switching ``label_true`` with ``label_pred`` will return the :func:`homogeneity_score` which will be different in general. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,) Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,) Cluster labels to evaluate. Returns ------- completeness : float Score between 0.0 and 1.0. 1.0 stands for perfectly complete labeling. See Also -------- homogeneity_score : Homogeneity metric of cluster labeling. v_measure_score : V-Measure (NMI with arithmetic mean option). References ---------- .. [1] `Andrew Rosenberg and Julia Hirschberg, 2007. V-Measure: A conditional entropy-based external cluster evaluation measure `_ Examples -------- Perfect labelings are complete:: >>> from sklearn.metrics.cluster import completeness_score >>> completeness_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 Non-perfect labelings that assign all classes members to the same clusters are still complete:: >>> print(completeness_score([0, 0, 1, 1], [0, 0, 0, 0])) 1.0 >>> print(completeness_score([0, 1, 2, 3], [0, 0, 1, 1])) 0.999 If classes members are split across different clusters, the assignment cannot be complete:: >>> print(completeness_score([0, 0, 1, 1], [0, 1, 0, 1])) 0.0 >>> print(completeness_score([0, 0, 0, 0], [0, 1, 2, 3])) 0.0 rr{rJs r#completeness_scorerwr}r%c[XUS9S$)a V-measure cluster labeling given a ground truth. This score is identical to :func:`normalized_mutual_info_score` with the ``'arithmetic'`` option for averaging. The V-measure is the harmonic mean between homogeneity and completeness:: v = (1 + beta) * homogeneity * completeness / (beta * homogeneity + completeness) This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is furthermore symmetric: switching ``label_true`` with ``label_pred`` will return the same score value. This can be useful to measure the agreement of two independent label assignments strategies on the same dataset when the real ground truth is not known. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,) Ground truth class labels to be used as a reference. labels_pred : array-like of shape (n_samples,) Cluster labels to evaluate. beta : float, default=1.0 Ratio of weight attributed to ``homogeneity`` vs ``completeness``. If ``beta`` is greater than 1, ``completeness`` is weighted more strongly in the calculation. If ``beta`` is less than 1, ``homogeneity`` is weighted more strongly. Returns ------- v_measure : float Score between 0.0 and 1.0. 1.0 stands for perfectly complete labeling. See Also -------- homogeneity_score : Homogeneity metric of cluster labeling. completeness_score : Completeness metric of cluster labeling. normalized_mutual_info_score : Normalized Mutual Information. References ---------- .. [1] `Andrew Rosenberg and Julia Hirschberg, 2007. V-Measure: A conditional entropy-based external cluster evaluation measure `_ Examples -------- Perfect labelings are both homogeneous and complete, hence have score 1.0:: >>> from sklearn.metrics.cluster import v_measure_score >>> v_measure_score([0, 0, 1, 1], [0, 0, 1, 1]) 1.0 >>> v_measure_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 Labelings that assign all classes members to the same clusters are complete but not homogeneous, hence penalized:: >>> print("%.6f" % v_measure_score([0, 0, 1, 2], [0, 0, 1, 1])) 0.8 >>> print("%.6f" % v_measure_score([0, 1, 2, 3], [0, 0, 1, 1])) 0.67 Labelings that have pure clusters with members coming from the same classes are homogeneous but un-necessary splits harm completeness and thus penalize V-measure as well:: >>> print("%.6f" % v_measure_score([0, 0, 1, 1], [0, 0, 1, 2])) 0.8 >>> print("%.6f" % v_measure_score([0, 0, 1, 1], [0, 1, 2, 3])) 0.67 If classes members are completely split across different clusters, the assignment is totally incomplete, hence the V-Measure is null:: >>> print("%.6f" % v_measure_score([0, 0, 0, 0], [0, 1, 2, 3])) 0.0 Clusters that include samples from totally different classes totally destroy the homogeneity of the labeling, hence:: >>> print("%.6f" % v_measure_score([0, 0, 1, 1], [0, 0, 0, 0])) 0.0 rlrNr{rjs r#rxrxsJ .kT RST UUr%)r2z sparse matrixN)rrrHrncUc[X5up[XSS9nO0[U/SQ[[R [R /S9n[U[R5(a[R"U5up4X#U4nO[R"U5up4nUR5n[R"URSS95n[R"URSS95nURS:XdURS:Xag [R"U5n XV- n UR!U5R#[R S S 9UR!U5R#[R S S 9-n [R"U 5*[UR55-[UR55-n X[U5- -X--n [R$"[R&"U 5[R("U R*5R,:S U 5n [/[R0"U R5S S55$) aMutual Information between two clusterings. The Mutual Information is a measure of the similarity between two labels of the same data. Where :math:`|U_i|` is the number of the samples in cluster :math:`U_i` and :math:`|V_j|` is the number of the samples in cluster :math:`V_j`, the Mutual Information between clusterings :math:`U` and :math:`V` is given as: .. math:: MI(U,V)=\sum_{i=1}^{|U|} \sum_{j=1}^{|V|} \frac{|U_i\cap V_j|}{N} \log\frac{N|U_i \cap V_j|}{|U_i||V_j|} This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is furthermore symmetric: switching :math:`U` (i.e ``label_true``) with :math:`V` (i.e. ``label_pred``) will return the same score value. This can be useful to measure the agreement of two independent label assignments strategies on the same dataset when the real ground truth is not known. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : array-like of shape (n_samples,), dtype=integral A clustering of the data into disjoint subsets, called :math:`U` in the above formula. labels_pred : array-like of shape (n_samples,), dtype=integral A clustering of the data into disjoint subsets, called :math:`V` in the above formula. contingency : {array-like, sparse matrix} of shape (n_classes_true, n_classes_pred), default=None A contingency matrix given by the :func:`~sklearn.metrics.cluster.contingency_matrix` function. If value is ``None``, it will be computed, otherwise the given value is used, with ``labels_true`` and ``labels_pred`` ignored. Returns ------- mi : float Mutual information, a non-negative value, measured in nats using the natural logarithm. See Also -------- adjusted_mutual_info_score : Adjusted against chance Mutual Information. normalized_mutual_info_score : Normalized Mutual Information. Notes ----- The logarithm used is the natural logarithm (base-e). Examples -------- >>> from sklearn.metrics import mutual_info_score >>> labels_true = [0, 1, 1, 0, 1, 0] >>> labels_pred = [0, 1, 0, 0, 1, 1] >>> mutual_info_score(labels_true, labels_pred) 0.0566 NTr)csrcsccoo) accept_sparserrrLrroFcopy)r$rIrrdr+int32rO isinstancendarraynonzeror<findrQrPsizertakeastypewhereabsfinforr7r_clip)rrrHnzxnzynz_valcontingency_sumpipjlog_contingency_nmcontingency_nmouter log_outermis r#rrrr+sT#4[#N ($O ! /"((+ +rzz**::k*#X&77;/&!oo'O +//q/) *B +//q/) *B ww!|rww!|-N GGCL  u  5 8K8K u9L9 ERVVX.RVVX>Is?/CCD  $ % "&&*rxx1555sB ?B 3- ..r%>r*r'r(r))rrr0r))r0c[X5upURSn[R"U5n[R"U5nURSURSs=:XaS:Xd-O URSURSs=:XaS:Xag OgURSS:XdURSS:Xag[ XSS9n[ XUS9n[ Xc5n[U5[U5p[XU5n X- n U S:a,[U [R"S5R*5n O*[U [R"S5R5n Xx- n U S:a,[U [R"S5R*5n O*[U [R"S5R5n [X- 5$) a Adjusted Mutual Information between two clusterings. Adjusted Mutual Information (AMI) is an adjustment of the Mutual Information (MI) score to account for chance. It accounts for the fact that the MI is generally higher for two clusterings with a larger number of clusters, regardless of whether there is actually more information shared. For two clusterings :math:`U` and :math:`V`, the AMI is given as:: AMI(U, V) = [MI(U, V) - E(MI(U, V))] / [avg(H(U), H(V)) - E(MI(U, V))] This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is furthermore symmetric: switching :math:`U` (``label_true``) with :math:`V` (``labels_pred``) will return the same score value. This can be useful to measure the agreement of two independent label assignments strategies on the same dataset when the real ground truth is not known. Be mindful that this function is an order of magnitude slower than other metrics, such as the Adjusted Rand Index. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : int array-like of shape (n_samples,) A clustering of the data into disjoint subsets, called :math:`U` in the above formula. labels_pred : int array-like of shape (n_samples,) A clustering of the data into disjoint subsets, called :math:`V` in the above formula. average_method : {'min', 'geometric', 'arithmetic', 'max'}, default='arithmetic' How to compute the normalizer in the denominator. .. versionadded:: 0.20 .. versionchanged:: 0.22 The default value of ``average_method`` changed from 'max' to 'arithmetic'. Returns ------- ami: float (upperlimited by 1.0) The AMI returns a value of 1 when the two partitions are identical (ie perfectly matched). Random partitions (independent labellings) have an expected AMI around 0 on average hence can be negative. The value is in adjusted nats (based on the natural logarithm). See Also -------- adjusted_rand_score : Adjusted Rand Index. mutual_info_score : Mutual Information (not adjusted for chance). References ---------- .. [1] `Vinh, Epps, and Bailey, (2010). Information Theoretic Measures for Clusterings Comparison: Variants, Properties, Normalization and Correction for Chance, JMLR `_ .. [2] `Wikipedia entry for the Adjusted Mutual Information `_ Examples -------- Perfect labelings are both homogeneous and complete, hence have score 1.0:: >>> from sklearn.metrics.cluster import adjusted_mutual_info_score >>> adjusted_mutual_info_score([0, 0, 1, 1], [0, 0, 1, 1]) 1.0 >>> adjusted_mutual_info_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 If classes members are completely split across different clusters, the assignment is totally in-complete, hence the AMI is null:: >>> adjusted_mutual_info_score([0, 0, 0, 0], [0, 1, 2, 3]) 0.0 rrr]roTrrnfloat64)r$rr+r;rIrrrrqr1r'rr7r*r_)rrr0rVrBrDrHremih_trueh_pred normalizerrar`s r#adjusted_mutual_info_scorers~ 1JK!!!$Iii $Gyy%H  aHNN1-22 == x~~a0 5A 5 6 q Q (.."3q"8$[dKK ; MB %k =C[)7;+?F%fnEJ"K Q+(;(?(?'?@ +rxx ':'>'>? I1} BHHY$7$;$;#;<  288I#6#:#:; ( ))r%c[X5up[R"U5n[R"U5nURSURSs=:XaS:Xd-O URSURSs=:XaS:Xag Og[ XSS9nUR [R SS9n[XUS9nUS:Xag [U5[U5p[XxU5n [Xi- 5$) aK Normalized Mutual Information between two clusterings. Normalized Mutual Information (NMI) is a normalization of the Mutual Information (MI) score to scale the results between 0 (no mutual information) and 1 (perfect correlation). In this function, mutual information is normalized by some generalized mean of ``H(labels_true)`` and ``H(labels_pred))``, defined by the `average_method`. This measure is not adjusted for chance. Therefore :func:`adjusted_mutual_info_score` might be preferred. This metric is independent of the absolute values of the labels: a permutation of the class or cluster label values won't change the score value in any way. This metric is furthermore symmetric: switching ``label_true`` with ``label_pred`` will return the same score value. This can be useful to measure the agreement of two independent label assignments strategies on the same dataset when the real ground truth is not known. Read more in the :ref:`User Guide `. Parameters ---------- labels_true : int array-like of shape (n_samples,) A clustering of the data into disjoint subsets. labels_pred : int array-like of shape (n_samples,) A clustering of the data into disjoint subsets. average_method : {'min', 'geometric', 'arithmetic', 'max'}, default='arithmetic' How to compute the normalizer in the denominator. .. versionadded:: 0.20 .. versionchanged:: 0.22 The default value of ``average_method`` changed from 'geometric' to 'arithmetic'. Returns ------- nmi : float Score between 0.0 and 1.0 in normalized nats (based on the natural logarithm). 1.0 stands for perfectly complete labeling. See Also -------- v_measure_score : V-Measure (NMI with arithmetic mean option). adjusted_rand_score : Adjusted Rand Index. adjusted_mutual_info_score : Adjusted Mutual Information (adjusted against chance). Examples -------- Perfect labelings are both homogeneous and complete, hence have score 1.0:: >>> from sklearn.metrics.cluster import normalized_mutual_info_score >>> normalized_mutual_info_score([0, 0, 1, 1], [0, 0, 1, 1]) 1.0 >>> normalized_mutual_info_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 If classes members are completely split across different clusters, the assignment is totally in-complete, hence the NMI is null:: >>> normalized_mutual_info_score([0, 0, 0, 0], [0, 1, 2, 3]) 0.0 rrr]TrFrrnro) r$r+r;rrIrrrrrqr1r_) rrr0rBrDrHrrrrs r#normalized_mutual_info_scorer)sb 1JKii $Gyy%H  aHNN1-22 == x~~a0 5A 5 6$[dKK$$RZZe$`. Parameters ---------- labels_true : array-like of shape (n_samples,), dtype=int A clustering of the data into disjoint subsets. labels_pred : array-like of shape (n_samples,), dtype=int A clustering of the data into disjoint subsets. sparse : bool, default=False Compute contingency matrix internally with sparse matrix. .. deprecated:: 1.7 The ``sparse`` parameter is deprecated and will be removed in 1.9. It has no effect. Returns ------- score : float The resulting Fowlkes-Mallows score. References ---------- .. [1] `E. B. Fowkles and C. L. Mallows, 1983. "A method for comparing two hierarchical clusterings". Journal of the American Statistical Association `_ .. [2] `Wikipedia entry for the Fowlkes-Mallows Index `_ Examples -------- Perfect labelings are both homogeneous and complete, hence have score 1.0:: >>> from sklearn.metrics.cluster import fowlkes_mallows_score >>> fowlkes_mallows_score([0, 0, 1, 1], [0, 0, 1, 1]) 1.0 >>> fowlkes_mallows_score([0, 0, 1, 1], [1, 1, 0, 0]) 1.0 If classes members are completely split across different clusters, the assignment is totally random, hence the FMI is null:: >>> fowlkes_mallows_score([0, 0, 0, 0], [0, 1, 2, 3]) 0.0 rzThe 'sparse' parameter was deprecated in 1.7 and will be removed in 1.9. It has no effect. Leave it to its default value to silence this warning.TrFrrrLrNrro)rr FutureWarningr$rrIrr+rOrTrRrQasarrayrPr_r,)rrrrVctkpkqks r#fowlkes_mallows_scorers`  W  1JK$$LY;DAA &A  ) +B  155a5=)//1Q6 7) CB  155a5=)//1Q6 7) CB9;s5!BGGBG$44 5KKr%labelsc [U5upnU(aURSO [U5nUS:XagURUR U5S[ X55nUR S:XagURU5n[URXV- URU5[U5- -5*5$)aCalculate the entropy for a labeling. Parameters ---------- labels : array-like of shape (n_samples,), dtype=int The labels. Returns ------- entropy : float The entropy for a labeling. Notes ----- The logarithm used is the natural logarithm (base-e). rr]rro) r rrpr unique_countsrrrQr_r)rxpis_array_api_compliantdevice_ labels_lenrpi_sums r#rqrqs.+C6*J'B$:aF JQ 2##F+A.0J20W XB ww!| VVBZF "&&"+"&&*s6{*BCDD EEr%)*__doc__rmathrnumbersrnumpyr+scipyrr<utils._array_apirr utils._param_validationr r r r utils.multiclassrutils.validationrr_expected_mutual_info_fastrr$r1rOrIr[rbriryr|rrxrrrrrrqr%r#rsXTTT.DC+$\  $d+$d+q$v6=+ #' &*%rxxK Kb$~$~#' K K \$~$~#' F*F*R$~$~#' fWfWR$~$~$478 #' JMZKZKz$~$~#' BKBKJ$~$~#' BKBKJ$~$~$478 #' 7:]V]V@$d+$d+< #' @Di/i/X$~$~%&OPQ #' 1=**D$~$~%&OPQ #' 1=e"e"P$~$~fZ%?@A #' ?KWLWLt<.#'  !F  !Fr%