8. Calculation Steps (Time-Domain Analysis, Including Static Analysis)#

Specifies settings when either STATIC > 0 or TRANSIENT > 0 in 2. Analysis Type.

Input settings#

8_Calculation_Step JSON key: calculation steps object

NO_STEPS(8) Number of calculation steps

INITIAL_TIME(8) Time at step 0 (initial condition) (sec)

DELTA_TIME(8) Step time interval (sec)

NO_DATA(8) Number of calculation-step setting data entries. Default: 1.

CYCLIC(8) Parameter used when applying a periodic magnetic field with COIL(17.1).

  • Multiple-Step Calculation Setting Parameters

NO_STEPS_N(8) Calculation steps for multiple-step calculation settings

DELTA_TIME_N(8) Step time interval for multiple-step calculation settings

  • TP-EEC Method Setting Parameters

TP_EEC JSON key: TP-EEC method object

N_CORRECT(8) Sets the number of correction steps for the TP-EEC method

N_BACK(8) Used for one-period correction in the TP-EEC method

TP_EEC_OPTION(8) Used when using the simplified TP-EEC method

MAX_NO_CORRECTION(8) Sets the maximum correction count for the TP-EEC method

SOURCE_CORRECTION(8) Sets source correction for the TP-EEC method

FUNDAMENTAL_FREQUENCY(8) Sets the fundamental frequency for the TP-EEC method

NO_POLES_IN_MESH(8) Sets the number of poles in the mesh for the TP-EEC method

MAT_IDS_IN_PHASE(8) Sets material IDs in phase for the TP-EEC method

  • Initial-Value Parameters Using Steady Periodicity

TP_STEP(8) Step number for initial-value settings using steady periodicity

TP_STEP_OPTION(8) Initial-value setting option using steady periodicity

Input format#

Text-format section
Type:

Semi-fixed parameter set

Number of rows:

2

Number of parameters:

10, 2

Type:

Additional parameter set

Number of rows:

1

Number of parameters:

2

Time-domain analysis settings#
* NO_STEPS * INTIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION * TP_STEP * TP_STEP_OPTION *
    I            E             E            I        I          I         I            I            I           I

Repeat the following parameter set (NO_DATA - 1) times.

Additional step settings#
* NO_STEPS_n * DELTA_TIME_n *
    I            E

Text example

  • When NO_DATA = 1

    Text format#
    * NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION * TP_STEP * TP_STEP_OPTION *
        30          0.0           0.1         1       0          0         0            0
    
  • When NO_DATA > 1

    Text format#
    * NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION * TP_STEP * TP_STEP_OPTION *
        4          0.0           0.1         6       0          0         0            0
    * NO_STEPS_N * DELTA_TIME_N *
        2            0.2
        4            0.5
        2            1.0
        1            5.0
        23          10.0
    

JSON format#

In JSON format, use arrays to contain additional parameter set 1. [] represents an array, and [[]] represents a two-dimensional array (an array of arrays).

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ I ],
    "DELTA_TIME" : [ E ],
    "INITIAL_TIME" : E,
    "CYCLE" : I,
    "TP_EEC" :
    {
        "N_CORRECT" : I,
        "N_BACK" : I,
        "TP_EEC_OPTION" : I,
        "MAX_NO_CORRECTION" : I,
        "SOURCE_CORRECTION" : I,
        "FUNDAMENTAL_FREQUENCY" : E,
        "NO_POLES_IN_MESH" : I,
        "MAT_IDS_IN_PHASE" : [[ I ]],
        "TP_STEP" : I,
        "TP_STEP_OPTION" : I
    }
},

JSON example

  • When NO_DATA = 1

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 30 ],
    "DELTA_TIME" : [ 0.1 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0
},
  • When NO_DATA > 1

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 4, 2, 4, 2, 1, 23 ],
    "DELTA_TIME" : [ 0.1, 0.2, 0.5, 1.0, 5.0, 10.0 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0
},
  • When using the TP-EEC method,

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "TP_EEC" :
    {
        "N_CORRECT" : -90,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 0,
        "MAX_NO_CORRECTION" : 0
    }
}
  • When using the simplified TP-EEC method,

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "TP_EEC" :
    {
        "N_CORRECT" : -90,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 1,
        "MAX_NO_CORRECTION" : 0,
    }
}
  • When using the simplified multiphase AC TP-EEC method,

JSON format from 2024.11#
"8_Calculation_Step" :
{
    "TP_EEC" :
    {
        "N_CORRECT" : -90,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 3,
        "MAX_NO_CORRECTION" : 0,
        "SOURCE_CORRECTION" : 0,
        "FUNDAMENTAL_FREQUENCY" : 50.0,
        "NO_POLES_IN_MESH" : 1,
        "MAT_IDS_IN_PHASE" :
        [
            [ 11 ],
            [ 12 ],
            [ 13 ]
        ]
    }
}

Detailed description#

8_Calculation_Step#

8_Calculation_Step#
JSON key:

Calculation steps object

NO_STEPS#

NO_STEPS(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 1]
Data type:

Integer (I)

Values:

≥ 1

Description:

Number of calculation steps. Does not include step 0 (the initial condition).

INITIAL_TIME#

INITIAL_TIME(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 2]
Data type:

Real number (E)

Unit:

sec

Description:

Time at step 0 (the initial condition).

DELTA_TIME#

DELTA_TIME(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 3]
Data type:

Real number (E)

Values:

≥ 0

Unit:

sec

Description:

Step time interval

Fixed parameter set 1
NO_DATA(8)#

NO_DATA

Fixed parameter set 1#
[row, col] = [1, 4]
Type=I

Number of calculation-step setting data entries. Default: 1.

CYCLIC#

CYCLIC(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 5]
Data type:

Integer (I)

Description:

For time-periodic magnetic-field application problems using COIL(17.1), enter the number of steps in one period to reduce calculation time using cyclic_source. This is effective for COIL motion COIL_MOTION(19) analysis. The magnetic field for one period is saved in cyclic_source and used from the second period onward.

Default value:

0

Additional Step Settings#

Text-format section

When NO_DATA > 1, enter the following data repeatedly (NO_DATA - 1) times.

NO_STEPS_N(8)#

NO_STEPS_N

Additional parameter set 1#
[row, col] = [1, 1]
Type=I

Additional number of calculation steps in step calculation. This is repeated NO_DATA times and specifies the number for each step.

DELTA_TIME_N(8)#

DELTA_TIME_N

Additional parameter set 1#
[row, col] = [1, 2]
Type=E

Time interval (seconds) for each additional step. This interval is applied uniformly between the specified steps.

TP-EEC Method Setting Parameters#

When using the TP-EEC method, set the following data.

N_CORRECT#

N_CORRECT(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 6]
For the TP-EEC method, enter the number of steps in one period or a half-period.#

Setting value

Description

0: Default

Does not use TP-EEC correction.

> 0

One-period periodicity, including a DC component, with the same value after one period. Enter the number of steps in one period.

< 0

Half-period periodicity with sign reversal after a half-period. Enter the negative number of steps in the half-period.

Note

Revision history

Release 10.2.5

Added the TP-EEC correction function.

N_BACK#

N_BACK(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 7]

For TP-EEC one-period correction (N_CORRECT > 0), correction is applied N_BACK calculation steps earlier. Use this when correction at the middle of a period (== N_CORRECT / 2), rather than at its end, gives better convergence.

N_BACK setting values for the TP-EEC method#

Setting value

Description

0: Default

Does not use N_BACK.

> 0

Applies correction at the time specified number of steps earlier. N_BACK < N_CORRECT

Note

Revision history

Release 10.2.5

Added the TP-EEC correction function.

TP_EEC_OPTION#

TP_EEC_OPTION(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 8]
TP_EEC_OPTION setting values for the TP-EEC method#

Setting value

Description

0: Default

Does not use simplified TP-EEC correction.

> 0

Uses simplified TP-EEC correction. During sliding motion (MOTION(2) = 2), corrects the fixed side (pre_geom geom(2D)) and connected circuit values.

< 0

Number of multiphase AC phases corrected by the simplified multiphase AC TP-EEC method.

Note

Revision history

Release 10.2.5 Added the TP-EEC correction function.

Release 10.4.1 Added the simplified multiphase AC EEC method.

MAX_NO_CORRECTION#

MAX_NO_CORRECTION(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 9]
Data type:

Integer (I)

Values:

≥ 0

Description:

Sets the maximum number of corrections for the TP-EEC method. Corrections are applied during the number of steps specified by N_CORRECT, up to the count specified by MAX_NO_CORRECTION. The default is 0 (unlimited). Use this when TP-EEC convergence is poor.

Default value:

0 = unlimited

SOURCE_CORRECTION#

