---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.5
alternate:
  - https://catboost.ai/docs/en/concepts/python-reference_catboostregressor_score.md
  - href: en/concepts/python-reference_catboostregressor_score.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://catboost.ai/docs/en/llms.txt

# score

<!-- source: en/_includes/work_src/reusage-python/scor__purpose.md -->
Calculate the R2 [metric](https://catboost.ai/docs/en/concepts/loss-functions.md) for the objects in the given dataset.
<!-- endsource: en/_includes/work_src/reusage-python/scor__purpose.md -->


## Method call format {#call-format}

```
score(X, y)
```

## Parameters {#parameters}

### X

#### Description

The description is different for each group of possible types.

**Possible types**

{% cut "catboost.Pool" %}

The input training dataset.

{% note info %}

If a nontrivial value of the `cat_features` parameter is specified in the constructor of this class, CatBoost checks the equivalence of categorical features indices specification from the constructor parameters and in this Pool class.

{% endnote %}

{% endcut %}

{% cut "list, numpy.ndarray, pandas.DataFrame, pandas.Series, polars.DataFrame" %}

The input training dataset in the form of a two-dimensional feature matrix.

{% endcut %}

{% cut "pandas.SparseDataFrame, scipy.sparse.spmatrix (all subclasses except dia_matrix)" %}

<!-- source: en/_includes/work_src/reusage-formats/libsvm__desc.md -->
The input training dataset in the form of a two-dimensional sparse feature matrix.
<!-- endsource: en/_includes/work_src/reusage-formats/libsvm__desc.md -->

{% endcut %}

**Default value**

Required parameter


### y

#### Description

<!-- source: en/_includes/work_src/reusage/label--short-desc-evaluation.md -->
The target variables (in other words, the objects' label values) for the evaluation dataset.
<!-- endsource: en/_includes/work_src/reusage/label--short-desc-evaluation.md -->

<!-- source: en/_includes/work_src/reusage/label--detailed-desc-regression.md -->
Must be in the form of a one- or two- dimensional array. The type of data in the array depends on the machine learning task being solved:
- Regression — One-dimensional array of numeric values.
- Multiregression - Two-dimensional array of numeric values. The first index is for a dimension, the second index is for an object.
<!-- endsource: en/_includes/work_src/reusage/label--detailed-desc-regression.md -->


{% note info %}

Do not use this parameter if the input training dataset (specified in the `X` parameter) type is catboost.Pool.

{% endnote %}

<!-- source: en/_includes/work_src/reusage/label--possible-types-default-supported-processing-units.md -->
**Possible types**

- list
- numpy.ndarray
- pandas.DataFrame
- pandas.Series
- [polars.Series](https://docs.pola.rs/api/python/stable/reference/series/index.html)
- [polars.DataFrame](https://docs.pola.rs/api/python/stable/reference/dataframe/index.html)

**Default value**

None

**Supported processing units**

CPU and GPU
<!-- endsource: en/_includes/work_src/reusage/label--possible-types-default-supported-processing-units.md -->


## Type of return value {#output-format}
float