Skip to content
This repository was archived by the owner on Jan 19, 2025. It is now read-only.
This repository was archived by the owner on Jan 19, 2025. It is now read-only.

@Optional:None is generated where @Required is expected #828

@lukarade

Description

@lukarade

URL Hash

#/sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred

Actual Annotation Type

@optional

Actual Annotation Inputs

{
    "target": "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred",
    "authors": [
        "$autogen$"
    ],
    "defaultType": "none",
    "defaultValue": null
}

Expected Annotation Type

@required

Expected Annotation Inputs

n/a

Minimal API Data (optional)

Minimal API Data for `sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred`
{
    "schemaVersion": 1,
    "distribution": "scikit-learn",
    "package": "sklearn",
    "version": "1.1.1",
    "modules": [
        {
            "id": "sklearn/sklearn.metrics",
            "name": "sklearn.metrics",
            "imports": [],
            "from_imports": [
                {
                    "module": "sklearn.metrics",
                    "declaration": "cluster",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "accuracy_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "balanced_accuracy_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "brier_score_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "classification_report",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "cohen_kappa_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "confusion_matrix",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "f1_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "fbeta_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "hamming_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "hinge_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "jaccard_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "log_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "matthews_corrcoef",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "multilabel_confusion_matrix",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "precision_recall_fscore_support",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "precision_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "recall_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._classification",
                    "declaration": "zero_one_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._dist_metrics",
                    "declaration": "DistanceMetric",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.confusion_matrix",
                    "declaration": "ConfusionMatrixDisplay",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.confusion_matrix",
                    "declaration": "plot_confusion_matrix",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.det_curve",
                    "declaration": "DetCurveDisplay",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.det_curve",
                    "declaration": "plot_det_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.precision_recall_curve",
                    "declaration": "plot_precision_recall_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.precision_recall_curve",
                    "declaration": "PrecisionRecallDisplay",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.roc_curve",
                    "declaration": "plot_roc_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._plot.roc_curve",
                    "declaration": "RocCurveDisplay",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "auc",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "average_precision_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "coverage_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "dcg_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "det_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "label_ranking_average_precision_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "label_ranking_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "ndcg_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "precision_recall_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "roc_auc_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "roc_curve",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._ranking",
                    "declaration": "top_k_accuracy_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "d2_absolute_error_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "d2_pinball_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "d2_tweedie_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "explained_variance_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "max_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_absolute_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_absolute_percentage_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_gamma_deviance",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_pinball_loss",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_poisson_deviance",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_squared_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_squared_log_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "mean_tweedie_deviance",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "median_absolute_error",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._regression",
                    "declaration": "r2_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._scorer",
                    "declaration": "check_scoring",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._scorer",
                    "declaration": "get_scorer",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._scorer",
                    "declaration": "get_scorer_names",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._scorer",
                    "declaration": "make_scorer",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics._scorer",
                    "declaration": "SCORERS",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "adjusted_mutual_info_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "adjusted_rand_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "calinski_harabasz_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "completeness_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "consensus_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "davies_bouldin_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "fowlkes_mallows_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "homogeneity_completeness_v_measure",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "homogeneity_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "mutual_info_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "normalized_mutual_info_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "pair_confusion_matrix",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "rand_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "silhouette_samples",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "silhouette_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.cluster",
                    "declaration": "v_measure_score",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "euclidean_distances",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "nan_euclidean_distances",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "pairwise_distances",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "pairwise_distances_argmin",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "pairwise_distances_argmin_min",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "pairwise_distances_chunked",
                    "alias": null
                },
                {
                    "module": "sklearn.metrics.pairwise",
                    "declaration": "pairwise_kernels",
                    "alias": null
                }
            ],
            "classes": [],
            "functions": [
                "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score"
            ]
        }
    ],
    "classes": [],
    "functions": [
        {
            "id": "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score",
            "name": "mutual_info_score",
            "qname": "sklearn.metrics.cluster._supervised.mutual_info_score",
            "decorators": [],
            "parameters": [
                {
                    "id": "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred",
                    "name": "labels_pred",
                    "qname": "sklearn.metrics.cluster._supervised.mutual_info_score.labels_pred",
                    "default_value": null,
                    "assigned_by": "POSITION_OR_NAME",
                    "is_public": true,
                    "docstring": {
                        "type": "int array-like of shape (n_samples,)",
                        "description": "A clustering of the data into disjoint subsets, called :math:`V` in\nthe above formula."
                    },
                    "type": {}
                }
            ],
            "results": [],
            "is_public": true,
            "reexported_by": [
                "sklearn/sklearn.metrics",
                "sklearn/sklearn.metrics.cluster"
            ],
            "description": "Mutual Information between two clusterings.\n\nThe Mutual Information is a measure of the similarity between two labels\nof the same data. Where :math:`|U_i|` is the number of the samples\nin cluster :math:`U_i` and :math:`|V_j|` is the number of the\nsamples in cluster :math:`V_j`, the Mutual Information\nbetween clusterings :math:`U` and :math:`V` is given as:\n\n.. math::\n\nMI(U,V)=\\sum_{i=1}^{|U|} \\sum_{j=1}^{|V|} \\frac{|U_i\\cap V_j|}{N}\n\\log\\frac{N|U_i \\cap V_j|}{|U_i||V_j|}\n\nThis metric is independent of the absolute values of the labels:\na permutation of the class or cluster label values won't change the\nscore value in any way.\n\nThis metric is furthermore symmetric: switching :math:`U` (i.e\n``label_true``) with :math:`V` (i.e. ``label_pred``) will return the\nsame score value. This can be useful to measure the agreement of two\nindependent label assignments strategies on the same dataset when the\nreal ground truth is not known.\n\nRead more in the :ref:`User Guide <mutual_info_score>`.",
            "docstring": "Mutual Information between two clusterings.\n\nThe Mutual Information is a measure of the similarity between two labels\nof the same data. Where :math:`|U_i|` is the number of the samples\nin cluster :math:`U_i` and :math:`|V_j|` is the number of the\nsamples in cluster :math:`V_j`, the Mutual Information\nbetween clusterings :math:`U` and :math:`V` is given as:\n\n.. math::\n\n    MI(U,V)=\\sum_{i=1}^{|U|} \\sum_{j=1}^{|V|} \\frac{|U_i\\cap V_j|}{N}\n    \\log\\frac{N|U_i \\cap V_j|}{|U_i||V_j|}\n\nThis metric is independent of the absolute values of the labels:\na permutation of the class or cluster label values won't change the\nscore value in any way.\n\nThis metric is furthermore symmetric: switching :math:`U` (i.e\n``label_true``) with :math:`V` (i.e. ``label_pred``) will return the\nsame score value. This can be useful to measure the agreement of two\nindependent label assignments strategies on the same dataset when the\nreal ground truth is not known.\n\nRead more in the :ref:`User Guide <mutual_info_score>`.\n\nParameters\n----------\nlabels_true : int array, shape = [n_samples]\n    A clustering of the data into disjoint subsets, called :math:`U` in\n    the above formula.\n\nlabels_pred : int array-like of shape (n_samples,)\n    A clustering of the data into disjoint subsets, called :math:`V` in\n    the above formula.\n\ncontingency : {ndarray, sparse matrix} of shape             (n_classes_true, n_classes_pred), default=None\n    A contingency matrix given by the :func:`contingency_matrix` function.\n    If value is ``None``, it will be computed, otherwise the given value is\n    used, with ``labels_true`` and ``labels_pred`` ignored.\n\nReturns\n-------\nmi : float\n   Mutual information, a non-negative value, measured in nats using the\n   natural logarithm.\n\nNotes\n-----\nThe logarithm used is the natural logarithm (base-e).\n\nSee Also\n--------\nadjusted_mutual_info_score : Adjusted against chance Mutual Information.\nnormalized_mutual_info_score : Normalized Mutual Information."
        }
    ]
}

Minimal Usage Store (optional)

Minimal Usage Store for `sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred`
{
    "schemaVersion": 1,
    "module_counts": {
        "sklearn/sklearn.metrics": 53559
    },
    "class_counts": {},
    "function_counts": {
        "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score": 8
    },
    "parameter_counts": {
        "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred": 8
    },
    "value_counts": {
        "sklearn/sklearn.metrics.cluster._supervised/mutual_info_score/labels_pred": {
            "None": 1,
            "verySimpleLearner.predict_proba(trainInputFeature)[:, 1]": 1,
            "verySimpleLearner.predict_proba(validInputFeature)[:, 1]": 1,
            "verySimpleLearner.predict_proba(trainInputFeatures)[:, 1]": 1,
            "verySimpleLearner.predict_proba(validInputFeatures)[:, 1]": 1,
            "test['lee_a_coref']": 1,
            "test['lee_b_coref']": 1,
            "col_corr": 1
        }
    }
}

Suggested Solution (optional)

No response

Additional Context (optional)

grafik

Metadata

Metadata

Assignees

Labels

@optionalRelated to the @optional annotation@requiredRelated to the @required annotationbug 🪲Something isn't workingreleasedIncluded in a releasewrong annotationAn annotation was generated automatically but is incorrect

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions