Inputs
1. Introduction
The total number of user inputs is equal to 8.
Among these inputs, 4 are standard inputs and 4 are advanced inputs.
2. Standard inputs
2.1 Modes of computation
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 predesign 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.
2.5 Control angle
Considering the vector diagram shown below, the “ Control angle ” is the angle between the Qaxis 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.
This range of values covers all the possible working points in motor and generator operating mode with motor convention. The operating mode is displayed at the head of results.

Definition of the control angle Ψ  Motor 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.
 FEOne 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.
 FEAll 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.

FEHybrid: AC losses in winding are computed without representing the wires (strands, solid conductors) inside the slots.
Since the location of each wire is accurately defined in the winding environment, sensors evaluate the evolution of the flux density close each wire. Then, a postprocessing based on analytical approaches computes the resulting current density inside the conductors and the corresponding Joule losses.
The wire topology can be “Circular” or “Rectangular”.
There can be one or several wires in parallel (in hand) in a conductor (per turn).
This method leads to quite accurate results with lower computation time. This is a good compromise between accuracy and computation time.Warning: With the “FEHybrid” option the accuracy of results is good especially when the wire size is small (let’s say wire diameter lower than 2.5 mm). 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.Note:With FEHybrid option the recommended “Number of computed electrical periods” is equal to “1/2” whereas 2 computed electrical periods are needed for “FEOne phase” and for “FEAll phase” options.
Indeed, when solid conductors are represented in the Finite Element model (like with FEOne phase and FEAll phase options), there are transient phenomena to consider which leads to increase the “Number of computed electrical periods” to reach the steady state.
With the “FEHybrid option”, the transient phenomena are handled by the analytical model, so, it is not necessary to increase the “Number of computed electrical periods” compared to a study with “None” options (without AC losses computation).
Note: When the winding is built with a hairpin technology the FEHybrid mode is not available because it is not relevant for computations with such kind of winding/conductors.
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 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”.
 This choice influences the accuracy of results and the computation time. The peakpeak 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.
2.9 Additional losses
3. Advanced inputs
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 peakpeak 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 peakpeak 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 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.5 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.6 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.
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.7 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 criteria has been reached leading to the electromagneticthermal 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 criteria 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 the 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.
 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.8 Rotor daxis location
The computations are performed by considering a relative angular position between rotor and stator.
For the reluctance synchronous machines, the rotor daxis location is defined and automatically used to perform computations.
This value is characterized by the saliency topology. This is important to keep in mind this information it.
For more details, please refer to the document: MotorFactory_2023.1_SMRSM_IR_3PH_Test_Introduction – section “Rotor and stator relative position”.