# tfma.metrics.SetMatchPrecision

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/model-analysis/blob/v0.46.0/tensorflow_model_analysis/metrics/set_match_confusion_matrix_metrics.py#L27-L146) |

Computes precision for sets of labels and predictions.

Inherits From: [`Precision`](https://www.tensorflow.org/tfx/model_analysis/api_docs/python/tfma/metrics/Precision), [`Metric`](https://www.tensorflow.org/tfx/model_analysis/api_docs/python/tfma/metrics/Metric)

    tfma.metrics.SetMatchPrecision(
        thresholds: Optional[Union[float, List[float]]] = None,
        top_k: Optional[int] = None,
        name: Optional[str] = None,
        prediction_class_key: str = 'classes',
        prediction_score_key: str = 'scores',
        class_key: Optional[str] = None,
        weight_key: Optional[str] = None,
        **kwargs
    )

The metric deals with labels and predictions which are provided in the format
of sets (stored as variable length numpy arrays). The precision is the
micro averaged classification precision. The metric is suitable for the case
where the number of classes is large or the list of classes could not be
provided in advance.

#### Example:

Label: \['cats'\],
Predictions: {'classes': \['cats, dogs'\]}

The precision is 0.5.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `thresholds` | (Optional) A float value or a python list/tuple of float threshold values in \[0, 1\]. A threshold is compared with prediction values to determine the truth value of predictions (i.e., above the threshold is `true`, below is `false`). One metric value is generated for each threshold value. If neither thresholds nor top_k are set, the default is to calculate precision with `thresholds=0.5`. |
| `top_k` | (Optional) Used with a multi-class model to specify that the top-k values should be used to compute the confusion matrix. The net effect is that the non-top-k values are truncated and the matrix is then constructed from the average TP, FP, TN, FN across the classes. When top_k is used, metrics_specs.binarize settings must not be present. When top_k is used, the default threshold is float('-inf'). In this case, unmatched labels are still considered false negative, since they have prediction with confidence score float('-inf'), |
| `name` | (Optional) string name of the metric instance. |
| `prediction_class_key` | the key name of the classes in prediction. |
| `prediction_score_key` | the key name of the scores in prediction. |
| `class_key` | (Optional) The key name of the classes in class-weight pairs. If it is not provided, the classes are assumed to be the label classes. |
| `weight_key` | (Optional) The key name of the weights of classes in class-weight pairs. The value in this key should be a numpy array of the same length as the classes in class_key. The key should be stored under the features key. |
| `**kwargs` | (Optional) Additional args to pass along to init (and eventually on to _metric_computations and _metric_values). The args are passed to the precision metric, the confusion matrix metric and binary classification metric. |

<br />

<br />

<br />

<br />

| ## Attributes ||
|---|---|
| `compute_confidence_interval` | Whether to compute confidence intervals for this metric. <br /> Note that this may not completely remove the computational overhead involved in computing a given metric. This is only respected by the jackknife confidence interval method. |

<br />

## Methods

### `computations`

[View source](https://github.com/tensorflow/model-analysis/blob/v0.46.0/tensorflow_model_analysis/metrics/metric_types.py#L862-L888)

    computations(
        eval_config: Optional[https://www.tensorflow.org/tfx/model_analysis/api_docs/python/tfma/EvalConfig] = None,
        schema: Optional[schema_pb2.Schema] = None,
        model_names: Optional[List[str]] = None,
        output_names: Optional[List[str]] = None,
        sub_keys: Optional[List[Optional[SubKey]]] = None,
        aggregation_type: Optional[AggregationType] = None,
        class_weights: Optional[Dict[int, float]] = None,
        example_weighted: bool = False,
        query_key: Optional[str] = None
    ) -> https://www.tensorflow.org/tfx/model_analysis/api_docs/python/tfma/metrics/MetricComputations

Creates computations associated with metric.

### `from_config`

[View source](https://github.com/tensorflow/model-analysis/blob/v0.46.0/tensorflow_model_analysis/metrics/metric_types.py#L842-L847)

    @classmethod
    from_config(
        config: Dict[str, Any]
    ) -> 'Metric'

### `get_config`

[View source](https://github.com/tensorflow/model-analysis/blob/v0.46.0/tensorflow_model_analysis/metrics/confusion_matrix_metrics.py#L252-L262)

    get_config() -> Dict[str, Any]

Returns serializable config.

### `result`

[View source](https://github.com/tensorflow/model-analysis/blob/v0.46.0/tensorflow_model_analysis/metrics/confusion_matrix_metrics.py#L1277-L1279)

    result(
        tp: float, tn: float, fp: float, fn: float
    ) -> float

Function for computing metric value from TP, TN, FP, FN values.