# Options for Data / Target drift

**An example of setting custom options in the Data Drift report on California Housing Dataset:**

{% embed url="<https://colab.research.google.com/drive/11tY2g-XbkZSLSqgyGBJ5ijVvyl1E2TpY>" %}

You can set the custom options for the following Reports:

* num\_target\_drift\_tab ([Numerical Target Drift](/v0.1.57/reports/num-target-drift.md))
* cat\_target\_drift\_tab ( [Categorical Target Drift](/v0.1.57/reports/categorical-target-drift.md))
* data\_drift\_tab ([Data Drift](/v0.1.57/reports/data-drift.md))

## Available Options

You can specify the following parameters:

* **confidence**: *float* or *dict\[str, float].* Default = 0.95.
  * Defines the confidence level for the statistical tests.
  * Applies to all features (if passed as *float*) or certain features (if passed as *dictionary*).
* **drift\_share**: *float.* Default = 0.5.
  * Sets the share of drifting features as a condition for Dataset Drift in the Data Drift report.
* **nbinsx**: *int or dict\[str, int].* Default = 10.
  * Defines the number of bins in a histogram.
  * Applies to all features (if passed as *int*) or certain features (if passed as *dictionary*).
* **xbins**: *dict\[str, int].* Default = None.
  * Defines the boundaries for the size of a specific bin in a histogram.
* **feature\_stattest\_func**: *Callable* or *Dict\[str, Callable*]. Default = None.
  * Defines a custom statistical test for drift detection in the Data Drift report.
  * Applies to all features (if passed as a \_functio\_n) or individual features (if a *dictionary*).
* **cat\_target\_stattest\_func**: *Callable.* Default = None.
  * Defines a custom statistical test to detect target drift in the Categorical Target Drift report.
* **num\_target\_stattest\_func**: *Callable.* Default = None.
  * Defines a custom statistical test to detect target drift in the Numerical Target Drift report.

### How to define Data/Target Drift options

1. Define a **DataDriftOptions** object. This is a single object for Data Drift and Target Drift Reports.

```python
options = DataDriftOptions(
                           num_target_stattest_func=anderson_stat_test, 
                           confidence=0.99, 
                           nbinsx={'MedInc':15, 'HouseAge': 25, 'AveRooms':20})
```

**Note:** when you pass the function as an argument it should satisfy two conditions:

* takes as an argument two DataFrame columns (series) - reference and production data
* returns a float - p\_value

2\. Pass it to the **Dashboard** class:

```
dashboard = Dashboard(tabs=[DataDriftTab(), NumTargetDriftTab()], 
options=[options])
```

### **Customization using CLI**

You can also set the options from the command-line interface. In this case, you cannot define the functions (e.g. change statistical tests).

```json
"options": {
    "data_drift": {
      "confidence": 0.99,
      "drift_share": 0.5,
      "nbinsx": {
        "mean perimeter": 4,
        "mean symmetry": 4
      }
    }
  }
```

## Specific examples

The section below explains specific popular customizations in more detail.

### **1. Choose a different statistical test to detect Data Drift**

You can override the default statistical tests that Evidently uses in the [Data Drift report](/v0.1.57/reports/data-drift.md).

To do that, set the following option:

* **feature\_stattest\_func**: *Callable* or *Dict\[str, Callable*].

This option can take a function or a dictionary as an argument.

If you pass a **function**, this function will be used to detect drift **for all features**.

If you pass a **dictionary**, the custom functions will be used for the **specified features**. The default Evidently tests would apply to the rest.

To add an alternative test, you need to **implement a function** that would return a float (p-value) after receiving two DataFrame columns that correspond to the reference and current datasets.

```python
import numpy as np 
from scipy.stats import anderson_ksamp
def anderson_stat_test(reference_data: pd.DataFrame, current_data: pd.DataFrame):
    return anderson_ksamp(np.array([reference_data, current_data]))[2]
```

We suggest using statistical tests from [scipy](https://docs.scipy.org/doc/scipy/reference/stats.html#statistical-tests) or [statsmodels](https://www.statsmodels.org/stable/stats.html) or implementing your own.

Then, define the **DataDriftOptions** object as shown above.

### **2. Set a custom Dataset Drift condition**

The [Data Drift](/v0.1.57/reports/data-drift.md) report contains a component that confirms whether the drift was detected on the Dataset level.

To set custom drift conditions, you need to specify the following **options**:

* “**confidence**” - statistical test confidence level (default value 0.95; float or dict)
* “**drift\_share**” - share of the drifted features (default value 0.5; float)

**You can set the same confidence level for all features**. In this case, specify a float value for the "confidence" option. The Dataset Drift will be detected if the “**drift\_share**” share of the features drift at the defined “**confidence**” confidence level.

**You can also set different confidence levels for different features**. In this case, you should pass a dictionary for the "confidence" option. A custom confidence level will be applied for the specified features. The rest will have the default confidence level = 0.95.

Then, define the **DataDriftOptions** object as shown above.

### 3. Customize the histogram plots

You can customize how the distribution plots look for the individual features in the [Data Drift report](/v0.1.57/reports/data-drift.md). It is helpful, for example, if you have NULL or other specific values and want to see them in a separate bin.

To customize the plots, specify the following **options**:

* “**nbinsx**” - to set the number of bins (default value = 10, integer or dictionary)
  * If you pass an integer value, the selected number of bins will apply to all features.
  * If you pass a dictionary, then specified features will have a custom number of bins. The rest will have the default number of bins = 10.
* “**xbins**” - to define the specific bin sizes (default value = none).
  * Dict("start"=value, "end"=value, "size"=value) or [plotly.graph\_objects.histogram.XBins](https://plotly.github.io/plotly.py-docs/generated/plotly.graph_objects.histogram.html#plotly.graph_objects.histogram.XBins)

You can set different options for each feature. For example, you can specify “**nbinsx**” for one subset of the features, “**xbins**” for another, and apply defaults for the rest. [Here](https://github.com/evidentlyai/evidently/blob/main/examples/how_to_questions/drift_dashboard_with_options_california_housing.ipynb) is an example.

Once you specify the options, define the **DataDriftOptions** object as shown above.

#### What these options change

The Data Drift report has two sets of histograms:

1. preview in the Data Drift table
2. an interactive plot inside the Data Drift table that expands when you click on each feature

![](/files/TiBHGSiOPBcKIetL4HmS)

Only “**nbinsx**”, if specified, impacts the **histogram previews** in the DataDrift table. In case you set both parameters, “**xbins**” will define the interactive plot, while “**nbinsx**” will affect the preview.

Both “**nbinsx**” and “**xbins**” can influence how the **interactive plots** look inside the table. If you set one parameter, it will define the plot view. If you set both parameters, “**xbins**” will have a priority

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-old.evidentlyai.com/v0.1.57/user-guide/customization/options-for-data-target-drift.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.