> 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/machines/functions/power_asynchronousmachineparams.md).

# power\_AsynchronousMachineParams

## Description

The **power\_AsynchronousMachineParams** function estimates electrical parameters of double cage asynchronous machine based on standard manufacturer specifications.

## Syntax

```
power_AsynchronousMachineParams
params = power_AsynchronousMachineParams(spec)
params = power_AsynchronousMachineParams(spec, options)
[params, spec2] = power_AsynchronousMachineParams(spec, options)
[params, spec2, errors] = power_AsynchronousMachineParams(spec, options)
```

**params = power\_AsynchronousMachineParams(spec)** computes the machine parameters from the input structure spec, which contains the manufacturer data. The solution is returned in the output structure params.

**params = power\_AsynchronousMachineParams(spec, options)** lets you specify more options (display details, draw graphs, parameter units, and graph units) in the input structure options.

**\[params, spec2] = power\_AsynchronousMachineParams(spec, options)** returns the input manufacturer data along with some additional derived data (synchronous speed, number of pole pairs, nominal slip, starting torque, and so on) in the structure spec2.

**\[params, spec2, errors] = power\_AsynchronousMachineParams(spec, options)** returns the relative errors between the input manufacturer data and the equivalent data obtained with the computed parameters in the structure errors.

## Electrical Parameters of a Double-Cage Asynchronous Machine

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

*R*<sub>s</sub>, *L*<sub>ls</sub>, *R*<sub>r1</sub>, *L*<sub>lr1</sub>, *R*<sub>r2</sub>, *L*<sub>lr2</sub>, *L*<sub>m</sub> are the seven electrical parameters of the machine. They form the fields of the params structure, as described in the Output Arguments section.

$$
f\_1(x) = \frac{T\_n - T(s\_n)}{T\_n} \\\[8pt]

f\_2(x) = \frac{I\_n - I(s\_n)}{I\_n} \\\[8pt]

f\_3(x) = \frac{p f - p f(s\_n)}{p f} \\\[8pt]

f\_4(x) = \frac{I\_{st} - I(1)}{I\_{st}} \\\[8pt]

f\_5(x) = \frac{T\_{br} - T(s\_{br})}{T\_{br}} \\\[8pt]

f\_6(x) = \frac{T\_{st} - T(1)}{T\_{st}} \\\[8pt]
$$

where *f* = (*f*<sub>1</sub>, *f*<sub>2</sub>, *f*<sub>3</sub>, *f*<sub>4</sub>, *f*<sub>5</sub>, *f*<sub>6</sub>) and *x* = (*R*<sub>s</sub>, *L*<sub>m</sub>, *R*<sub>r1</sub>, *L*<sub>lr1</sub>, *R*<sub>r2</sub>, *L*<sub>lr2</sub>). The *L*<sub>ls</sub> parameter is obtained by assuming that the stator and outer cage leakage inductances are equal (*L*<sub>ls</sub> = *L*<sub>lr2</sub>). *s*<sub>n</sub> and *s*<sub>br</sub> are the slip at nominal and breakdown torque, respectively. For details on the functions used in these equations, see \[1].

*T*<sub>n</sub>, *I*<sub>n</sub>, *pf*, *I*<sub>st</sub>, *I*<sub>br</sub>, *T*<sub>st</sub> are the standard manufacturer specifications of the machine. They form the fields of the spec structure, as described in the Input Arguments section.

## Input Arguments

### spec — Structure containing manufacturer data.

<table data-header-hidden><thead><tr><th width="199.88885498046875"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Vn</strong></td><td>Nominal line-to-line rms voltage (V)</td></tr><tr><td><strong>fn</strong></td><td>Nominal frequency (Hz)</td></tr><tr><td><strong>In</strong></td><td>Nominal (full load) line current (A)</td></tr><tr><td><strong>Tn</strong></td><td>Nominal (full load) torque (N.m)</td></tr><tr><td><strong>Ns, or p</strong></td><td>You can either specify the Synchronous speed (rpm) or the pole pairs</td></tr><tr><td><strong>Nn</strong></td><td>Nominal (full load) mechanical speed (rpm)</td></tr><tr><td><strong>Ist_In</strong></td><td>Starting current to nominal current ratio</td></tr><tr><td><strong>Tst_Tn</strong></td><td>Starting torque to full load torque ratio</td></tr><tr><td><strong>Tbr_Tn</strong></td><td>Breakdown torque to full load torque ratio</td></tr><tr><td><strong>pf</strong></td><td>Nominal power factor (%)</td></tr></tbody></table>

