Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

For an Induction Machine with Saturation, a JSON file is required to define the saturation characteristics of the machine. The file must contain the following information:

Parameter (JSON key)

Value typeUnit

Symbol

Data Type

Units

Description

Example

NoLoadStatorCurrent

IRMS

double[]

Arms

One dimensional array of root-mean-square stator current values measured under no-load test conditions.

This array must be the same size as NoLoadLineToLineVoltage

, and

. All its values must be

arranged in ascending order.

greater than zero and strictly increasing.

Code Block
languagejson
"NoLoadStatorCurrent": [


 
 
 5.0,

    
  10.0,

    
  17.0


],

NoLoadLineToLineVoltage

VLL,RMS

double[]

Vrms

One dimensional array of root-mean-square, line-to-line voltage values measured under no-load test conditions.

This array must be the same size as NoLoadStatorCurrent, and its values must be

arranged in ascending order.

strictly increasing.

Code Block
languagejson
"NoLoadLineToLineVoltage":  [


 
 
 120.0,


 
 
 230.0,


  300.0


],

NoLoadFrequency

f

double

Hertz

Frequency used during the no-load test.  This value cannot be zero.

Code Block
languagejson
"NoLoadFrequency": 60,

NominalStatorLeakageInductance

NomicalStatorLeakageInductance

Lls

double

Henry

Nominal value of the stator leakage inductance calculated using the locked-

root

rotor test.

If this value is zero, the resulting magnetizing inductance is calculated ignoring the voltage drop in the stator leakage inductance.

"NominalStatorLeakageInductance": 0.0008,

NominalStatorResistance

doubleOhm

Nominal value of the stator resistance calculated using the locked-root test.

If this value is zero, the resulting magnetizing inductance is calculated ignoring the voltage drop in the stator resistance.

"NominalStatorResistance
Code Block
languagejson
"NominalStatorLeakageInductance": 0.
09
0008

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).

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.

Mathblock
anchorRs
alignmentcenter
--uriencoded--\frac%7BV_%7BLL,RMS%7D%7D%7B\sqrt 3 *I_%7BRMS%7D%7D > 2 \pi fL_%7Bls%7D

...

Example

Code Block
languagejson
{
  "NoLoadStatorCurrent": [

...


    5.0,

...


    10.0,

...


    17.0

...


  ],

...


  "NoLoadLineToLineVoltage": [

...


    120.0,

...


    230.0,

...


    300.0

...


  ],

...


  "NoLoadFrequency": 60,

...


  "NominalStatorLeakageInductance": 0.0008

...


...

}

An example Magnetizing Inductance File in JSON format is available here:

View file
nameMagnetizing Inductance JSON Template.json

Note

This file is intended for use as a template only; it does not contain valid simulation data.