---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.5
alternate:
  - https://catboost.ai/docs/en/concepts/cli-reference_fstr-calc.md
  - href: en/concepts/cli-reference_fstr-calc.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

# Calculate feature importance

## Execution format {#execution-format}

```
catboost fstr [-m <model name>] [--input-path] <dataset> --fstr-type <output format>  [other parameters]
```

## Options {#options}

<!-- source: en/_includes/work_src/reusage/cli__fstr__options.md -->
### --fstr-type

#### Description

The [feature importance](https://catboost.ai/docs/en/concepts/fstr.md) output format.

Possible values:
- [PredictionValuesChange](https://catboost.ai/docs/en/concepts/fstr.md#regular-feature-importance)
- [LossFunctionChange](https://catboost.ai/docs/en/concepts/fstr.md#regular-feature-importances__lossfunctionchange)
- [InternalFeatureImportance](https://catboost.ai/docs/en/concepts/fstr.md#internal-feature-importance)
- [Interaction](https://catboost.ai/docs/en/concepts/feature-interaction.md#feature-interaction-strength)
- [InternalInteraction](https://catboost.ai/docs/en/concepts/feature-interaction.md#internal-feature-interaction-strength)
- [ShapValues](https://catboost.ai/docs/en/concepts/shap-values.md)

**Default value**

Required parameter


### -m, --model-file, --model-path

#### Description

<!-- source: en/_includes/work_src/reusage/cli__m-desc__short.md -->
The name of the input file with the description of the model obtained as the result of training.
<!-- endsource: en/_includes/work_src/reusage/cli__m-desc__short.md -->


**Default value**

model.bin

### --model-format

#### Description

The format of the input model.

Possible values:
- CatboostBinary.
- AppleCoreML (only datasets without categorical features are currently supported).
- json (multiclassification models are not currently supported). Refer to the [CatBoost JSON model tutorial](https://github.com/catboost/tutorials/blob/master/model_analysis/model_export_as_json_tutorial.ipynb) for format details.


**Default value**

CatboostBinary

### --input-path

#### Description

<!-- source: en/_includes/work_src/reusage/cli__input-path-desc__short.md -->
The name of the input file with the [dataset](https://catboost.ai/docs/en/concepts/input-data_values-file.md).
<!-- endsource: en/_includes/work_src/reusage/cli__input-path-desc__short.md -->


<!-- source: en/_includes/work_src/reusage/leaf-weights-not-in-the-model.md -->
This parameter is required in the following cases:
- The feature importance format is set to LossFunctionChange or ShapValues.
- The feature impoertance format is set to PredictionValuesChange and the model does not contain information regarding the weight of leaves. All models trained with CatBoost version 0.9 or higher contain leaf weight information by default.
<!-- endsource: en/_includes/work_src/reusage/leaf-weights-not-in-the-model.md -->


**Default value**

input.tsv


### --column-description, --cd

#### Description

<!-- source: en/_includes/work_src/reusage/cd-short-desct.md -->
The path to the input file  that contains the [columns description](https://catboost.ai/docs/en/concepts/input-data_column-descfile.md).
<!-- endsource: en/_includes/work_src/reusage/cd-short-desct.md -->


<!-- source: en/_includes/work_src/reusage/leaf-weights-not-in-the-model.md -->
This parameter is required in the following cases:
- The feature importance format is set to LossFunctionChange or ShapValues.
- The feature impoertance format is set to PredictionValuesChange and the model does not contain information regarding the weight of leaves. All models trained with CatBoost version 0.9 or higher contain leaf weight information by default.
<!-- endsource: en/_includes/work_src/reusage/leaf-weights-not-in-the-model.md -->


****Default value****

If omitted, it is assumed that the first column in the file with the dataset defines the label value, and the other columns are the values of numerical features.

### --input-graph

#### Description

The path to the input file that contains the [graph information](https://catboost.ai/docs/en/concepts/input-data_graph-description.md) for the dataset.

This information is used for calculation of [Graph aggregated features](https://catboost.ai/docs/en/features/graph-aggregated-features.md).

**Default value**

None

### -o, --output-path

#### Description

The path to the output file with data for [feature analysis](https://catboost.ai/docs/en/concepts/output-data_feature-analysis.md).

**Default value**

feature_strength.tsv


### -T, --thread-count

#### Description

<!-- source: en/_includes/work_src/reusage/thread-count-short-desc.md -->
The number of threads to use for operation.
<!-- endsource: en/_includes/work_src/reusage/thread-count-short-desc.md -->


<!-- source: en/_includes/work_src/reusage/thread_count__cpu_cores__optimizes-the-speed-of-execution.md -->
Optimizes the speed of execution. This parameter doesn't affect results.
<!-- endsource: en/_includes/work_src/reusage/thread_count__cpu_cores__optimizes-the-speed-of-execution.md -->


**Default value**

The number of processor cores
<!-- endsource: en/_includes/work_src/reusage/cli__fstr__options.md -->