### options — Structure containing additional options (all optional):

<table data-header-hidden><thead><tr><th width="200.11114501953125"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>DisplayDetails</strong></td><td>If set to 1, displays detailed information (results, errors between the specified and the computed data) in the MATLAB® Command window. By default, this field is set to 0.</td></tr><tr><td><strong>DrawGraphs</strong></td><td>If set to 1, plots torque versus speed and stator current versus speed characteristics. By default, this field is set to 0.</td></tr><tr><td><strong>units</strong></td><td>Specifies the units of machine parameters in 'SI' or 'p.u.'. By default, this field is set to 'SI'.</td></tr><tr><td><strong>graphUnits</strong></td><td>Specifies the graph units in 'SI' or 'p.u.'. By default, this field is set to 'SI'.</td></tr></tbody></table>

## Output Arguments

### params — Returns the machine parameters in a structure

<table data-header-hidden><thead><tr><th width="200.33331298828125"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Rs</strong></td><td>Stator resistance (ohm or pu)</td></tr><tr><td><strong>Lls</strong></td><td>Stator leakage inductance (H or pu)</td></tr><tr><td><strong>Rr1</strong></td><td>Cage 1 (inner cage) resistance (ohm or pu)</td></tr><tr><td><strong>Llr1</strong></td><td>Cage 1 (inner cage) leakage inductance (H or pu)</td></tr><tr><td><strong>Rr2</strong></td><td>Cage 2 (outer cage) resistance (ohm or pu)</td></tr><tr><td><strong>Llr2</strong></td><td>Cage 2 (outer cage) leakage inductance (H or pu)</td></tr><tr><td><strong>Lm</strong></td><td>Magnetizing inductance (H or pu)</td></tr></tbody></table>

### spec2 — Returns the input manufacturer data structure along with the following additional derived data fields

<table data-header-hidden><thead><tr><th width="200.111083984375"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>cosphi</strong></td><td>Nominal power factor (0-1)</td></tr><tr><td><strong>Ns</strong></td><td>Synchronous speed (rpm)</td></tr><tr><td><strong>p</strong></td><td>Number of pole pairs</td></tr><tr><td><strong>we</strong></td><td>Nominal electrical angular speed (rad/s)</td></tr><tr><td><strong>Vin</strong></td><td>Nominal phase voltage (V)</td></tr><tr><td><strong>sn</strong></td><td>Nominal (full-load) slip</td></tr><tr><td><strong>Ist</strong></td><td>Starting current (A)</td></tr><tr><td><strong>Tst</strong></td><td>Starting torque (N.m)</td></tr><tr><td><strong>Tbr</strong></td><td>Breakdown torque (N.m)</td></tr><tr><td><strong>Pn</strong></td><td>Nominal (full load) mechanical power (W)</td></tr></tbody></table>

### errors — Return the relative errors between input manufacturer data and equivalents computed

<table data-header-hidden><thead><tr><th width="200.33331298828125"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>In</strong></td><td>Relative error with respect to specified nominal current (%)</td></tr><tr><td><strong>Tn</strong></td><td>Relative error with respect to specified nominal torque (%)</td></tr><tr><td><strong>pf</strong></td><td>Relative error with respect to specified nominal power factor (%)</td></tr><tr><td><strong>Ist</strong></td><td>Relative error with respect to specified starting current (%)</td></tr><tr><td><strong>Ist_Iin</strong></td><td>Relative error with respect to specified starting current to nominal current ratio (%)</td></tr><tr><td><strong>Tst</strong></td><td>Relative error with respect to specified starting torque (%)</td></tr><tr><td><strong>Tst_Tn</strong></td><td>Relative error with respect to specified starting torque to full load torque ratio (%)</td></tr><tr><td><strong>Tbr</strong></td><td>Relative error with respect to specified breakdown torque (%)</td></tr><tr><td><strong>Tbr_Tn</strong></td><td>Relative error with respect to specified breakdown torque to full load torque ratio (%)</td></tr><tr><td><strong>maxError</strong></td><td>Maximum relative error (maximum of above fields) (%)</td></tr></tbody></table>

