# Inputs

## 1. Introduction

The total number of user inputs is equal to 13.

Among these inputs, 7 are standard inputs and 6 are advanced inputs.

## 2.1 Computation modes

There are 2 modes of computation.

The “ Fast ” computation mode is the default one. It corresponds to a hybrid model which is perfectly suited for the pre-design step. Indeed, all the computations in the back end are based on magnetostatic finite element computations associated to Park transformation. It evaluates the electromagnetic quantities with the best compromise between accuracy and computation time to explore the space of solutions quickly and easily.

The “ Accurate ” computation mode allows solving the computation with transient magnetic finite element modelling. This mode of computation is perfectly suited to the final design step because it allows getting more accurate results. It also computes additional quantities like the AC losses in winding, rotor iron losses and Joule losses in magnets.

## 2.2 Current definition mode

There are 2 common ways to define the electrical current.

Electrical current can be defined by the current density in electric conductors.

In this case, the current definition mode should be « Density ».

Electrical current can be defined directly by indicating the value of the line current (the rms value is required).

In this case, the current definition mode should be « Current ».

## 2.3 Line current, rms

When the choice of current definition mode is “ Current ”, the rms value of the line current supplied to the machine: “Line current, rms” ( Line current, rms value ) must be provided.

## 2.4 Current density, rms

When the choice of current definition mode is “ Density ”, the rms value of the current density in electric conductors “Current density, rms” (Current density in conductors, rms value) must be provided.

Note: The number of parallel paths and the winding connection are automatically considered in the results.

## 2.5 Control angle

Considering the vector diagram shown below, the “ Control angle ” is the angle between the Q-axis and the electrical current (J) i.e. (Y = (J q , J)).

The default value is 45 degrees. It is an electrical angle. It must be set in a range of -90 to 90 degrees. Definition of the control angle Ψ - Generator convention

## 2.6 AC losses analysis

The “ AC losses analysis ” (AC losses analysis required only while “Accurate” computation mode is selected) allows computing or not AC losses in stator winding. There are three available options:

• None : AC losses are not computed. However, as the computation mode is “Accurate”, a transient computation is performed without representing the solid conductors (wires) inside the slots. Phases are modeled with coil regions. Thus, the mesh density (number of nodes) is lower which leads to a lower computation time.
• FE-One phase : AC losses are computed with only one phase modeled with solid conductors (wires) inside the slots. The other two phases are modeled with coil regions. Thus, AC losses in winding are computed with a lower computation time than if all the phases were modeled with solid conductors. However, this can have a little impact on the accuracy of results because we have supposed that the magnetic field is not impacted by the modeling assumption.
• FE-All phase : AC losses are computed, with all phases modeled with solid conductors (wires) inside the slots. This computation method gives the best results in terms of accuracy, but with a higher computation time.

## 2.7 Speed

The imposed “ Speed ” ( Speed ) of the machine must be set.

## 2.8 Ripple torque analysis

The “ Ripple torque analysis ” (Additional analysis on ripple torque period: Yes / No) allows to compute or not to compute the value of the ripple torque and to display the corresponding torque versus the angular position over the ripple torque period.

The default value is “No”.

Note:
• This choice influences the accuracy of results and on the computation time. The peak-peak ripple torque is calculated. This additional computation needs addition computation time.
• In case of “Yes”; the ripple torque is computed. Then, the flux density in regions is evaluated through the ripple torque computation.
• In case of “No”; the ripple torque is not computed. Then, the flux density in regions is evaluated by considering one dedicated static computation (1 rotor position to be considered) for the computed working point.

“Additional losses” input is not available in the current version (The input label is written in grey).

## 3.1 Number of computed electrical periods

The user input “ No. computed elec. periods ” (Number of computed electrical periods only required with “Accurate” computation mode) influences the accuracy of results especially in case of AC losses computation. Indeed, with represented conductors (AC losses analysis set to “FE - One phase” or “FE - All phase”) the computation may lead to have transient current evolution in wires requiring more than an electrical period of simulation to reach the steady state over an electrical period.

The default value is equal to 2. The minimum allowed value is 0.5 (recommended with AC losses analysis set to “None”). The default value provides a good compromise between the accuracy of results and computation time.

## 3.2 Number of points per electrical period