SOURCE_CORRECTION(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [2, 2]
Data type:

Integer (I)

Values:

0 or 1

Description:

Selects whether COIL(17.1) is subject to correction in the multiphase AC TP-EEC method.

Default value:

0 = not subject to correction

FUNDAMENTAL_FREQUENCY#

FUNDAMENTAL_FREQUENCY(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [2, 3]
Data type:

Real number (E)

Values:

> 0

Unit:

Hz

Description:

Sets the frequency subject to correction in the multiphase AC TP-EEC method. Specify the fundamental frequency of the frequency subject to TP-EEC correction.

NO_POLES_IN_MESH#

NO_POLES_IN_MESH(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [2, 4]
Data type:

Integer (I)

Values:

≥ 0

Description:

Sets the number of poles in the mesh subject to correction in the multiphase AC TP-EEC method.

Default value:

0 = 1

MAT_IDS_IN_PHASE#

MAT_IDS_IN_PHASE(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [3, NO_MAT_IDS_IN_PHASE]
Data type:

Integer array (I)

Description:

Sets properties subject to correction in the multiphase AC TP-EEC method as a two-dimensional array for the number of phases.

Examples#

  • TP-EEC half-period correction

The most commonly used half-period correction setting. With 180 steps per electrical-angle period, set half-period correction to 90 steps. Set N_CORRECT = -90; the negative value means half-period correction.

Text format
Text format#
* NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION *
    360          0.0           0.001         1       0         -90         0            0
JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 360 ],
    "DELTA_TIME" : [ 0.001 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0,
    "TP_EEC" :
    {
        "N_CORRECT" : -90,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 0,
        "MAX_NO_CORRECTION" : 0,
    }
}
  • Simplified multiphase AC TP-EEC half-period correction

Setting for one-sixth-period correction (half of one-third period) of a three-phase coil using the simplified multiphase AC TP-EEC method. With 180 steps per electrical-angle period, set half-period correction to 30 steps. For three phases, set TP_EEC_OPTION = -3; the negative value means half-period correction.

Text format
Text format#
* NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION *
    360          0.0           0.001         1       0         -90         0            -3
JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 360 ],
    "DELTA_TIME" : [ 0.001 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0,
    "TP_EEC" :
    {
        "N_CORRECT" : -30,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 1,
        "MAX_NO_CORRECTION" : 0,
        "SOURCE_CORRECTION" : 0,
        "FUNDAMENTAL_FREQUENCY" : 0.0,
        "NO_POLES_IN_MESH" : 0,
        "MAT_IDS_IN_PHASE" :
        [
            [ 11 ],
            [ 12 ],
            [ 13 ]
        ]
    }
}
  • dq-TP-EEC half-period correction

Setting for simplified correction of a three-phase coil using the dq-TP-EEC method. Correction is possible at any period. With 180 steps per electrical-angle period, this sets six-step correction (one-thirtieth-period correction). For three phases, set TP_EEC_OPTION = 3; the positive value means one-period correction.

Text format
Text format#
* NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION *
    360          0.0           0.001         1       0          6         0            3
JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 360 ],
    "DELTA_TIME" : [ 0.001 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0,
    "TP_EEC" :
    {
        "N_CORRECT" : 6,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 3,
        "MAX_NO_CORRECTION" : 0,
        "SOURCE_CORRECTION" : 0,
        "FUNDAMENTAL_FREQUENCY" : 0.0,
        "NO_POLES_IN_MESH" : 0,
        "MAT_IDS_IN_PHASE" :
        [
            [ 11 ],
            [ 12 ],
            [ 13 ]
        ]
    }
}

Initial-Value Parameters Using Steady Periodicity#

Set the following data when configuring initial values using steady periodicity.

Not normally used

TP_STEP#

TP_STEP(8)#
Fixed parameter set 1
Fixed parameter set 1#
[row, col] = [1, 9]
Data type:

Integer (I)

Description:

Calculation step number used for initial-value settings using steady periodicity. As with N_CORRECT for the TP-EEC method, specify the number of steps in one period or a half-period.

  • > 0: one-period periodicity

  • < 0: half-period periodicity

Note

Revision history

Release 12.0.3

Added initial-value settings using steady periodicity.

TP_STEP_OPTION#

TP_STEP_OPTION(8)#
Text-format section
Fixed parameter set 1#
[row, col] = [1, 10]
Setting values for initial values using steady periodicity#

Setting value

Description

≥ 1

Uses initial values based on steady periodicity from the period TP_STEP × TP_STEP_OPTION.

1

Does not use. Default

Note

Revision history

Release 12.0.3

Added initial-value settings using steady periodicity.

Example#

Performs initial-value correction together with TP-EEC half-period correction.

Text-format section
Text format#
* NO_STEPS * INITIAL_TIME * DELTA_TIME * NO_DATA * CYCLIC * N_CORRECT * N_BACK * TP_EEC_OPTION * TP_STEP * TP_STEP_OPTION *
    360          0.0           0.001         1       0         -90         0            0         -90           1
JSON format from 2024.11#
"8_Calculation_Step" :
{
    "NO_STEPS" : [ 360 ],
    "DELTA_TIME" : [ 0.001 ],
    "INITIAL_TIME" : 0.0,
    "CYCLE" : 0,
    "TP_EEC" :
    {
        "N_CORRECT" : -90,
        "N_BACK" : 0,
        "TP_EEC_OPTION" : 0,
        "MAX_NO_CORRECTION" : 0,
        "TP_STEP" : -90,
        "TP_STEP_OPTION" : 1
    }
}