> 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/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/machine-configuration-files/magnetizing-inductance-file-json.md).

# Magnetizing Inductance File \[JSON]

For an **Induction Machine with Saturation**, a JSON file is required to define the saturation characteristics of the machin&#x65;*.* The file must contain the following information:

<table><thead><tr><th width="230.33331298828125">Parameter (JSON key)</th><th width="119.33331298828125">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>NoLoadStatorCurrent</strong></td><td>double[]</td><td><p>I<sub>RMS</sub> (Arms)<br>One dimensional array of root-mean-square stator current values measured under no-load test conditions.</p><p>This array must be the same size as <strong>NoLoadLineToLineVoltage</strong> and can contain up to 33 values. All its values must be greater than zero and strictly increasing. Linear interpolation will be performed by the model to compute values between defined data points.</p></td></tr><tr><td><strong>NoLoadLineToLineVoltage</strong></td><td>double[]</td><td><p>V<sub>LL,RMS</sub> (Vrms)<br>One dimensional array of root-mean-square, line-to-line voltage values measured under no-load test conditions.</p><p>This array must be the same size as <strong>NoLoadStatorCurrent</strong> and can contain up to 33 values. All its values must be strictly increasing. Linear interpolation will be performed by the model to compute values between defined data points.</p></td></tr><tr><td><strong>NoLoadFrequency</strong></td><td>double</td><td>f(Hz)<br>Frequency used during the no-load test. This value cannot be zero.</td></tr><tr><td><strong>NominalStatorLeakageInductance</strong></td><td>double</td><td><p>L<sub>ls</sub> (Henry)<br>Nominal value of the stator leakage inductance calculated using the locked-rotor test.</p><p>If this value is zero, the resulting magnetizing inductance is calculated ignoring the voltage drop in the stator leakage inductance.</p></td></tr></tbody></table>

{% code overflow="wrap" lineNumbers="true" %}

```json
"NoLoadStatorCurrent": [
5.0,
10.0,
17.0
],
"NoLoadLineToLineVoltage":  [
  120.0,
  230.0,
  300.0
],
"NoLoadFrequency": 60,
"NominalStatorLeakageInductance": 0.0008
```

{% endcode %}

{% hint style="info" %}
For additional details about the locked-rotor test and the no-load test, please refer to the [IEEE Standard Test Procedure for Polyphase Induction Motors and Generators (IEEE-112)](https://standards.ieee.org/ieee/112/4807/).
{% endhint %}

**Parameter Constraints**

The following constraints apply to the parameters defined in the file. If the current and voltage measurements are not compatible with the nominal parameters, an error will be thrown.

$$
\frac{V\_{LL,RMS}}{\sqrt{3} , I\_{RMS}} > 2\pi f L\_{ls} \\\[8pt]
$$

{% code overflow="wrap" lineNumbers="true" %}

```json
{
  "NoLoadStatorCurrent": [
    5.0,
    10.0,
    17.0
  ],
  "NoLoadLineToLineVoltage": [
    120.0,
    230.0,
    300.0
  ],
  "NoLoadFrequency": 60,
  "NominalStatorLeakageInductance": 0.0008
}
```

{% endcode %}

An example Magnetizing Inductance File in JSON format is provided here as a template only and does not contain valid simulation data.

{% file src="/files/SrIFnOLb7z6OaLX0MXuF" %}


---

# 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/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/machine-configuration-files/magnetizing-inductance-file-json.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.