## Dialog Box

power\_AsynchronousMachineParams opens a user interface that can be used to estimate parameters of the double-cage Asynchronous Machine block.

**Specifications**: Enter the manufacturer specifications. If you loaded a motor preset in the interface, the name of the MAT file is displayed in the upper section of the panel.

**Compute Block Parameters**: Compute the electrical parameters of the double-cage asynchronous machine and display the solution in the **Block Parameters** section. The button is grayed out when the block parameters have been estimated.

The button is reenabled when you enter new values in the **Specifications** section, to indicate that the displayed block parameters no longer correspond to the displayed specifications.

If the **Display detailed results in the command window** check box is selected, the errors between the specified manufacturer parameters and the obtained parameters are displayed in the command window. This allows you to check that the estimated RL machine parameters are satisfactory. For example, the errors obtained with the `Baldor_2,2_kw_208_V.mat` preset motor are shown below:

```
Asynchronous machine parameter estimation results
-------------------------------------------------------------
Parameter        Specified       Obtained         Error (%)
---------        ---------       ---------        ---------
In (A)               8.3         8.26016           -0.48
Tn (N.m)           12.27         12.3656            0.78
Ist (A)           66.483         66.0075           -0.72
Ist/In ()           8.01         7.99106           -0.24
Tst (N.m)        43.3131         43.2625           -0.12
Tst/Tn ()           3.53         3.49861           -0.89
Tmax (N.m)       47.7303         47.9587            0.48
Tbr/Tn ()          3.89          3.87839           -0.30
pf (%)               87          86.4635           -0.62
```

### **Block Parameters**

This section displays the asynchronous machine block parameters corresponding to the given manufacturer specifications. These fields are empty the first time you open the interface, or when the function failed to find a solution. The block parameters are noneditable. They can be loaded in your Asynchronous Machine block by using the **Apply to selected block** button.

**Save spec to MATLAB structure**

Click **Save spec to MATLAB structure** to save the motor specifications in a MATLAB structure in the base workspace.

**Apply to selected block**

Open your model, select the machine you want to parametrize, then click the **Apply to selected block** button to load the displayed block parameters in the block. The block is grayed out when the **Block Parameters** fields are empty. The button is enabled when a valid solution is displayed in the **Block Parameters** section.

The button has no effect on a selected block that is not an Asynchronous Machine block.

**Presets**

Select **New** to clear the **Block Parameters** and **Specifications** sections. The **Compute Block Parameters** and **Apply to selected block** buttons are then disabled.

Select **Open preset motor** to load in the interface a given set of manufacturer specifications. The corresponding block parameters are also loaded when they are available in the preset file.

Select **Save preset motor** to save the specifications displayed in the interface. The block parameters are also saved when available.

**Options**

If the **Draw graph after computation** option in the **Compute Block Parameters** submenu is selected, then when you click the **Compute Block Parameters** button the function displays the graphs of torque versus speed and stator current versus speed, corresponding to the block parameters. This option is not selected by default.

If the **Display detailed results in the command window** option in the **Compute Block Parameters** submenu is selected, then when you click the **Compute Block Parameters** button the function displays the errors between the specified manufacturer parameters and the obtained parameters are displayed in the command window. This option is selected by default.

If the **Ask me before overwriting rotor type and preset model of selected block** option in the **Apply button** submenu is selected, then when you click the **Apply to selected block** button it gives you a warning if you try to download double squirrel-cage parameters in a selected block that has a squirrel-cage or wound rotor, or if you try to overwrite a selected block using a preset model. This option is selected by default.

