Page Comparison

Machine Model Settings

Name

Specifies the name of the machine model.

Description

Specifies a description for the machine model.

Machine Configuration

Symbol

Units

Default Value

Model File

Specifies the path to the 3D Machine Model file on disk. Refer toJMAG-RT RTT File Generation Recommendations for details regarding the file format. The following standards are supported:

• JMAG (.rtt)

• ANSYS (.json) (Please contact OPAL-RT Support for more information about the ANSYS option)

Enable

True

Indicates whether the selected machine model is enabled. When a machine is enabled, it computes and generates output data at the specified Applied Solver Timestep.

It is recommended to disable unused machines, as the number of enabled machines impacts the minimum achievable timestep of the solver.

Initial Angle

θ₀

deg

0°

Initial Angle of the machine

This may be useful when simulating two separate 3-phase machines that require a phase shift between them.

Enable Advanced Channels

Allows certain parameters to be exposed as tunable VeriStand Channels. See the Advanced Channels section below for more details.

This checkbox is only available when the machine is enabled. Otherwise, the option is greyed out.

Applied Solver Timestep

T_s

s

The timestep at which the machine model executes.

New outputs are computed by the FPGA machine model at each timestep. If Optimize Solver Timesteps is enabled in the Circuit Model page, the Applied Solver Timestep is automatically set to an optimal value and cannot be edited.

If Optimize Solver Timesteps is disabled, this value must be set to a multiple of 50ns equal to or greater than the Minimum Solver Timestep (s) (400ns), and less than 2.5us.

Minimum Solver Timestep

T_sm

s

The minimum achievable timestep at which the machine model can execute

Table Max Current

A

Maximum current value that will be used to interpolate the model file. Use this feature to increase the resolution of the machine at lower Current operating points. This will reduce the machine operating range. Use -1 to use the full range available in model file.

DQ Angle Offset

θ_offset

deg

0°

The electrical angle offset applied to the Reference Frame Transformation.

Setting this parameter to 0° indicates that the d-axis is aligned with Phase A when the electrical angle θ_e = 0°. This is illustrated in Figure 2.

Setting this parameter to -90° indicates that the q-axis is aligned with Phase A when the electrical angle θ_e = 0°.

Input Mapping Configuration

Use the Input Mapping Configuration to route signals to the Voltage Phase A, Voltage Phase B, and Voltage Phase C inputs of the machine model.  Available routing options may vary depending on the selected Hardware Configuration.

Group

Specifies the group that will be routed to the input voltages of the machine. The available routing options are defined by the selected Hardware Configuration, however it is typical to see the following options by default:

• Measurements - eHS circuit model measurements

Element

Specifies the index of the measurement in the group that has been selected as the input voltage of the machine.