> 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/scopeview/use-functions/advanced-functions/advanced-or-sidyn2.md).

# Advanced | SIDYN2

## DYNAMIC RESPONSE – \[SIDYN2]

Computes the dynamic response of a control signal following a disturbance.

## **CATEGORY**

Advanced

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/rWvoxfocWtiCg4HHvsvr/image2018%209%2025_8%2018%2057.png)

## **DESCRIPTION**

The function computes the dynamic response of a control system after a disturbance. This function allows computing mean, minimum and maximum values and stabilization times.

{% hint style="info" %}
The order of operations of this function is not as important as for other functions, but it is useful to know.
{% endhint %}

<table data-header-hidden><thead><tr><th width="60.3636474609375"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td>Course of the signal from reference Ref_Time1 to reference Ref_Time2 to find the minimum and maximum of the disturbance.</td></tr><tr><td><strong>2</strong></td><td>Calculation of the mean on the Interval (moyd) first milliseconds, of the mean on the interval (moyf) last milliseconds and of the mean on the Interval (moyp) milliseconds preceding reference Ref_Time2. These values are returned as the moyd, moyf and moyp results.</td></tr><tr><td><strong>3</strong></td><td>Calculation of time taken to reach the different threshold values for the stabilization times.</td></tr></tbody></table>

## **RESULT VARIABLES AND PARAMETERS**

<table data-header-hidden><thead><tr><th width="153.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>maxp</strong></td><td>Maximum value of the input signal between first and second reference times (Ref_Time1, Ref_Time2).</td></tr><tr><td><strong>minp</strong></td><td>Minimum value of the input signal between first and second reference times (Ref_Time1, Ref_Time2).</td></tr><tr><td><strong>moyd</strong></td><td>Mean value before the disturbance. The mean value is computed on the first milliseconds of the analysis, i.e. before the average time start (Avg_Time_Start).</td></tr><tr><td><strong>moyf</strong></td><td>Mean value after the disturbance. The mean value is computed on the last milliseconds of the analysis, i.e. after the average time end (Avg_Time_End).</td></tr><tr><td><strong>moyp</strong></td><td>Mean value during the disturbance. The mean value is computed between the average perturbation time (Avg_Time_Pert) and the reference time 2 (Ref_Time2).</td></tr><tr><td><strong>tst0</strong></td><td>Zeroth stabilization time. Time in milliseconds [ms] relative to the second reference time (Ref_Time2) when the 0 threshold value (Threshold0) is reached after reference time 2 (Ref_Time2).</td></tr><tr><td><strong>tst1</strong></td><td>First stabilization time. Time in milliseconds [ms] relative to the second reference time (Ref_Time2) when the first threshold value (Threshold1) is reached, minus reference time 2 (Ref_Time2).</td></tr><tr><td><strong>tst2</strong></td><td>Second stabilization time. Time in milliseconds [ms] relative to the second reference time (Ref_Time2) when the second threshold value (Threshold2) is reached, minus reference time 2 (Ref_Time2).</td></tr><tr><td><strong>tst3</strong></td><td>Third stabilization time. Time in milliseconds [ms] relative to the second reference time (Ref_Time2) when the third threshold value (Threshold3) is reached, minus reference time 2 (Ref_Time2).</td></tr><tr><td><strong>Signal</strong></td><td>input signal to analyze.</td></tr><tr><td><strong>Threshold0</strong></td><td>Threshold used to compute the zero stabilization time. This percentage [%] of the mean before disturbance is added to or subtracted from the mean to latter determine the threshold to reach in order to evaluate the response time. The percentage is subtracted if the mean before disturbance is higher than the mean during the disturbance. When the opposite is true, the mean is added.</td></tr><tr><td><strong>Threshold1</strong></td><td>Threshold used to compute the first stabilization time. This percentage [%] of the mean before disturbance is added to and then subtracted from the mean before disturbance to yield two threshold values, one on each side of the mean before disturbance. The stabilization time is computed using these two threshold values.</td></tr><tr><td><strong>Threshold2</strong></td><td>Threshold used to compute the second stabilization time. This percentage [%] of the mean before disturbance is added to and then subtracted from the mean before disturbance to yield 2 threshold values, one on each side of the mean before disturbance. The stabilization time is computed using these two threshold values.</td></tr><tr><td><strong>Threshold3</strong></td><td>Threshold used to compute the third stabilization time. This percentage [%] of the mean before disturbance is added to and then subtracted from the mean before disturbance to yield 2 threshold values, one on each side of the mean before disturbance. The stabilization time is computed using these two threshold values</td></tr><tr><td><strong>Ref_Time1</strong></td><td>Time in milliseconds [ms] serving as reference for the beginning of the disturbance. This time is relative to time 0 of the acquisition buffer.</td></tr><tr><td><strong>Ref_Time2</strong></td><td>Time in milliseconds [ms] serving as reference for the end of the disturbance. This time is relative to time 0 of the acquisition buffer.</td></tr><tr><td><strong>Avg_Time_Start</strong></td><td>Time interval in milliseconds [ms], at the beginning of the analysis limits, on which is computed the mean value before the disturbance (moyd).</td></tr><tr><td><strong>Avg_Time_End</strong></td><td>Time interval in milliseconds [ms], at the end of the analysis limits, on which is computed the mean value after the disturbance (moyf)</td></tr><tr><td><strong>Avg_Time_Pert</strong></td><td>Time interval in milliseconds [ms] ending at reference time (Ref_time2), on which is computed the mean value during the disturbance (moyp).</td></tr><tr><td><strong>Begin_time</strong></td><td>Time at which the analysis of a signal must start. This time is expressed in milliseconds [ms]. This value must be greater than 0 and lower than the size of the acquisition buffer. The default value is 0.</td></tr><tr><td><strong>End_time</strong></td><td>Time at which the analysis of a signal must end. This time is expressed in milliseconds [ms]. The value of this time must be larger than the specified begin_time and smaller than the duration of the test. Use the “HUGE” value to specify the end of the test. The default value is HUGE.</td></tr><tr><td><strong>Factor</strong></td><td>Multiplying factor for the results generated by the function. The default value of the multiplying factor is 1.0 and has no effect on the results. The multiplying factor only applies to the following results: tst0, tst1, tst2 and tst3. The other results are not modified.</td></tr></tbody></table>

## **SYNTAX**

**\[maxp, minp, moyd, moyf\_1, moyp, tst0, tst1, tst2, tst3]** = sidyn2(input, threshold0, threshold1, threshold2, threshold3, time1, time2, time\_start, time\_end, time\_pert, 0, HUGE, 1)

## **CHARACTERISTICS**

Data type support

Double Floating point

## **EXAMPLE**

The following figure shows the results for a signal whose disturbance voltage is lower than initial voltage.

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/JJUngZhLyJIarWDz6WAz/image2018%209%2025_8%2019%2051.png)

The following figure shows the results for a signal whose disturbance voltage exceeds the initial voltage.

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/GA1gSjFRuGFC5gxHE7sK/image2018%209%2025_8%2020%2047.png)


---

# 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/scopeview/use-functions/advanced-functions/advanced-or-sidyn2.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.
