Summary for: NTGridDQ < NTGrid

Class summary

NTGridDQ Speed-torque grid from d-q grid data.

Initialization:

grid = NTGridDQ(raw_grid, key, val) with any of the following:

  • ‘U_DC’ : DC-link voltage. Default [] –> determine from base point.

  • ‘turns_ratio’ : multiplier to adjust the motor turn count with.

  • ‘base_speed’ : Base speed, see below.

  • ‘base_torque’ : Base torque. Not used if U_DC is given. If not, then U_DC = terminal voltage at base point.

  • ‘speed_range’ : speed range to initialize the grid for.

Properties

.U_DC - DC bus voltage. Changing this recomputes this.interpolant

.base_speed - Base speed

.base_torque - Base torque

.NTGridDQ/grid is a property.

.NTGridDQ/interpolant is a property.

.NTGridDQ/speed_range is a property.

.stack_length_ratio Stack length ratio.

A multiplier to apply on the stack length of the original design. The effects are computed with .set_stack_length_ratio.

.turns_ratio - Multiplier for motor turns. Changing this recomputes this.interpolant.

Methods

Class methods are listed below. Inherited methods are not included.

.parsing defaults

Documentation for NTGridDQ/NTGridDQ doc NTGridDQ

.NTGridDQ/compute_detailed is a function.

data = compute_detailed(this, Icoil, n)

.NTGridDQ/get_efficiency_grid is a function.

[etagrid, torque_grid, speed_grid, electrical_power] = get_efficiency_grid(this, varargin)

.NTGridDQ/get_grid is a function.

[Qint, torque_grid, speed_grid] = get_grid(this, q_name, varargin)

.get_op Interpolate operating point data

[eta, data] = get_op(this, n, T) where

  • n : speed (rpm)

  • T : torque (Nm)

[eta, I, Pcu, Physt, Peddy] = get_op(this, n, T, ‘mode’, mode)

  • mode : operating mode, ‘motor’ / ‘generator’

Keyword arguments:

  • ‘compute_detailed’ : (EXPERIMENTAL) compute detailed loss breakdown? Default: false.

Outputs:

  • eta : efficiency (%)

and data, a structure with fields:

  • I : 2x1 vector, [id; iq]. Phase quantities (not coil)

  • Pcu

  • Physt

  • Peddy

  • Pexcess

  • W : losses

.get_speed_and_torque_grid Meshgrids for calculation.

.init_listeners Add property listeners.

.maximum_torque_at_speed Get maximum torque at given speed.

.NTGridDQ/plot_map is a function.

Qint = plot_map(this, contour_name, varargin)

.plot_phase_current_limit Plots phase current limit.

h = plot_phase_current_limit(this, I, varargin) Plots the phase current contour for the rms current I (total phase current, parallel paths considered).

Returns the handle h to the contour line.

All input arguments are passed on to this.get_speed_and_torque_grid.

Additionally, the following key-value pairs are passed on to plot for actually drawing the contour (default values shown):

  • ‘color’ : ‘r’
  • ‘linewidth’ : 1
  • ‘linestyle’ : ‘-‘
  • ‘marker’ : ‘none’

.setup Initialization function

.save_efficiency_grid Save efficiency data.

save_efficiency_grid(this, filename)

save_efficiency_grid(this, filename, key, val) with

  • ‘format’, ‘grid’/’columns’ : Output format. Only ‘columns’ supported right now.

  • ‘sheet’, sheet_name : Sheet to save into.

  • ‘range’, rng : Sheet range to save into. Default ‘A1’.

NOTE The exported (Id, Iq) currents are defined for the ‘coil frame’ using peak-scaled space vectors. Thus, the terminal RMS current is sqrt(Id^2 +Id^2) / sqrt(2) * number_of_parallel_paths for star connection, and sqrt(3) times that for delta

.set_stack_length_ratio Set stack length ratio.

set_stack_length_ratio(this, v) sets the stack length ratio and adjusts the results in this.grid accordingly, by multiplying the (unchanged) results from this.original_grid.

** NOTE AND WARNING : AC loss components are scaled linearly with the stack length. This is not perfectly accurate for ExtrudedBlockCircuit and similar losses.

Results are then recomputed with this.recompute.