> For the complete documentation index, see [llms.txt](https://docs.yanusstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yanusstudio.com/yanuslive/settings/settings-filter.md).

# Settings: Filter

Basic preset selection and advanced filter detailed settings.

The filter settings in this tab are applied uniformly regardless of the Actor mode selected, as well as during the execution of Generate Facial Data and Batch Generator Window.

Parameters can be adjusted while Actor mode is running, and changes are applied immediately when the Apply button is pressed.

## Preset Selection

<figure><img src="/files/9B5nHiwi3wVie2mnhuGV" alt="" width="563"><figcaption><p>Settings: Filter > Preset</p></figcaption></figure>

* **Preset :  Stable**
  * All settings except for the Preset selection are disabled.

{% hint style="info" %}
Unlike other modes, this mode operates at a stage prior to BlendShape measurement and does not use other parameters. For standard webcams rather than specialized capture devices, manual filter adjustment may be challenging due to inherent noise. This mode is generally recommended when fast lip movement is not a critical factor.
{% endhint %}

* **Preset** :  **Responsiveness,  Balanced,  Noise Control**
  * These presets represent a trade-off between responsiveness and noise reduction, categorized as responsiveness-focused, balanced, and noise-focused.

{% hint style="info" %}
Designed primarily for typical webcams, each setting may require slight adjustments by sliding from right to left to improve responsiveness.
{% endhint %}

* **Preset : Custom\_Ex01,  Custom\_Ex02**
  * Two preset Filter slots prepared as examples of user-defined settings.

{% hint style="info" %}
Preset items can be added with new names. The six items listed above can have their parameters modified or reset to default, but they cannot be deleted
{% endhint %}

### Terminology Explanation

The terms **Live Filter, Post CSV Filter, and Secondary Filter** are explained below.\
The **Live Filter** is used for both real-time processing and CSV data file generation, while the **Post CSV** **Filter** applies only during CSV file creation. To provide flexible adjustment for BlendShapes with varying noise characteristics, both filters are divided into two separate parameters. The second parameter is referred to as the **Secondary Filter**.

## Live Filter

<figure><img src="/files/JuzWujGqxMmS7dMsSdpv" alt="" width="563"><figcaption><p>Settings: Filter > Live Filter</p></figcaption></figure>

* **Static Noise** :  Smoothing level (window size) for reducing static noise
* **Static Range** :  Noise threshold to trigger smoothing filter
* **Dynamic Noise** :  Kalman filter sensitivity settings (Q, R) for dynamic noise

{% hint style="info" %}
The Live Filter operates in two stages, utilizing a Moving Average and a Kalman Filter. The Moving Average is selectively applied based on the BlendShape’s rate of change—the difference between previous and current values. When movement is significant, only the Kalman Filter is active. For small, stationary noise components known as jitter, which fall below a defined static range, the Moving Average filter is applied. This approach ensures responsive performance while effectively suppressing jitter noise.
{% endhint %}

## Live Secondary Filter

<figure><img src="/files/2f00qYfrOHOIuTGFjSH3" alt="" width="563"><figcaption><p>Settings: Filter > Live Secondary Filter</p></figcaption></figure>

* **Use 2nd Filter** :  Enable or disable the Secondary Filter.
* **Highlight Selected BlendShapes**

  BlendShapes affected by the second filter are highlighted in yellow within the Value Pane. This helps identify BlendShapes filtered based on the Selection Keywords.
* **Selection Keywords**

  Enter BlendShape selection keywords, separated by commas, to specify which BlendShapes the Secondary Filter applies to.

## Post CSV Filter

<figure><img src="/files/QDdnvjCtBVK83xXJ2fqa" alt="" width="563"><figcaption><p>Settings: Filter > Post CSV Filter</p></figcaption></figure>

* **Cutoff Frequency** :  Cutoff frequency for smoothing filter

{% hint style="info" %}
A bidirectional Butterworth filter is applied to ensure zero delay.
{% endhint %}

## Post CSV Secondary Filter

<figure><img src="/files/8pXxh7iLxePJBxUeeNIv" alt="" width="563"><figcaption><p>Settings: Filter > Post CSV Secondary Filter</p></figcaption></figure>

## CSV Export Filter

<figure><img src="/files/FLCu9QLb44Vv6hD8t11O" alt="" width="563"><figcaption><p>Settings: Filter > CSV Export Filter</p></figcaption></figure>

* **Live** :  Generate CSV output files using the Live filter.
* **Post CSV** :  Generate CSV output files using the Post CSV filter.

When both options are enabled, two CSV files are generated simultaneously, with the suffixes "\_live" and "\_post" appended to the filenames.

{% hint style="info" %}
During real-time processing, FPS may temporarily drop depending on your PC. Data streaming continues, but saving data files simultaneously is not supported. Checking the Live option in the CSV Export Filter helps you review filter tuning results during real-time use.
{% endhint %}

## Preset Management

<figure><img src="/files/iRn29OSGfGiH0CVLkBqA" alt="" width="563"><figcaption><p>Settings: Filter > Preset Management, Top</p></figcaption></figure>

<figure><img src="/files/g1nB0P9ls6Lx8mFhnF1C" alt="" width="563"><figcaption><p>Settings: Filter > Preset Management, Bottom</p></figcaption></figure>

* **Preset name** :  Enter a name for the new preset.
* **Save** :  Save the current settings to the selected preset.
* **Add** :  Add a new preset.
* **Reload** :  Discard changes made before pressing Apply and reload the previous settings.
* **Init** :  Reset parameters to their default values.
* **Delete** :  Delete user-added presets, excluding the six default presets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.yanusstudio.com/yanuslive/settings/settings-filter.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.