16.1 Volume Element Properties#

Sets volume-element properties used for electromagnetic-field analysis.

Input settings#

16_1_3D_Element_Properties(16.1) JSON key: volume element properties object

MAT_ID(16.1) Volume-element property ID.

POTENTIAL(16.1) Sets the potential region.

MagneticProperty(16.1) Sets magnetic properties.

B_H_CURVE_ID(16.1) B-H curve ID.

MU(16.1) Relative permeability of a linear material.

ANISOTROPY(16.1) Sets anisotropic magnetic properties.

COORD_ID(16.1) Local coordinate-system ID used to define anisotropy.

MU_XYZ(16.1) Relative-permeability factors in the x, y, and z directions of the local coordinate system.

FACTOR_XYZ(16.1) Magnetic-property factors in the x, y, and z directions of the local coordinate system.

PACKING(16.1) Sets the homogenization method

PACKING_FACTOR(16.1) Filling factor for the homogenization method.

PACKING_DIRECTION(16.1) Sets the lamination direction.

BH_CURVE_XYZ(16.1) Sets anisotropic magnetic-property BH curves.

BH_XYZ_ID(16.1) BH-curve IDs in the x, y, and z directions of the local coordinate system.

MU_XYZ(16.1) Relative permeability in the x, y, and z directions of the local coordinate system.

TEMP_DEPEND_BH_CURVE_ID(16.1) Sets a temperature-dependent BH curve.

ANISOTROPY2D(16.1) Sets two-dimensional anisotropic magnetic properties.

BH_XY(16.1) BH-curve ID in the XY plane.

MU_Z(16.1) Relative permeability in the Z direction.

HYSTERESIS(16.1) Sets magnetic hysteresis.

MU_Z(16.1) Relative permeability in the Z direction.

DB_CAL(16.1) Magnetic-flux-density calculation increment.

DB_FACTOR(16.1) Performs nonlinear iterations using DB_CAL multiplied by DB_FACTOR until convergence.

Play_Model(16.1) Sets the play model.

PLAY_ID(16.1) Play-model ID.

B_MIN_LOSS_CORRECTION(16.1) Specifies the lower magnetic flux density limit (T) for rotational hysteresis-loss correction.

J_A_Model(16.1) Sets the Jiles-Atherton model.

MS(16.1) Saturation magnetization (A/m)

K(16.1) Coercive field magnitude (A/m)

C(16.1) Magnetization weighting factor

A(16.1) Anhysteretic form factor (A/m)

ALPHA(16.1) Interdomain coupling coefficient.

MU_COMPLEX(16.1) Sets complex relative permeability.

MU_Re(16.1) Real part.

MU_Re_XYZ(16.1) Real-part factors in the x, y, and z directions of the local coordinate system.

MU_Im(16.1) Imaginary part.

MU_Im_XYZ(16.1) Imaginary-part factors in the x, y, and z directions of the local coordinate system.

IRON_LOSS(16.1) Sets iron-loss calculation.

MASS_DENSITY(16.1) Electrical-steel density of the laminated core.

KE(16.1) Eddy-current-loss coefficient.

KH(16.1) Hysteresis-loss coefficient.

KE_XY(16.1) Eddy-current-loss coefficient in the XY plane.

KH_XYZ(16.1) Hysteresis-loss coefficients in the x, y, and z directions of the local coordinate system.

1D_TYPE(16.1) Specifies the type of one-dimensional post-processing analysis.

THICKNESS(16.1) Specifies the electrical-steel-sheet thickness used for one-dimensional post-processing analysis.

ElectricProperty(16.1) Specifies electric properties.

conductivity(16.1) Specifies conductivity.

SIGMA(16.1) Conductivity.

SIGMA_XYZ(16.1) Conductivity factors in the x, y, and z directions of the local coordinate system.

FACTOR_XYZ(16.1) Conductivity factors in the x, y, and z directions of the local coordinate system.

permittivity(16.1) Specifies relative permittivity.

EPS(16.1) Relative permittivity.

EPS_XYZ(16.1) Relative-permittivity factors in the x, y, and z directions of the local coordinate system.

FACTOR_XYZ(16.1) Relative-permittivity factors in the x, y, and z directions of the local coordinate system.

EPS_COMPLEX(16.1) Sets complex relative permittivity.

EPS_Re(16.1) Real part.

EPS_Re_XYZ(16.1) Real-part factors in the x, y, and z directions of the local coordinate system.

EPS_Im(16.1) Imaginary part.

EPS_Im_XYZ(16.1) Imaginary-part factors in the x, y, and z directions of the local coordinate system.