The user input “ No. points / electrical period ” (Number of points per electrical period required only with “Accurate” computation mode) influences the accuracy of results (computation of the peak-peak ripple torque, iron losses, AC losses…) and the computation time.

The default value is equal to 40. The minimum recommended value is 20. The default value provides a good balance between accuracy of results and computation time.

## 3.3 Number of computations per ripple torque period

The number of computations per ripple torque period is considered when the user has chosen to perform a “Ripple torque analysis” (i.e. answered “Yes” to the standard input “Ripple torque analysis” required only with “Fast” computation mode).

The user input “ No. comp. / ripple period ” (Number of computations per ripple torque period) influences the accuracy of results (computation of the peak-peak ripple torque) and the computation time.

The default value is equal to 30. The minimum allowed value is 25. The default value provides a good balance between the accuracy of results and computation time. Definition of the number of computations per ripple torque period

## 3.4 Rotor initial position mode

The computation is performed by considering a relative angular position between rotor and stator.

This relative angular position corresponds to the angular distance between the direct axis of the rotor north pole and the axis of the stator phase 1 (reference phase).

According to the input “ Rotor initial position mode ”, the angular position can be defined either automatically using an internal computation process « Auto » (Automatic) or specified by the user « User » (User).

By default, the “ Rotor initial position mode ” is set to “ Auto ”.

## 3.5 Skew model – Number of layers

When the rotor or the stator slots are skewed, the number of layers used in Flux Skew environment to model the machine can be modified: “Skew model - No. of layers” ( Number of layers for modelling the skewing in Flux Skew environment ).

## 3.6 Mesh order

To get the results, the original computation is performed using a Finite Element Modeling.

Two levels of meshing can be considered for this finite element calculation: first order and second order.

This parameter influences the accuracy of results and the computation time.

By default, second order mesh is used.

## 3.7 Airgap mesh coefficient

The advanced user input “ Airgap mesh coefficient ” is a coefficient which adjusts the size of mesh elements inside the airgap. When the value of “Airgap mesh coefficient” decreases, the mesh elements get smaller, leading to a higher mesh density inside the airgap, increasing the computation accuracy.

The imposed Mesh Point (size of mesh elements touching the points of the geometry)is described with the following parameters:

• MeshPoint = (airgap) x (airgap mesh coefficient)
• Airgap mesh coefficient is set to 1.5 by default.

The variation range of values for this parameter is [0.05; 2].

0.05 gives a very high mesh density and 2 gives a very coarse mesh density.

CAUTION:
Be aware, a very high mesh density does not always mean a better result quality.

However, this always leads to the formation of a huge number of nodes in the corresponding finite element model. So, it means a need of huge numerical memory and increases the computation time considerably.

## 3.8 Convergence criteria on temperature

The advanced user input “ Converg. Criteria on temperature ” (Convergence criteria on temperature ) is a percentage driving the convergence of the computation.

This advanced user input is available when the iterative thermal solving mode is selected in the thermal settings.

The iterative process (loop between electromagnetic and thermal computations) must run until the convergence criterion has been reached leading to the electromagnetic-thermal steady state. The convergence process is completed when the variation of temperature between two iterations gets lower than the ratio “ Converg. Criteria on temperature ” set in input.

Convergence criterion on temperature is set to 1.0 % by default.

The variation range of values for this percentage is ]0;10].

A percentage close to zero gives more accurate results, but a longer computation time. A high percentage can make the convergence shorter but decreases the accuracy of the results. The default value of 1.0% gives a good balance between accuracy and computation time on most of the computations, but a smaller value can also be used to increase the computation accuracy on some working points.

Note: Two conditions are required to make the “Convergence criteria” available:
• The type of machine is Reluctance Synchronous Machine with Inner rotor (Thermal computations are available only for inner rotor machines)
• One of the two following thermal solving modes is selected: One iteration or iterative computation until convergence mode.

## 3.9 Rotor d-axis location

The computations are performed by considering a relative angular position between rotor and stator.

For the reluctance synchronous machines, the rotor d-axis location is defined and automatically used to perform computations.

This value is characterized by the saliency topology. This is an important information to keep in mind.

For more details, please refer to the document: MotorFactory_2022.1_SMRSM_IR_3PH_Test_Introduction – section “Rotor and stator relative position”.