## Examples

Consider a three-phase 400 V, 110 kW asynchronous machine with the following manufacturer specification:

<table data-header-hidden><thead><tr><th width="199.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Data</strong></td><td><strong>Values</strong></td></tr><tr><td><strong>Vn</strong></td><td>400 V</td></tr><tr><td><strong>fn</strong></td><td>50 Hz</td></tr><tr><td><strong>In</strong></td><td>194 A</td></tr><tr><td><strong>Tn</strong></td><td>352 N.m</td></tr><tr><td><strong>Nn</strong></td><td>2982 rpm</td></tr><tr><td><strong>Ist/In</strong></td><td>7.6</td></tr><tr><td><strong>Tst/Tn</strong></td><td>2</td></tr><tr><td><strong>Tbr/Tn</strong></td><td>3</td></tr><tr><td><strong>pf</strong></td><td>86%</td></tr></tbody></table>

To obtain the electrical parameters (Rs, Lls, Lm, Rr1, Llr1, Rr2, Llr2) in per unit (pu) for the double cage asynchronous machine model based on this specification, enter the following commands in the MATLAB Command window:

```matlab
spec.Vn = 400;
spec.fn = 50;
spec.In = 194;
spec.Tn = 352;
spec.Ns = 3000;
spec.Nn = 2982;
spec.Ist_In = 7.6;
spec.Tst_Tn = 2;
spec.Tbr_Tn = 3;
spec.pf = 86;

options.DisplayDetails = 1;
options.units = 'p.u.';

[params,spec2,errors] = power_AsynchronousMachineParams(spec,options)
```

You should get the following results:

<pre><code>Asynchronous machine parameter estimation results
-------------------------------------------------------------
Parameter        Specified       Obtained         Error (%)
---------        ---------       ---------        --------- 
In (A)               194         193.991           -0.00
Tn (N.m)             352         352.023            0.01
Ist (A)           1474.4         1474.35           -0.00
Ist/In ()            7.6          7.6001            0.00
Tst (N.m)            704           703.8           -0.03
Tst/Tn ()              2          1.9993           -0.03
Tmax (N.m)          1056            1056            0.00
Tbr/Tn ()             3          2.99981           -0.01
pf (%)               86          85.9949           -0.01

<strong>params =
</strong>        Rs: 0.0303
       Lls: 0.0506
        Lm: 1.9066
     Llr1: 0.0868
      Rr1: 0.0056
     Llr2: 0.0506
      Rr2: 0.0762
 spec2 = 
			fn: 50
			In: 194
			Tn: 352
			Ns: 3000
			Nn: 2982
	Ist_In: 7.6000
	Tst_Tn: 2
	Tbr_Tn: 3
			pf: 86
			Vn: 400
			 p: 1
	cosphi: 0.8600
			we: 314.1593
		 Vin: 230.9401
			sn: 0.0060
		 Ist: 1.4744e+003
		 Tst: 704
		 Tbr: 1056
			Pn: 1.0992e+005
errors = 
				In: -0.0048
				Tn: 0.0066
				pf: -0.0059
			 Ist: -0.0035
		Ist_In: 0.0013
			 Tst: -0.0284
		Tst_Tn: -0.0349
			 Tbr: 2.1990e-004
		Tbr_Tn: -0.0063
	maxError: 0.0349
</code></pre>

To draw torque vs speed and stator current vs speed graphs:

```matlab
options.DrawGraphs = 1;
options.DisplayDetails = 0;
params = power_AsynchronousMachineParams(spec,options);
```

The following figure shows the resulting graph:

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

## References

\[1] Pedra, Joaquin, “On the Determination of Induction Motor Parameters From Manufacturer Data for Electromagnetic Transient Programs.” IEEE Transactions on Power Systems. Vol. 23, Number 4, 2008, pp. 1709–1718.


---

# 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/machines/functions/power_asynchronousmachineparams.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.
