How to use MANATEE GUI to define a simulation?

Before reading this article, make sure you have read "What is MANATEE GUI?". It will warn you on some common mistakes with the GUI.

Opening the GUI

To open MANATEE GUI, you need to double click on the executable "MANATEE_path"\GUI\Manatee_GUI.exe

MANATEE GUI path
MANATEE GUI path

You have to keep this file in this folder (otherwise it won’t be able to find your machines, projects or materials). If you want to access it in a more convenient way, you can create your own shortcut.

When opening the GUI, a console window appears. You can ignore it but don’t close it. We use it (for now) to get log (error, warning messages) from the GUI. If you encounter any issue with the GUI, please make sure to send us (alongside the description of how the error occured and your system configuration) the content of this console.

MANATEE log console
MANATEE log console

After a few seconds, the GUI should open:

GUI main project page
GUI main project page

Simulation parameter groups

The main page displays an overview of the most significant simulation parameters. As you can see the parameters are split in 8 panels. The 4 first panels are:

  • Workflow: Select the input, output and type of the simulation
  • Numerical: Discretization and computation limits
  • Fault: To introduce eccentricities, shape default, broken bar...
  • Pre/Post: Pre and Post-processing script and miscellaneous parameters

The 4 other groups (Electrical, Electromagnetic, Mechanical, Acoustics) define MANATEE multiphysic models: what to compute and how. In a basic simulation these models are run sequentially.

By reading this first window, you can see that the default simulation project simulates:

  • A SCIM (squirrel cage induction machine) with an internal rotor, 36 stator slots, 28 rotor slots, 6 poles
  • Simulation at single speed (1188 rpm) and supplied by a sinusoidal voltage 173.2V (Workflow)
  • No fault and no post-processing script
  • The equivalent circuit is computed without skin effect and using a reluctance model for the assessment of the saturation coefficient (Electrical)
  • The airgap fux is computed with an analytical permeance/mmf method (Electromagnetic) with 2048 angular steps, 1024 time steps and no skew (Numerical)
  • The radial and tangential forces are both computed analytically in Free-Free condition (Mechanical)
  • The sound pressure level at 1m from the frame is also computed analytically assuming the machine lies on a reflecting plane (Acoustics)

Editing a simulation

When defining a new simulation it is recommended to start by the "Workflow" panel because according to your input and output requirements, some panels won’t be relevant any more. For instance, if your output is the flux distribution, using MANATEE as an electromagnetic simulation tool only, you don’t need to setup Mechanical or Acoustics panel parameters.

Mechanical and Acoustics model disabled
Mechanical and Acoustics model disabled

To edit a panel you should click on it and a new window pops up:

Workflow edit window
Workflow edit window

Note that as long as you don’t click on the "OK" button at the bottom of the window, your changes won’t be taken into account on the main window. The red cross and the cancel button discard the changes and close the window. Although you can open all the panels editing windows at once, we advice to only edit one panel at the time.

For the 4 model panels (Electrical, Electromagnetic, Mechanical, Acoustics), the edit window is organized the same way:

Electromagnetic edit window
Electromagnetic edit window

There are three tabs :

  • Method: How to compute physical quantities (for instance for electromagnetic you can chose between subdomain, permeance/mmf or finite element methods)
  • Assumption: Set the computation hypothesis (e.g. neglect rotor slotting effect, neglect iron losses in the equivalent circuit)
  • Output: Optional outputs to be calculated

Meaning of the variables

In all the editing windows the "script names" of MANATEE variables are used. The aim is to help you to switch from the GUI to the scripting environment under Matlab without being lost by different variable names. If the script names are not explicit enough here are three ways to know their meaning:

  • you already know these parameters because you have done the tutorials
  • you search the variable in the default project/machine scripts and read the associated description
  • you read the tooltip/help text

The tooltip is a hidden description text that appears when you put your mouse over a field:

sta_ecc_rate tooltip
sta_ecc_rate tooltip

You can also click on the "?" next to the close button:

Help button
Help button

Your mouse cursor will change to indicate the area where help texts are available. If you click on a field, the help text is displayed. This text is the same as in the tooltip field and in the default machine and simulation scripts.

Previous Next