11. Output options#
Specifies the items written to the output files output and output.json. Physical quantities summed for each material ID are written to output.
Note
Revision history
Support for output.json output through EMSOJson
Changed the output.json format through EMSOJson
Input settings#
11_Print_Output JSON key: output options object
MESH(11) Outputs detailed model mesh information (nodes, elements, and so on) for checking.
A(11) Outputs line integrals of the magnetic vector potential over all edges, for checking.
V(11) Outputs the electric scalar potential at all nodes, for checking.
B_INTEG(11) Output option for spatial magnetic flux density (T) due to magnetization and current.
X_SYMMETRY(11)Boundary condition setting for the x = 0 plane.
Y_SYMMETRY(11)Boundary condition setting for the y = 0 plane.
Z_SYMMETRY(11)Boundary condition setting for the z = 0 plane.
ROTATIONAL_SYMMETRY(11)Rotational symmetry order about the z-axis.
NO_POINTS(11)Number of calculation points specified by coordinates.
NO_MAT_IDS(11)Number of material IDs used for integration.
NO_COIL_SERIES(11)Number ofCOIL(17.1)entries used for integration.
INTEG_OPTION(11)Integration-point option.
INPUT_MESH(11)Option for B_integ_mesh.
HEAT(11) Output option for heat generation (W) for all conductors and each material.
MAG_FLUX(11) Output option for magnetic flux (Wb) linking a closed curve.
NO_LOOPS(11)Number of closed-curve loops to calculate.
READ_OPTION(11)Method for specifying closed curves.
NO_NODES(11)Number of nodes that form a loop.
NODE_IDS(11)Enter the node IDs traversed by the loop in sequence.
LINE_MAT_IDS(11)Line-element material IDs defining each loop.
SMAT_IDS(11)Surface-element material IDs for the cross section of linking flux.
CUR_FLUX(11) Output option for current (A) passing through a surface.
WRITE_OPTION(11)Output format for current passing through a surface.
NO_SURFACES(11)Surface elements used to calculate passing current.
FORCE_J_B(11) Output option for Lorentz force.
FORCE_NODAL(11) Output option for nodal force.
MAGNETIC_ENERGY(11) Output option for magnetic energy.
IRON_LOSS(11) Output option for iron loss.
GAP_B(11) Output option for magnetic flux density (T) in an air gap.
CHECK_PERMEANCE(11) Output option for permanent-magnet permeance.
Input format#
Text-format section
Important
B, J_Q, and Q_AVERAGE are not used.
JSON format#
"11_Print_Output" :
{
"MESH" : I,
"A" : I,
"V" : I,
"B_INTEG" : { },
"HEAT" : I,
"MAG_FLUX" : { },
"CUR_FLUX" : { },
"FORCE_J_B" : I,
"FORCE_NODAL" : I,
"MAGNETIC_ENERGY" : I,
"IRON_LOSS" : I
},
Important
Because B, J_Q, and Q_AVERAGE are not used, they are omitted in JSON format.
In JSON format, these parameters use their default values when omitted. See the detailed descriptions for the default values.
Detailed description#
Specifies the items written to the output files output and output.json. Bold items are commonly used.
Text-format section
[row, col] = [1, 6]
Type=I
- 11_Print_Output#
- JSON key:
Output options object
MESH#
- MESH(11)#
Text-format section
[row, col] = [1, 1]
Output option |
Description |
|---|---|
0 |
Do not output |
1 |
Outputs detailed model mesh information (nodes, elements, and so on), for checking. |
A#
- A(11)#
Text-format section
[row, col] = [1, 2]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs line integrals of the magnetic vector potential over all edges |
V#
- V(11)#
Text-format section
[row, col] = [1, 3]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs the electric scalar potential at all nodes |
B_INTEG#
- B_INTEG(11)#
Text-format section
[row, col] = [1, 5]
Outputs spatial magnetic flux density (T) due to magnetization and current. Also supports two-dimensional translational-symmetry analysis. This is the integral of fields due to magnetization and current (eddy current, ELMCUR(17.2), SDEFCOIL(17.3), PHICOIL(17.4), DCCURR(17.5), SUFCUR(17.6), and COIL(17.1)). Additional data is required.
Also supports two-dimensional translational-symmetry analysis (GEOMETRY(12) = 1)
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Output with 6 significant digits |
2 |
Output with 9 significant digits |
3 |
Output with 16 significant digits |
Equation: [EQ1]
Additional data#
Sets symmetry conditions equivalent to those of the FEM model for B_INTEG and COIL_FORCE(10.3).
Sets the calculation-point coordinates.
Text-format section
- Type:
Fixed parameter set
- Number of rows:
2
- Number of parameters:
4, 4
* SYMMETRY * ROTATION *
I(-1,0,1)
- Type:
Fixed parameter set
- Number of rows:
2
- Number of parameters:
4
* IDS * NO_COIL_SERIES * INTEG_OPTION *
I I I I(0,1)
Example
* X_SYMMETRY * Y_SYMMETRY * Z_SYMMETRY * ROTATIONAL_SYMMETRY *
1 1 -1 1
* NO_POIMTS * NO_MATIDS * NO_COIL_SERIES * INTEG_OPTION * INPUT_MESH *
3 1 1 0
* XP * YP * ZP *
0.01, 0.0, 0.0
0.01, 0.0, 0.01
0.01, 0.0, 0.02
* MAT_IDS *
1
* COIL_SERIES *
1
JSON format#
"B_INTEG" :
{
"X_SYMMETRY" : I,
"Y_SYMMETRY" : I,
"Z_SYMMETRY" : I,
"ROTATIONAL_SYMMETRY" : I,
"B_INTEG_WIDE" : I,
"INTEG_OPTION" : I,
"INPUT_MESH" : I,
"POINTS" :
[
[ E, E, E ]
],
"MAT_IDS" : [ I ],
"COIL_SERIES" : [ I ]
}
Example
"B_INTEG" :
{
"X_SYMMETRY" : 1,
"Y_SYMMETRY" : 1,
"Z_SYMMETRY" : -1,
"ROTATIONAL_SYMMETRY" : 1,
"B_INTEG_WIDE" : 2,
"INTEG_OPTION" : 0,
"INPUT_MESH" : 0,
"POINTS" :
[
[ 0.01, 0.0, 0.0 ],
[ 0.01, 0.0, 0.01 ],
[ 0.01, 0.0, 0.02 ]
],
"MAT_IDS" : [ 1 ],
"COIL_SERIES" : [ 1 ]
}
Important
In JSON format, these parameters use their default values when omitted. See the detailed descriptions for the default values.
X_SYMMETRY#
- X_SYMMETRY(11)#
Text-format section
[row, col] = [1, 1]
Output option |
Description |
|---|---|
0 Default |
No symmetry with respect to the x = 0 plane. |
1 |
The x = 0 plane is a symmetry plane with \(\pmb{B}_n = 0\). |
-1 |
The x = 0 plane is a symmetry plane with \(\pmb{H}_t = 0\). |
Y_SYMMETRY#
- Y_SYMMETRY(11)#
Text-format section
[row, col] = [1, 2]
Output option |
Description |
|---|---|
0 Default |
No symmetry with respect to the y = 0 plane. |
1 |
The y = 0 plane is a symmetry plane with \(\pmb{B}_n = 0\). |
-1 |
The y = 0 plane is a symmetry plane with \(\pmb{H}_t = 0\). |
Z_SYMMETRY#
- Z_SYMMETRY(11)#
Text-format section
[row, col] = [1, 3]
Output option |
Description |
|---|---|
0 Default |
No symmetry with respect to the z = 0 plane. |
1 |
The z = 0 plane is a symmetry plane with \(\pmb{B}_n = 0\). |
-1 |
The z = 0 plane is a symmetry plane with \(\pmb{H}_t = 0\). |
ROTATIONAL_SYMMETRY#
- ROTATIONAL_SYMMETRY(11)#
Text-format section
[row, col] = [1, 4]
- Data type:
Integer (I)
- Description:
Rotational symmetry order about the z-axis. When the model is rotated about the z-axis by 2 \(\pi\) /
ROTATION, the magnetic field coincides. For a negative value, the magnetic field reverses. Set this to 1 when there is no rotational symmetry.- Default value:
1
Text-format section
- NO_POINTS(11)#
NO_POINTS
[row, col] = [2, 1]
Type=I
Number of calculation points specified by XP, YP, and ZP coordinates.
- NO_MAT_IDS(11)#
NO_MAT_IDS
[row, col] = [2, 2]
Type=I
Number of material IDs used for integration.
- Default value:
0
- NO_COIL_SERIES(11)#
NO_COIL_SERIES
[row, col] = [2, 3]
Type=I
Number of external current and magnetic-field sources, COIL, used for integration.
- Default value:
0
POINTS#
- POINTS(11)#
- Data type:
Integer array (I)
- Description:
Sets calculation-point coordinates as an array.
MAT_IDS#
- MAT_IDS(11)#
- Data type:
Integer array (I)
- Description:
Sets the material IDs
MAT_ID(16.1)used for integration as an array.
COIL_SERIES#
- COIL_SERIES(11)#
- Data type:
Integer array (I)
- Description:
Sets the
COIL(17.1)entries used for integration as an array.
B_INTEG_WIDE#
- B_INTEG_WIDE(11)#
- Data type:
Integer (I)
- Description:
Specifies the output format for
B_INTEGandCOIL_FORCE(10.3).
Setting |
Description |
|---|---|
0 Default |
Outputs in the standard format. |
1 |
Outputs in the standard format (same as 0). |
2 |
Outputs in the extended format. |
INTEG_OPTION#
- INTEG_OPTION(11)#
Text-format section
[row, col] = [2, 4]
Output option |
Description |
|---|---|
0 Default |
Integrates magnetization or current at element Gauss points. |
1 |
Performs integration only at element centers. |
Applied to magnetic-field calculations and COIL(17.1) electromagnetic-force calculations.
INPUT_MESH#
- INPUT_MESH(11)#
Text-format section
[row, col] = [2, 5]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Uses node data in the B_integ_mesh file as calculation points for |
The mesh file format must be the same as INPUT_MESH_FILE(10.1). It can be used even when MESHLESS(10.1) is not 1. In a COIL(17.1)-only analysis, COIL geometry data is output to post_geom when MESH(10.3) = 1.
Caution
When MOTION(2) is used, calculation points are evaluated in the global (stationary) coordinate system.
Note
Revision history
Supports two-dimensional translational-symmetry analysis (GEOMETRY(12) = 1) and MOTION(2).
HEAT#
- HEAT(11)#
Text-format section
[row, col] = [2, 2]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs heat generation (W) for all conductors and each material |
Equation: [EQ2]
MAG_FLUX#
- MAG_FLUX(11)#
Text-format section
[row, col] = [2, 3]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs magnetic flux (Wb) linking a closed curve |
2 |
For surface-element input, also outputs the average magnetic flux density obtained by dividing linking flux by area. |
Equation: [EQ3]
Additional data#
Configures the closed-curve option for calculating linking flux.
Text-format section
- Type:
Fixed parameter set
- Number of rows:
2 (3)
- Number of parameters:
2, (1), N
Node input
Text format#* NO_LOOPS * READ_OPTION * I 0 * NO_NODES * I * NODE_IDS * I, ...
Line-element input
* NO_LOOPS * READ_OPTION *
I 1
* LINE_MAT_ID *
I
Surface-element input
* NO_LOOPS * READ_OPTION *
I 2
* SMAT_ID *
I
JSON format#
Node input
"MAG_FLUX" :
{
"LOOP_NODES" :
[
[ I ]
]
}
Line-element input
"MAG_FLUX" :
{
"LOOP_EDGS" : [ I ]
}
Surface-element input
"MAG_FLUX" :
{
"SURFACES" : [ I ]
}
READ_OPTION#
- READ_OPTION(11)#
Text-format section
[row, col] = [1, 2]
Output option |
Description |
|---|---|
0 Default |
Node input |
1 |
Line-element input |
2 |
Surface-element input. Also outputs the average magnetic flux density obtained by dividing linking flux by area. |
Text-format section
LOOP_NODES#
- LOOP_NODES(11)#
Text-format section
- Data type:
Integer array (I)
- Description:
Node IDs forming the closed curve.
Enter the node IDs traversed by the loop in sequence. Consecutive nodes must be at both ends of an edge.
A loop only needs to be closed considering symmetry. If it is closed within the analysis domain, its start and end nodes coincide.
LOOP_EDGS#
- LOOP_EDGS(11)#
Text-format section
- Data type:
Integer array (I)
- Description:
Edge-element IDs forming the closed curve.
Line-element material IDs defining each loop.
Element directions must be consistent. Magnetic flux is output as positive according to the right-hand rule with respect to the line-element orientation.
SURFACES#
- SURFACES(11)#
Text-format section
- Data type:
Integer array (I)
- Description:
Surface-element material IDs for the cross section of linking flux.
Element directions must be consistent. Magnetic flux is output as positive according to the right-hand rule for the surface-element orientation.
CUR_FLUX#
- CUR_FLUX(11)#
Text-format section
[row, col] = [2, 3]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs current (A) passing through a surface |
2 |
In addition to current passing through the surface, outputs the normal current density on the surface to a file. |
WRITE_OPTION#
- WRITE_OPTION(11)#
- Data type:
Integer (I)
- Description:
Specifies the output format for
CUR_FLUX. Used whenCUR_FLUXis enabled.
Setting |
Description |
|---|---|
0 Default |
Do not output. |
1 |
Outputs current (A) passing through a surface. |
2 |
Outputs current (A) passing through a surface and the normal current density on the surface. |
Additional data#
Text-format section
- Type:
Fixed parameter set
- Number of rows:
2
- Number of parameters:
1, N
* NO_SURFACES *
I
* SMAT_IDS *
I
JSON format#
"CUR_FLUX" :
{
"WRITE_OPTION" : I,
"SURFACES" : [ I ]
}
SURFACES#
- SURFACES(11)#
Text-format section
- Data type:
Integer (I)
- Description:
Surface-element material IDs used to calculate current passing through a surface.
Surface elements forming the surface must be included in the input mesh data file pre_geom or rotor_mesh. They must coincide with faces of conductive volume elements. The surface-element orientation (right-hand rule) must point outward from the volume elements. Current flowing out of the volume elements is summed.
A negative surface-element material ID reverses the surface-element orientation. This is useful for two-dimensional analysis.
FORCE_J_B#
- FORCE_J_B(11)#
Text-format section
[row, col] = [3, 1]
- Data type:
Integer (I)
- Value:
0, 1
- Description:
Outputs Lorentz force \(\pmb{J} \times \pmb{B}\) for each material and the total.
FORCE_NODAL#
- FORCE_NODAL(11)#
TYPE#
Text-format section
[row, col] = [3, 2]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs electromagnetic force based on nodal forces for each material and the total |
2 |
Also outputs accumulated nodal force for regions including air |
3 |
Outputs electromagnetic force for surface material IDs together with the surface-element mesh to surface_force. Also outputs the total force to output. |
No additional data is required for TYPE = 1.
Equation: [EQ4]
JSON format#
"FORCE_NODAL" :
{
"TYPE" : I
}
Additional data: TYPE = 2#
Output of accumulated nodal force for regions including air
Text-format section
- Type:
Fixed parameter set
- Number of rows:
1 + NO_FORCE_REGION*NO_MAT_IDS*MAT_IDS
- Number of parameters:
1, 1, 1,…
* NO_FORCE_REGION *
I
* NO_MAT_IDS *
I
* MAT_IDS *
I
JSON format#
"FORCE_NODAL" : {
"TYPE" : 2,
"FORCE_REGIONS" : [ [ I ] ]
}
Text-format section
- NO_FORCE_REGION(11)#
NO_FORCE_REGION
[row, col] = [1, 1]
Number of regions for accumulated nodal force.
- NO_MAT_IDS(11)#
NO_MAT_IDS
[row, col] = [1, 1]
Type=I
Number of material IDs included in the region.
- MAT_IDS(11)#
MAT_IDS
[row, col] = [1, 1]
Type=I
Material IDs included in the region.
FORCE_REGIONS#
- FORCE_REGIONS(11)#
- Data type:
Integer array (I)
- Description:
Material IDs included in the region. Specify this as a two-dimensional array [[]] in JSON format.
Additional data: TYPE = 3#
Output of electromagnetic force for surface material IDs
Text-format section
- Type:
Fixed parameter set
- Number of rows:
1*NO_SMAT_IDS
- Number of parameters:
1, N
* NO_SMAT_IDS *
I
* SMAT_IDS *
I
JSON format#
"FORCE_NODAL" : {
"TYPE" : 3,
"SURFACE_FORCE" : [ I ]
}
Text-format section
- NO_SMAT_IDS(11)#
NO_FORCE_REGION
[row, col] = [1, 1]
Type=I
Number of regions for accumulated nodal force.
- NO_MAT_IDS(11)#
NO_MAT_IDS
[row, col] = [1, 1]
Type=I
Number of material IDs included in the region.
- MAT_IDS(11)#
MAT_IDS
[row, col] = [1, 1]
Type=I
Material IDs included in the region.
FORCE_REGIONS#
- FORCE_REGIONS(11)#
- Data type:
Integer array (I)
- Description:
Material IDs included in the region. Specify this as a two-dimensional array [[]] in JSON format.
MAGNETIC_ENERGY#
- MAGNETIC_ENERGY(11)#
Text-format section
[row, col] = [3, 3]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs magnetic energy (J) for each region and the total |
Equation: [EQ5]
IRON_LOSS#
- IRON_LOSS(11)#
Text-format section
[row, col] = [3, 4]
Outputs iron loss (W) for each region and the total. Input data for volume-element properties 16_1_3D_Element_Properties is required.
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Calculation method based on the maximum magnetic flux density. Input data for iron-loss calculation parameters is also required. |
2 |
Calculation method based on the magnetic flux density waveform. |
3 |
Hysteresis-loss calculation using PlayModel ( |
The <HYSTERESIS module> is required.
<For frequency-domain analysis (AC(2) = 2)>
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs magnetic loss (W). |
In JSON format, specify the above option in TYPE. Additional data is required for TYPE = 1.
"IRON_LOSS" :
{
"TYPE" : I
}
Additional data: IRON_LOSS = 1#
Calculation method based on maximum magnetic flux density (Steinmetz method)
Text-format section
- Type:
Fixed parameter set
- Number of rows:
1
- Number of parameters:
4
* FREQUENCY * ALPHA * BETA * GAMMA *
E E E E
JSON format#
"IRON_LOSS" :
{
"TYPE" : 1,
"FREQUENCY" : E,
"ALPHA" : E,
"BETA" : E,
"GAMMA" : E
}
FREQUENCY#
- FREQUENCY(11)#
Text-format section
[row, col] = [1, 1]
- Data type:
Real number (E)
- Unit:
Hz
- Description:
Fundamental frequency for iron-loss calculation
ALPHA#
- ALPHA(11)#
Text-format section
[row, col] = [1, 2]
- Data type:
Real number (E)
- Description:
Frequency exponent \(\alpha\) for iron-loss calculation.
- Default value:
2
BETA#
- BETA(11)#
Text-format section
[row, col] = [1, 3
- Data type:
Real number (E)
- Description:
Magnetic-flux-density exponent \(\beta\) for iron-loss calculation.
- Default value:
2
GAMMA#
- GAMMA(11)#
Text-format section
[row, col] = [1, 4]
- Data type:
Real number (E)
- Description:
Magnetic-flux-density exponent \(\gamma\) for hysteresis-loss calculation.
- Default value:
2
Equation: [EQ6]
GAP_B#
- GAP_B(11)#
Text-format section
[row, col] = [3, 5]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs magnetic flux density (T) in the air gap in a fixed JSON format |
CHECK_PERMEANCE#
- CHECK_PERMEANCE(11)#
Text-format section
[row, col] = [3, 6]
Output option |
Description |
|---|---|
0 Default |
Do not output |
1 |
Outputs permanent-magnet permeance |
Note
CHECK_PERMEANCE uses CHECK_PERMEANCE in 17.7 Magnetization Vector Sources. The output file reports (magnet volume - volume of magnets judged demagnetized) / magnet volume for operating points below CHECK_PERMEANCE.