FLUX Macros

How to use macro : WFM_LUT_2D_4SystemAnalysis_Half ?

Creation 02/21/2024
Last update
Version soft Flux 2024
Author NA
Reviewers PL

Introduction This document deals with how to install a macro, and how to use the
WFM_LUT_2D_4SystemAnalysis_Half. It will include the following topics:
• Macro definition: WFM_LUT_2D_4SystemAnalysis_Half
• Install a macro

1
 FLUX Macros

Macro definition: WFM_LUT_2D_4SystemAnalaysis_Half

Goal of the This macro creates look up table of flux dq, Ld, Lq and torque versus Id, Iq,
macro IDCrotor and rotor position (if needed) for Wound Field Motors. The goal is for
analysis on the system part (like with Twin Activate or PSIM for instance).
It will create a new Magneto-Static project from the transient magnetic one.
In the Magneto-Static project the current is driven with Id and Iq allowing to
extract easily all the needed tables. At the end of the oml file in comment
there is the possibility to display Ld, Lq and torque versus Id and Iq with
Altair Compose. An *.mat file is created.

Figure 1 : interface of WFM_LUT_2D_4SystemAnalysis_Half

The output will be an oml file called name_of_project_MS_table_res.oml.

Figure 2: example of output file

Note that there are some pre-requisites to fulfil:
• The circuit must have only 3 stator coil conductors
• No compressible mechanical set
• Delete all results

2
 FLUX Macros

Install a macro

Installing a Once you have taken a new macro (from a colleague or from Altair web site
macro (https://community.altair.com/community), you have to unzip it in the
following directory (for standard installation):
• C:\Program Files\Altair\2023.1\flux\Extensions\Macros

Note Macro has to be directly in folder:

C:\Program Files\Altair\2023.1\flux\Extensions\Macros

Calling a macro In order to use a macro, you have to follow the next steps:

Step Actions
1 Open Flux
2 Click on [Project] [Macro] [Load], and select the right macro

3 To run a macro, you have to click on [Project] [Macro] [Run]

Then select the macro you want to run.

3
 FLUX Macros

Folder Macros Description

Macros_4SystemAnalysis WFM_LUT_2D_4System Create look up table from TM project
Analysis_Half.PFM of Flux dq, Ld, Lq and torque versus
Id, Iq and rotor position.

Input:
• 3 Stator Current Sources
• Rotor Current sources
• Select mobile mechanical set
• Select fixed mechanical set
• Max value for Id
• Max value for IDCrotor
• Number of values for Id (odd)
• Number of values for IDCrotor
• Number of poles
• Number of pole pairs represented
in geometry (0.5 for one pole)
• Number of stator periodicities
• Depending on rotor position
• Fast computation or not
• Operational quadrant
• Number of steps in 1/3 of the
electric period
• Period for rotation (in degrees)
• Motor viscuous friction coefficient
(Nms/degrees)
• Motor inertia (in kg/m²)
Output:
• Create a result OML file with
name created from the initial file
(*_res.oml)
• It will also include more data such
as phase resistance, end winding
inductance, electric period and
initial rotor position plus
possibility to display values in
Compose

4
 FLUX Macros

Répertoire Macros Description

Macros_4SystemAnalysis WFM_LUT_2D_4System Créer des tables depuis un projet
Analysis_Half.PFM transitoire de moteur à aimants pour
définir le flux dq, Ld, Lq et couple en
fonction de Id, Iq et de la position du
rotor

Entrée:
• 3 Sources de courant statorique
• X Sources de courant rotorique
• Sélectionner l’ensemble
mécanique mobile
• Sélectionner l’ensemble
mécanique fixe
• Valeur max pour Id
• Valeur max pour IDCrotor
• Nombre de valeurs pour Id
(impair)
• Nombre de valeurs pour IDCrotor
• Nombre de pôles
• Nombre de paires de pôles
représenté dans la géométrie
• Nombre de périodicités au stator
• Dépendant de la position du rotor
• Calcul rapide
• Choix du quadrant
• Nombre de pas dans le tiers de la
période électrique
• Période électrique (en degrés)
• Motor coefficient de viscosité (en
Nms/degrees)
• Inertie du moteur (en kg/m²)
Output:
• Créer un fichier OML à partir du
nom initial (*_res.oml)
• Ces résultats incluent aussi la
résistance de phase, l’inductance
de tête de bobine, période
électrique et position initiale du
rotor plus le script pour afficher
les tables dans Compose