> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/control-and-measurements/analysis/digital-flickermeter.md).

# Digital Flickermeter

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-87af5d64c115af46a639484b832d121db3f813a0%2Fdigital_flickermeter_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Digital Flickermeter** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, implements a digital flickermeter as described in the IEC 61000-4-15 standard.

The model implements the first four modules of the design. The statistical analysis (module 5) is implemented by an external function for offline analysis of recorded simulation signal.

{% hint style="danger" %}
You must have a **Control System Toolbox™ license** to use the Digital Flickermeter block.
{% endhint %}

## Ports

### Input

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>enable</strong> — Option to enable flicker measurement<br>1 | 0</td><td><p>Set this input to 1 to enable the flicker measurement.</p><p>The flickermeter is normally enabled after a given period of time, when the analyzed signal (input U) is stable.</p></td></tr><tr><td><strong>u</strong> — Analyzed signal<br></td><td>Analyzed signal.</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>S5</strong> — Instantaneous flicker sensation<br></td><td>Instantaneous flicker sensation measured for the analyzed signal.</td></tr><tr><td><strong>m</strong> — Measurement signal<br>vector</td><td><p>This output contains these measurements:</p><ul><li>Output 1: Half-cycle, rms-normalized voltage (pu)</li><li>Output 2: Weighted voltage fluctuation</li><li>Output 3: Square root of Output_5</li><li>Output 4: One-minute dose (integral) of instant perception</li><li>Output 5: Instantaneous flicker sensation (Output S5)</li><li>u: The analyzed signal</li><li>Init: initialization period time</li></ul></td></tr></tbody></table>

## Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink<sup>®</sup> Toolstrip, on the **Simulation** tab, in the **Prepare** gallery, select **Property Inspector**.

<table data-header-hidden><thead><tr><th width="249.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>Open statistical analysis</strong> — Open statistical tool<br></td><td>Opens the Statistical Analysis of Instantaneous Flicker Level module tool.</td></tr><tr><td><strong>Network frequency</strong> — Frequency of the analyzed signal<br>60 Hz (default) | 50 Hz</td><td>Frequency of the analyzed signal. Choose between 60 Hz and 50 Hz.</td></tr><tr><td><strong>Nominal input phase voltage (Vrms)</strong> — Nominal voltage value of analyzed signal<br>25e3/sqrt(3) (default)</td><td>Nominal voltage value of the analyzed signal, in volts rms.</td></tr><tr><td><strong>Maximum input voltage (pu)</strong> — Maximum input voltage value of input voltage adaptor<br>5.0 (default)</td><td>Maximum input voltage value of the input voltage adaptor (module 1), in per unit.</td></tr><tr><td><strong>Maximum instantaneous sensation (pu)</strong> — Maximum value of instantaneous flicker sensation<br>1000 (default)</td><td>Maximum value of the instantaneous flicker sensation measured by the block, in per unit.</td></tr><tr><td><strong>Sample time (s)</strong> — Sampling rate<br>0.001 (default)</td><td>Sampling rate used to compute the instantaneous flicker sensation.</td></tr><tr><td><strong>Scaling factor for sensation perceptibility</strong> — Scaling factor of flickermeter for measuring sensation perceptibility<br>1.24e6 (default)</td><td>Scaling factor of the flickermeter for measuring the sensation perceptibility.</td></tr></tbody></table>

## Examples

The [Flickermeter on a Distribution STATCOM](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/control-and-measurements/flickermeter-on-a-distribution-statcom.md) example shows a flickermeter device that measures the instantaneous flicker sensation on the terminal voltage of a STATCOM unit.

The [Flickermeter Statistical Analysis Module](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/control-and-measurements/flickermeter-statistical-analysis-module.md) example shows a method to compute short-term flicker severity of a phase-to-ground voltage taken from one feeder of a given remote community.

## References <a href="#references" id="references"></a>

\[1] *Electromagnetic compatibility (EMC) – Part 4: Testing and measurement techniques – Section 15: Flickermeter – Functional and design specifications*.,IEC-61000-4-15, 2003-02.

\[2] Gutierrez, J. J., J. Ruiz, A. Lazkano, and L. A. Leturiondo. “Measurement of Voltage Flicker: Application to Grid-connected Wind Turbines.” In *Advances in Measurement Systems*, edited by Milind Kr Sharma, 365–380. InTech, DOI: 10.5772/8731, 2010. Available from: <http://www.intechopen.com/books/advances-in-measurement-systems/measurement-of-voltage-flicker-application-to-grid-connected-wind-turbines>.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/control-and-measurements/analysis/digital-flickermeter.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
