LabVIEW Electric Motor Simulation Toolkit API Reference

Content Type
Programming Language
Current manual

Create PMSM Variable Parameter Model VI

Create PMSM Variable Parameter Model VI

Owning Palette: Permanent Magnet Synchronous Motor VIs

Requires: Electric Motor Simulation Toolkit

Reads the RTT file, the ANSYS motor model file, or imports an external model to get a LabVIEW class reference of permanent magnet synchronous motor (PMSM) variable parameter model. You must manually select the polymorphic instance you want to use.

Details  Examples

Create PMSM Variable Parameter Model (RTT File)

Reads the RTT file to get a LabVIEW class reference of PMSM variable parameter model.

RTT file specifies the path to an RTT file. The RTT file contains motor parameters and data that the JMAG-RT software generates.
table size specifies the number of rows and columns in a two-dimensional table. By default, the table has the same number of rows and columns. The value of table size must be greater than 0.
temperature correction parameters specifies the characteristics of the electric motor for temperature correction. If the value of any temperature correction parameter is not a number (NaN), this VI reads the temperature correction parameter from the RTT file.
coil base temperature specifies the base temperature, in kelvins, of the motor coil. The value of coil base temperature must be equal to or greater than 0. The default is NaN.
coil temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the motor resistance. The material of the coil determines the value of coil temperature coefficient. The default is NaN.
magnet base temperature specifies the base temperature, in kelvins, of the motor magnet. The value of magnet base temperature must be equal to or greater than 0. The default is NaN.
magnet temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the magnet flux. The material of the magnet determines the value of magnet temperature coefficient. The default is NaN.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
PMSM variable parameter model returns and saves the parameters and data of the PMSM in a LabVIEW class. You can use this LabVIEW class object as the input to the PMSM Variable Parameter VI and the Generate PMSM Variable Parameter Model FPGA Data VI.
PMSM type returns the connection type and the number of poles of the electric motor.
connection type returns how the permanent magnet synchronous motor is connected to the circuit. Currently, the Electric Motor Simulation Toolkit only supports the star connection. If the RTT file uses delta connection, LabVIEW returns error code -376401.

0Star—Returns the connection type as star connection. High voltage transmission systems typically use star connections. Star connections offer the advantage of providing multiple voltages.
1Delta—Returns the connection type as delta connection. Low voltage distribution systems typically use delta connections. Delta connections offer the advantage of high reliability.
number of poles returns the number of poles in the electric motor.
error out contains error information. This output provides standard error out functionality.

Create PMSM Variable Parameter Model (ANSYS File)

Reads the ANSYS motor model file to get a LabVIEW class reference of PMSM variable parameter model.

ANSYS file specifies the path to an ANSYS motor model file. The ANSYS motor model file contains motor parameters and data that the ANSYS simulation software generates.
temperature correction parameters specifies the characteristics of the electric motor for temperature correction. If the value of any temperature correction parameter is not a number (NaN), this VI reads the temperature correction parameter from the ANSYS motor model file.
coil base temperature specifies the base temperature, in kelvins, of the motor coil. The value of coil base temperature must be equal to or greater than 0. The default is NaN.
coil temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the motor resistance. The material of the coil determines the value of coil temperature coefficient. The default is NaN.
magnet base temperature specifies the base temperature, in kelvins, of the motor magnet. The value of magnet base temperature must be equal to or greater than 0. The default is NaN.
magnet temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the magnet flux. The material of the magnet determines the value of magnet temperature coefficient. The default is NaN.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
PMSM variable parameter model returns and saves the parameters and data of the PMSM in a LabVIEW class. You can use this LabVIEW class object as the input to the PMSM Variable Parameter VI and the Generate PMSM Variable Parameter Model FPGA Data VI.
PMSM type returns the connection type and the number of poles of the electric motor.
connection type returns how the permanent magnet synchronous motor is connected to the circuit. Currently, the Electric Motor Simulation Toolkit only supports the star connection.