is_THIN_ELEMENT(16.1) Specifies the region where THIN_ELEMENT is applied.

add_FORCE_for_DYNAMIC_MOTION(16.1) Specifies the region over which electromagnetic force is integrated.

is_RIGID(16.1) Specifies a region whose mesh does not deform during motion of a deforming mesh.

is_DEFORM(16.1) Specifies a region whose mesh deforms during motion of a deforming mesh.

is_DESIGN_DOMAIN(16.1) Specifies the design domain. For pyemsol.

Input format#

Text-format section

Type:

Fixed parameter set 1

Number of rows:

1

Number of parameters:

3

Text format#

* MAT_ID * POTENTIAL * B_H_CURVE_ID * SIGMA * MU * PACKING * ANISOTROPY * IRON_LOSS
     I        I            I            E      E       E     I      I

JSON format#

JSON format from 2024.11#

"16_Material_Properties" :
{
    "EXTEND_TOTAL_for_COIL" : I,
    "16_1_3D_Element_Properties" :
    [
        {
            "MAT_ID" : I,
            "POTENTIAL" : I,
            "ElectricProperty" :
            {
                "conductivity" :
                {
                    "comment" : "SIGMA_XYZ for anisotropic, or isotropic SIGMA if not defined.",
                    "SIGMA" : E,
                    "TEMP_DEPEND_SIGMA_ID" : I,
                    "SIGMA_XYZ" :
                    {
                        "COORD_ID" : I,
                        "FACTOR_XYZ" : [ E, E, E ]
                    }
                }
            },
            "MagneticProperty" :
            {
                "comment" : "MU_XYZ for anisotropic, or isotropic MU if not defined.",
                "MU" : E,
                "MU_XYZ" :
                {
                    "COORD_ID" : I,
                    "FACTOR_XYZ" : [ E, E, E ]
                }
            }
        },
        {
            "MAT_ID" : I,
            "POTENTIAL" : I,
            "ElectricProperty" :
            {
                "conductivity" :
                {
                    "comment" : "SIGMA_XYZ for anisotropic, or isotropic SIGMA if not defined.",
                    "SIGMA" : E,
                    "TEMP_DEPEND_SIGMA_ID" : I
                }
            },
            "MagneticProperty" :
            {
                "comment" : "MU_XYZ for anisotropic, or isotropic MU if not defined.",
                "MU" : E,
                "BH_CURVE_ID" : I
            }
        }
    ]
}

Detailed description#

16_1_3D_Element_Properties#

16_1_3D_Element_Properties(16.1)#

JSON key:: Volume element properties object

MAT_IDS#

MAT_ID(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Data type:: Integer (I)
Description:: Volume-element property ID. The property ID of a volume element in the input mesh (a surface element in two-dimensional analysis).

POTENTIAL#

POTENTIAL(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [2, 1]

Potential region#
Setting value	Description
0: Default	Total-potential region.
>= 1	Reduced-potential region.

The interface between the total-potential and reduced-potential regions is output as surface elements in the t_r_interface file.

Note

Conductor and magnetic-material regions must be in the total-potential region.
A source defined by the external current and magnetic-field source COIL(17.1) must be in a reduced-potential region or outside the analysis region.
When CYCLIC(14) ≠ 0, the potential-region boundary must not overlap a periodic boundary surface.
When reduced potentials are used, the fixed and moving parts must have different POTENTIAL numbers.
When a reduced-potential region is separated by a total-potential region, specify different POTENTIAL numbers.

ElectricProperty#

ElectricProperty(16.1)#

JSON key:: Specifies electric properties.

conductivity#

conductivity(16.1)#

JSON key:: Specifies conductivity.

SIGMA#

SIGMA(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [4, 1]

Isotropic when > 0; anisotropic when < 0.

Data type:

Real number (E)

Unit:

S/m

Description:

Specifies conductivity.

Use SIGMA_XYZ when conductivity is anisotropic.

For nonconductive regions, air regions, and elements into which source currents are entered (ELMCUR(17.2), SDEFCOIL(17.3), PHICOIL(17.4), and DCCURR(17.5)), the input value is ignored and treated as 0.0.

TEMP_DEPEND_SIGMA_ID#

TEMP_DEPEND_SIGMA_ID(16.1)#

Data type:: Integer (I)
Description:: Specifies the temperature-dependent conductivity curve defined by SIGMA_CURVE_ID(21).

Temperature-dependent conductivity curve#
Setting value	Description
0 Default	Does not use a temperature-dependent conductivity curve.
1 or greater	Identifier of `SIGMA_CURVE_ID(21)`.

Additional data: anisotropic conductivity#

SIGMA_XYZ(16.1)#

FACTOR_XYZ(16.1)#

Use SIGMA_XYZ when conductivity is anisotropic.

Text-format section

Fixed parameter set 1#

[row, col] = [1, 2]
Type=I

[row, col] = [2:4, 2]
Type=E

Text format#

* COORDINATE_ID * FX * FY * FZ *
    0          0     1    1

JSON format#

JSON format from 2024.11#

    "SIGMA_XYZ" :
    {
        "COORD_ID" : 0,
        "FACTOR_XYZ" : [ 0.0, 1.0, 1.0 ]
    }

COORD_ID:: Local coordinate-system ID used to define anisotropy. COORD_ID(12)
FACTOR_XYZ:: Conductivity factors in the x, y, and z directions of the local coordinate system (0 <= FACTOR_XYZ <= 1). Specify as an array.

Hint

When only in-plane conductivity is considered as anisotropic conductivity in a laminated core, with filling factor PACKING_FACTOR = 0.95 and the z direction as the lamination direction,

the FACTOR_XYZ value of SIGMA_XYZ can be set to [0.95, 0.95, 0.0].

permittivity#

permittivity(16.1)#

JSON key:: Specifies permittivity.

EPS#

EPS(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [4, 1]

Isotropic when > 0; anisotropic when < 0.

Data type:

Real number (E)

Description:

Relative permittivity.

Use EPS_XYZ when relative permittivity is anisotropic.

Effective for electromagnetic-field analysis including dielectrics. Used when running Darwin-model or full-wave frequency-domain analysis.

Additional data: anisotropic relative permittivity#

EPS_XYZ(16.1)#

FACTOR_XYZ(16.1)#

Use EPS_XYZ when relative permittivity is anisotropic.

Text-format section

Fixed parameter set 1#

[row, col] = [1, 2]
Type=I

[row, col] = [2:4, 2]
Type=E

Text format#

* COORDINATE_ID * FX * FY * FZ *
    0          0     1    1

JSON format#

JSON format from 2024.11#

    "EPS_XYZ" :
    {
        "COORD_ID" : 0,
        "FACTOR_XYZ" : [ 0.0, 1.0, 1.0 ]
    }

COORD_ID:: Local coordinate-system ID used to define anisotropy. COORD_ID(12)
FACTOR_XYZ:: Relative-permittivity factors in the x, y, and z directions of the local coordinate system (0 <= FACTOR_XYZ <= 1). Specify as an array.

MagneticProperty#

MagneticProperty(16.1)#

JSON key:: Specifies magnetic properties.

MU#

MU(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [5, 1]

Isotropic when > 0; anisotropic when < 0.

Data type:

Real number (E)

Description:

Relative permeability of a linear material. It is 1.0 for nonmagnetic materials and air regions.

Ignored for nonlinear materials (BH_CURVE_ID > 0).

Note

For elements handling sources of the ELMCUR(17.2) or SDEFCOIL(17.3) type, it must be set to 1.0.

Additional data: anisotropic linear relative permeability#

MU_XYZ(16.1)#

FACTOR_XYZ(16.1)#

Use MU_XYZ when linear relative permeability is anisotropic.

Text-format section

Fixed parameter set 1#

[row, col] = [1, 2]
Type=I

[row, col] = [2:4, 2]
Type=E

Text format#

* COORDINATE_ID * FX * FY * FZ *
    0          0     1    1

JSON format#

JSON format from 2024.11#

    "MU_XYZ" :
    {
        "COORD_ID" : 0,
        "FACTOR_XYZ" : [ 0.0, 1.0, 1.0 ]
    }

COORD_ID:: Local coordinate-system ID used to define anisotropy. COORD_ID(12)
FACTOR_XYZ:: Linear-permeability factors in the x, y, and z directions of the local coordinate system (0 <= FACTOR_XYZ <= 1). Specify as an array.

BH_CURVE_ID#

B_H_CURVE_ID(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [3, 1]

B-H curve ID#
Setting value	Description
= 0: Default	Uses relative permeability
> 0	Nonlinear material. For nonlinear calculation (`NON_LINEAR(2)` = 1), specifies the B-H curve ID `BH_CURVE_ID(20)` to use.

Note

Ignored for linear analysis (NON_LINEAR(2) = 0).
Ignored when ANISOTROPY(16.1) = 1, 4, or 5.

PACKING#

PACKING(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [6, 1]
Type=E

= 1.0: solid magnetic material
< 1.0: filling factor of a laminated core

Sets the filling factor of a laminated core using the homogenization method (a material laminated from nonlinear materials). The magnetic properties of the electrical steel sheets are isotropic.

This has no effect for linear materials (BH_CURVE_ID = 0); specify anisotropy through the anisotropy of MU.

Text-format section

Fixed parameter set 1#

[row, col] = [2, 4]
Type=I

[row, col] = [3, 4]
Type=E

Text format#

* COORD_ID * DX(DR) * DY(DT) * DZ *
    1          1       0      0

JSON format from 2024.11#

    "PACKING" :
    {
        "PACKING_FACTOR" : 0.96,
        "COORD_ID" : 1,
        "PACKING_DIRECTION" : [ 1.0, 0.0, 0.0 ]
    }

PACKING_FACTOR(16.1)#

COORD_ID(16.1)#

PACKING_DIRECTION(16.1)#

PACKING_FACTOR:: Filling factor of a laminated core. 0 < PACKING_FACTOR < 1.0
COORD_ID:: Local coordinate-system ID. COORD_ID(12)
PACKING_DIRECTION:: Components of the unit vector in the lamination direction in the COORD_ID coordinate system. The lamination direction is normal to the laminated-sheet surface.

ANISOTROPY#

ANISOTROPY(16.1)#

Text-format section

Fixed parameter set 1#

[row, col] = [7, 1]

Data type:: Integer (I)

Anisotropic magnetic properties#
Value	Description
0 (Default)	Uses isotropic `MU` and `B_H_CURVE_ID`
1	Independent nonlinear magnetic anisotropy in three directions
2	Temperature-dependent magnetization properties
3	Two-dimensional magnetization anisotropy
4	Hysteresis magnetic anisotropy using the Jiles-Atherton model
5	Hysteresis magnetic anisotropy using the play model

Additional data: ANISOTROPY = 1#

BH_CURVE_XYZ(16.1)#

JSON key:: BH_CURVE_XYZ

Text-format section

Fixed parameter set 1#

[row, col] = [1, 2]
Type=I

[row, col] = [2, 4]
Type=E

Text format#

* COORD_ID * BH_X * BH_Y * BH_Z * MU_X * MU_Y * MU_Z *
    0      0     1     1                1               0              1

JSON format#

JSON format from 2024.11#

    "BH_CURVE_XYZ" :
    {
        "comment" : "ANISOTROPY=1",
        "COORD_ID" : 0,
        "BH_XYZ_ID" : [ 0, 1, 1 ],
        "MU_XYZ" : [ 1.0, 0.0, 0.0 ]
    }

Inputs independent nonlinear magnetic properties in three directions.

Disabled for linear calculation. B_H_CURVE_ID, MU, and PACKING have no effect.

COORD_ID(16.1)#

BH_XYZ_ID(16.1)#

MU_XYZ(16.1)#

COORD_ID:: Coordinate-system ID defining the directions: COORD_ID(12)
BH_XYZ_ID:: Specifies the B-H curve ID BH_CURVE_ID(20) in the XYZ (Rθz) directions.
MU_XYZ:: Linear relative permeability in the XYZ (Rθz) directions. Effective when BH_XYZ_ID = 0.

Additional data: ANISOTROPY = 2#

TEMP_DEPEND_BH_CURVE_ID(16.1)#

Inputs temperature-dependent magnetization properties. Set T_DEPEND_B_H_MAGNET_CURVE_ID(20.2). Disabled for linear calculation.

MU(16.1) and PACKING(16.1) have no effect.

See the settings for 20_2_TempDepend_B_H_Curve(20) (temperature-dependent magnetization properties).

Note

The < TEMP_DEPEND module > is required.

Additional data: ANISOTROPY = 3#

ANISOTROPY2D(16.1)#

JSON key:: ANISOTROPY2D

Text-format section

Fixed parameter set 1#

[row, col] = [2, 4]
Type=I,E

Text format#

* COORD_ID * B_H_xy * B_H_z * MU_z *
    0        1        0    100.

JSON format#

JSON format from 2024.11#

    "ANISOTROPY2D" :
    {
        "comment" : "ANISOTROPY=3",
        "COORD_ID" : 0,
        "BH_XY" : 1,
        "MU_Z" : 1.0
    },

    "ANISOTROPY2D" :
    {
        "comment" : "ANISOTROPY=3",
        "COORD_ID" : 0,
        "BH_XY" : 1,
        "BH_Z" : 2
    }

Inputs nonlinear two-dimensional magnetization anisotropy properties, independent of the third axis. Disabled for linear calculation.

B_H_CURVE_ID, MU, and PACKING have no effect.

COORD_ID(16.1)#

BH_XY(16.1)#

BH_Z(16.1)#

MU_Z(16.1)#

COORD_ID:: Coordinate-system ID defining the directions: COORD_ID(12)
BH_XY:: Two-dimensional in-plane magnetization anisotropy data ID. Specifies BH_CURVE2D_ID(20).
BH_Z:: Specifies the B-H curve ID BH_CURVE_ID(20) in the Z direction.
MU_Z:: Linear relative permeability in the Z direction. Effective when BH_Z = 0.

Specify either BH_Z or MU_Z.

Note

The < Anisotropy2D module > is required.

Additional data: ANISOTROPY = 4 or 5#

HYSTERESIS(16.1)#

JSON key:: HYSTERESIS

Text-format section

Fixed parameter set 1#

[row, col] = [2, 4]
Type=I,E

Text format#

* COORDINATE_ID  *  MYUZ  *  DB_CAL *
    0                 1.0      0.001

JSON format#

JSON format from 2024.11#

    "HYSTERESIS" :
    {
        "COORD_ID" : 0,
        "MU_Z" : 1.0,
        "DB_CAL" : 0.001,
    }

Inputs hysteresis magnetic-anisotropy properties using anisotropy with the Jiles-Atherton model or play model.

COORD_ID(16.1)#

MU_Z(16.1)#

DB_CAL(16.1)#

COORD_ID:: Coordinate-system ID defining the directions (12.2): COORD_ID(12). For materials with two-dimensional hysteresis properties, it specifies the Z direction to which MU_Z is applied. It does not affect results for materials with isotropic three-dimensional hysteresis properties.
MU_Z:: Linear relative permeability in the Z direction.
DB_CAL:: Magnetic-flux-density calculation increment.

B_H_CURVE_ID, MU, and PACKING have no effect.

COORD_ID:: Coordinate-system ID defining the directions: COORD_ID(12)
BH_XY:: Two-dimensional in-plane magnetic-anisotropy data ID. Specifies BH_CURVE2D_ID(20).
BH_Z:: Specifies the B-H curve ID BH_CURVE_ID(20) in the Z direction.
MU_Z:: Linear relative permeability in the Z direction. Effective when BH_Z = 0.

Additional data: ANISOTROPY = 4#

J_A_Model(16.1)#

JSON key:: J_A_Model

Text-format section

Fixed parameter set 1#

[row, col] = [3,4, 4]
Type=E

Text format#

*X*  MS   *  K  *  C *  A    *   ALPHA *
    1.67e6   82.     0.1     50.      49.07e-6
*Y*  MS   *  K  *  C *  A    *   ALPHA *
    1.67e6   82.     0.1     50.      49.07e-6

JSON format#

JSON format from 2024.11#

    "HYSTERESIS" :
    {
        "COORD_ID" : 0,
        "MU_Z" : 1.0,
        "DB_CAL" : 0.001,
        "J_A_Model" :
        {
            "comment" : "ANISOTROPY=4",
            "MS" : [ 1.67e+06, 1.67e+06 ],
            "K" : [ 8.2e+01, 8.2e+01 ],
            "C" : [ 1.0e-01, 1.0e-01 ],
            "A" : [ 5.0e+01, 5.0e+01 ],
            "ALPHA" : [ 4.907e-05, 4.907e-05 ]
        }
    }

Inputs hysteresis magnetic-anisotropy properties using the Jiles-Atherton model. Inputs the Jiles-Atherton model parameters.

B_H_CURVE_ID(16.1), MU(16.1), and PACKING(16.1) have no effect.

MS(16.1)#

K(16.1)#

C(16.1)#

A(16.1)#

ALPHA(16.1)#

MS:: Saturation magnetization (A/m)
K:: Coercive field magnitude (A/m)
C:: Magnetization weighting factor
A:: Anhysteretic form factor (A/m)
ALPHA:: Interdomain coupling coefficient

The < Jiles-Atherton model module > is required.

Additional data: ANISOTROPY = 5#

Play_Model(16.1)#

JSON key:: Play_Model

Text-format section

Fixed parameter set 1#

[row, col] = [3,4, 4]
Type=E

Text format#

* COORD_ID  *  MU_Z  *  DB_CAL * PLAY_ID * DB_FACTOR * MATERIAL * B_MIN_LOSS_CORRECTION  *
    0            1.0       0.01       1

JSON format#

JSON format from 2024.11#

    "HYSTERESIS" :
    {
        "COORD_ID" : 0,
        "MU_Z" : 1.0,
        "DB_CAL" : 0.001,
        "Play_Model" :
        {
            "comment" : "ANISOTROPY=5",
            "PLAY_ID" : 1,
            "DB_FACTOR" : 0.0,
            "B_MIN_LOSS_CORRECTION" : 0.0
        }
    }

Considers isotropic two- or three-dimensional and anisotropic two-dimensional hysteresis properties using the play model.

A table of hysteron shape functions must also be provided in a shape file. Set the two- or three-dimensional type in the shape file: specify = 3 after PLAY_ID for three-dimensional properties; omit it or specify = 2 for two-dimensional play-model properties.

B_H_CURVE_ID, MU, and PACKING have no effect.

PLAY_ID(16.1)#

DB_FACTOR(16.1)#

B_MIN_LOSS_CORRECTION(16.1)#

PLAY_ID:: Play-model ID.
DB_FACTOR:: Stops the calculation when DB_CAL becomes greater than DB_CAL * DB_FACTOR.
B_MIN_LOSS_CORRECTION:: Specifies the lower magnetic flux density limit (T) for rotational hysteresis-loss correction.

The <HYSTERESIS module> is required.

<For steady-state AC analysis (AC(2) = 2)>#

Additional data: ANISOTROPY = 1#

MU_COMPLEX(16.1)#

JSON key:: MU_COMPLEX

Text-format section

Fixed parameter set 1#

[row, col] = [2, 2]
Type=E

Text format#

* MU_Re *  MU_Im *
    202   80

JSON format#

JSON format from 2024.11#

    "MU_COMPLEX" :
    {
        "comment" : "AC=2, ANISOTROPY=1",
        "MU_Re" : 202,
        "MU_Im" : 80
    }

Inputs the relative permeability of the real and imaginary parts of complex permeability.

MU_Re(16.1)#

MU_Im(16.1)#

MU_Re:: Relative permeability of the real part of complex permeability
MU_Im:: Imaginary part of complex relative permeability

Complex relative permeability is defined as follows. A dot denotes a complex number.

(1)#\[\dot{\mu} = \mu' - j\mu''\]

—

EPS_COMPLEX(16.1)#

JSON key:: EPS_COMPLEX

Text-format section

Fixed parameter set 1#

[row, col] = [2, 2]
Type=E

Text format#

* EPS_Re *  EPS_Im *
    4.4   0.05

JSON format#

JSON format from 2024.11#

    "EPS_COMPLEX" :
    {
        "comment" : "AC=2, ANISOTROPY=1",
        "EPS_Re" : 4.4,
        "EPS_Im" : 0.05
    }

Inputs the relative permittivity of the real and imaginary parts of complex permittivity.

EPS_Re(16.1)#

EPS_Im(16.1)#

EPS_Re:: Relative permittivity of the real part of complex permittivity
EPS_Im:: Relative permittivity of the imaginary part of complex permittivity

Complex permittivity is defined as follows. A dot denotes a complex number.

(2)#\[\dot{\varepsilon} = \varepsilon' - j\varepsilon''\]

Note

Release_2026_09

Complex permittivity is used for the Darwin approximation (AC(2) = 3, 5).

Additional data: ANISOTROPY = 2#

JSON key:: MU_COMPLEX

Inputs complex relative permeability with anisotropy in three directions.

Text-format section

Fixed parameter set 1#

[row, col] = [2, 2]
Type=E

Text format#

* COORD_ID  * MU_X(Re) * MU_X(Im) * MU_Y(Re) * MU_Y(Im) * MU_Z(Re) * MU_Z(Im) *
    0         4.4         0.05        4.4         0.05        2.2         0.01

JSON format#

JSON format from 2024.11#

    "MU_COMPLEX" :
    {
        "comment" : "AC=2, ANISOTROPY=2",
        "COORD_ID" : 0,
        "MU_Re_XYZ" : [ 4.4, 4.4, 2.2 ],
        "MU_Im_XYZ" : [ 0.05, 0.05, 0.01 ]
    }

Inputs the relative permeability of the real and imaginary parts of complex permeability.

MU_Re_XYZ(16.1)#

MU_Im_XYZ(16.1)#

MU_Re_XYZ:: Relative permeability of the real part of anisotropic complex relative permeability
MU_Im_XYZ:: Relative permeability of the imaginary part of anisotropic complex relative permeability

—

JSON key:: EPS_COMPLEX

Inputs complex permittivity with anisotropy in three directions.

Text-format section

Fixed parameter set 1#

[row, col] = [2, 2]
Type=E

Text format#

* COORD_ID  * EPS_X(Re) * EPS_X(Im) * EPS_Y(Re) * EPS_Y(Im) * EPS_Z(Re) * EPS_Z(Im) *
    0         202         80        202         80        101         40

JSON format#

JSON format from 2024.11#

    "EPS_COMPLEX" :
    {
        "comment" : "AC=2, ANISOTROPY=2",
        "COORD_ID" : 0,
        "EPS_Re_XYZ" : [ 202, 202, 101 ],
        "EPS_Im_XYZ" : [ 80, 80, 40 ]
    }

Inputs the relative permittivity of the real and imaginary parts of complex permittivity.

EPS_Re_XYZ(16.1)#

EPS_Im_XYZ(16.1)#

EPS_Re_XYZ:: Relative permittivity of the real part of anisotropic complex permittivity
EPS_Im_XYZ:: Relative permittivity of the imaginary part of anisotropic complex permittivity

Note

Release_2026_09

Complex permittivity is used for the Darwin approximation (AC(2) = 3, 5).

IRON_LOSS#

IRON_LOSS(16.1)#

JSON key:: IRON_LOSS

Additional data: IRON_LOSS = 1#

Text-format section

Fixed parameter set 1#

[row, col] = [8, 1]
Type=I

Text format#

* COORD_ID  * MASS_DENSITY *  KE   *  KH  *
    0            7.85e3     2.923e-4    6.012e-2

JSON format#

JSON format from 2024.11#

    "IRON_LOSS" :
    {
        "COORD_ID" : 0,
        "MASS_DENSITY" : 7850,
        "KE" : 2.923e-4,
        "KH" : 6.012e-2
    }

Sets the parameters required to calculate iron loss.

COORD_ID(16.1)#

MASS_DENSITY(16.1)#

KE(16.1)#

KH(16.1)#

COORD_ID:: Coordinate-system ID defining the directions (12.2). COORD_ID(12)
MASS_DENSITY:: Steel-sheet density of the laminated core (kg/m³).
KE:: Eddy-current-loss coefficient \(K_e\) (W/kg/T²/Hz²).
KH:: Hysteresis-loss coefficient \(K_h\) (W/kg/T²/Hz).

Additional data: IRON_LOSS = 2#

Text-format section

Fixed parameter set 1#

[row, col] = [8, 1]
Type=I

Text format#

* COORD_ID  * MASS_DENSITY *  KE(X) * KH(X) * KE(Y) * KH(Y) * KH(Z)  *
    0            E             E       E      E       E        E

JSON format#

JSON format from 2024.11#

    "IRON_LOSS" :
    {
        "COORD_ID" : 0,
        "MASS_DENSITY" : 7850,
        "KE_XY" : [ 2.923e-4, 1.411e-4]
        "KH_XYZ" : [ 6.012e-2, 6.012e-2, 3.006e-2 ]
    }

Sets the parameters required to calculate iron loss.

COORD_ID(16.1)#

MASS_DENSITY(16.1)#

KE_XY(16.1)#

KH_XYZ(16.1)#

COORD_ID:: Coordinate-system ID defining the directions (12.2). COORD_ID(12)
MASS_DENSITY:: Steel-sheet density of the laminated core (kg/m³).
KE_XY:: Eddy-current-loss coefficient in the XY plane, \(K_e\) (W/kg/T²/Hz²).
KH_XYZ:: Hysteresis-loss coefficients in the x, y, and z directions of the local coordinate system, \(K_h\) (W/kg/T²/Hz).

Specify KE_XY and KH_XYZ as arrays.

Note

Using the eddy-current-loss coefficient \(K_e\), hysteresis-loss coefficient \(K_h\), measured frequencies \(f\), magnetic flux densities \(B\), and iron losses \(W_i\), create an \(f\) (Hz) versus \(W_i / f\) (W/kg/Hz) graph at a representative magnetic flux density (for example, \(B_m = 1\) T) based on loss separation. Enter the slope of its linear approximation as \(K_e\) and the intercept as \(K_h\).

Additional data: IRON_LOSS = -1#

Text-format section

Fixed parameter set 1#

[row, col] = [8, 1]
Type=I

Text format#

* COORD_ID  * MASS_DENSITY *  KE   *  KH  * THICKNESS * 1D_TYPE *
    0            7.85e3     2.923e-4    6.012e-2    0.005      0

JSON format#

JSON format from 2026.09#

    "IRON_LOSS" :
    {
        "COORD_ID" : 0,
        "MASS_DENSITY" : 7850,
        "KE" : 2.923e-4,
        "KH" : 6.012e-2,
        "THICKNESS" : 0.005,
        "1D_TYPE" : 0
    }

Sets the parameters required to calculate iron loss.

COORD_ID(16.1)#

MASS_DENSITY(16.1)#

KE(16.1)#

KH(16.1)#

THICKNESS(16.1)#

1D_TYPE(16.1)#

COORD_ID:: Coordinate-system ID defining the directions (12.2). COORD_ID(12)
MASS_DENSITY:: Steel-sheet density of the laminated core (kg/m³).
KE:: Eddy-current-loss coefficient \(K_e\) (W/kg/T²/Hz²).
KH:: Hysteresis-loss coefficient \(K_h\) (W/kg/T²/Hz).
THICKNESS:: Specifies the electrical-steel-sheet thickness used for one-dimensional post-processing analysis.
1D_TYPE:: Specifies the type of one-dimensional post-processing analysis. = 0: nonlinear analysis; = 1: linear analysis using differential permeability.

Note

Release_2026_09

Added 1D_TYPE for one-dimensional post-processing analysis.

Additional data: is_THIN_ELEMENT = 1#

is_THIN_ELEMENT(16.1)#

JSON key:: is_THIN_ELEMENT

= 1: Specifies the element-property IDs to which THIN_ELEMENT is applied.

The THIN_CRITERION(16) setting is required.

Additional data: add_FORCE_for_DYNAMIC_MOTION = 1#

add_FORCE_for_DYNAMIC_MOTION(16.1)#

JSON key:: add_FORCE_for_DYNAMIC_MOTION

= 1: Specifies the element-property IDs for electromagnetic force integration region (18.6.4).

The total-potential region must be defined for this region and through one element layer outside it.

Additional data: is_RIGID = 1#

is_RIGID(16.1)#

JSON key:: is_RIGID

= 1: During deforming-mesh motion DEFORM_MOTION(19.3), specifies the element-property IDs of regions that move without mesh deformation.

When using COIL(17.1), specifies the element-property IDs within the total-potential region.

Additional data: is_DEFORM = 1#

is_DEFORM(16.1)#

JSON key:: is_DEFORM

= 1: During deforming-mesh motion DEFORM_MOTION(19.3), specifies the element-property IDs of regions whose mesh deforms.

When using COIL(17.1), specifies the element-property IDs of air regions within the total-potential region.

Additional data: is_DESIGN_DOMAIN = 1#

is_DESIGN_DOMAIN(16.1)#

JSON key:: is_DESIGN_DOMAIN

= 1: Specifies the properties whose material properties are updated by pyemsol.

See Running Parameter Surveys for an example.

16.1 Volume Element Properties

Contents

16.1 Volume Element Properties#

Input settings#

Input format#

JSON format#

Detailed description#

16_1_3D_Element_Properties#

MAT_IDS#

POTENTIAL#

ElectricProperty#

conductivity#

SIGMA#

TEMP_DEPEND_SIGMA_ID#

Additional data: anisotropic conductivity#

JSON format#

permittivity#

EPS#

Additional data: anisotropic relative permittivity#

JSON format#

MagneticProperty#

MU#

Additional data: anisotropic linear relative permeability#

JSON format#

BH_CURVE_ID#

PACKING#

ANISOTROPY#

Additional data: ANISOTROPY = 1#

JSON format#

Additional data: ANISOTROPY = 2#

Additional data: ANISOTROPY = 3#

JSON format#

Additional data: ANISOTROPY = 4 or 5#

JSON format#

Additional data: ANISOTROPY = 4#

JSON format#

Additional data: ANISOTROPY = 5#

JSON format#

<For steady-state AC analysis (AC(2) = 2)>#

Additional data: ANISOTROPY = 1#

JSON format#

JSON format#

Additional data: ANISOTROPY = 2#

JSON format#

JSON format#

IRON_LOSS#

Additional data: IRON_LOSS = 1#

JSON format#

Additional data: IRON_LOSS = 2#

JSON format#

Additional data: IRON_LOSS = -1#

JSON format#

Additional data: is_THIN_ELEMENT = 1#

Additional data: add_FORCE_for_DYNAMIC_MOTION = 1#

Additional data: is_RIGID = 1#

Additional data: is_DEFORM = 1#

Additional data: is_DESIGN_DOMAIN = 1#