0Star—Returns the connection type as star connection. High voltage transmission systems typically use star connections. Star connections offer the advantage of providing multiple voltages.
1Delta—Returns the connection type as delta connection. Low voltage distribution systems typically use delta connections. Delta connections offer the advantage of high reliability.
number of poles returns the number of poles in the electric motor.
error out contains error information. This output provides standard error out functionality.

Create PMSM Variable Parameter Model (External Model)

Imports an external model to get a LabVIEW class reference of PMSM variable parameter model.

inductance tables specifies two tables which list the direct inductance and quad inductance. The two tables share the same axes.
d inductance specifies the inductance, in henries, along the d or direct axis. The value of d inductance must be greater than 0.
q inductance specifies the inductance, in henries, along the q or quad axis. The value of q inductance must be greater than 0.
d current specifies the current, in amperes, along the d or direct axis. The length of this array must be equal to the number of columns in the d inductance table and the q inductance table. The values of d current must be in ascending order.
q current specifies the current, in amperes, along the q or quad axis. The length of this array must be equal to the number of rows in the d inductance table and the q inductance table. The values of q current must be in ascending order.
number of poles specifies the number of poles in the electric motor. The number of poles must be an even number.
resistance specifies the resistance, in ohms, of the electric motor. The value of resistance must be greater than 0.
temperature correction parameters specifies the characteristics of the electric motor for temperature correction.
coil base temperature specifies the base temperature, in kelvins, of the motor coil. The value of coil base temperature must be equal to or greater than 0. The default value is 0.
coil temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the motor resistance. The material of the coil determines the value of coil temperature coefficient. The default value is 0.
magnet base temperature specifies the base temperature, in kelvins, of the motor magnet. The value of magnet base temperature must be equal to or greater than 0. The default value is 0.
magnet temperature coefficient specifies the coefficient, in K^-1, for temperature correction of the magnet flux. The material of the magnet determines the value of magnet temperature coefficient. The default value is 0.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
flux table specifies a two-dimensional table of magnet flux.
flux specifies a two-dimensional table of magnet flux in webers. The value of flux must be greater than 0.
d current specifies the current, in amperes, along the d or direct axis. The length of this array must be equal to the number of columns in the flux table. The values of d current must be in ascending order.
q current specifies the current, in amperes, along the q or quad axis. The length of this array must be equal to the number of rows in the flux table. The values of q current must be in ascending order.
PMSM variable parameter model returns and saves the parameters and data of the PMSM in a LabVIEW class. You can use this LabVIEW class object as the input to the PMSM Variable Parameter VI and the Generate PMSM Variable Parameter Model FPGA Data VI.
PMSM type returns the connection type and the number of poles of the electric motor.
connection type returns how the permanent magnet synchronous motor is connected to the circuit. Currently, the Electric Motor Simulation Toolkit only supports the star connection.

0Star—Returns the connection type as star connection. High voltage transmission systems typically use star connections. Star connections offer the advantage of providing multiple voltages.
1Delta—Returns the connection type as delta connection. Low voltage distribution systems typically use delta connections. Delta connections offer the advantage of high reliability.
number of poles returns the number of poles in the electric motor.
error out contains error information. This output provides standard error out functionality.

Create PMSM Variable Parameter Model Details

The following figure shows the structure of the inductance tables and the flux table. The column axis is d current. The row axis is q current.

In the d inductance table, the value of d inductance can be shown as Ld (Iq, Id). In the q inductance table, the value of q inductance can be shown as Lq (Iq, Id). In the flux table, the value of flux can be shown as F (Iq, Id).

where Ld is the d inductance table
Lq is the q inductance table
Id is d current
Iq is q current
F is the flux table

Examples

Refer to the following VIs for examples of using the Create PMSM Variable Parameter Model VI:

  • PMSM Open Loop Simulation VI: labview\examples\Electric Motor Simulation\PMSM\PMSM Open Loop Simulation
  • labview\examples\Electric Motor Simulation\PMSM\PMSM Variable Parameter Model Control Simulation\PMSM Variable Parameter Model Control Simulation.lvproj
Was this information helpful?