Introduction to Femagtools

Femagtools is an Open-Source Python-API for FEMAG based on Numpy, Scipy, Mako and Matplolib. It offers following features:

• run Femag with a FSL script file anywhere: locally (single and multi-core), remote (ZMQ), HT Condor, Cloud (Amazon AWS, Google Cloud)
• read BCH/BATCH
• read and write MCV files (magnetizing curves)
• create a variety of plots
• create FSL files from model and calculation templates and/or user specific FSL
• calculate machine characteristics by using analytic machine models
• execute parameter studies and multi-objective optimization

The package can be used with Python 2.7 or 3.x on Linux or Windows and is hosted on github: https://github.com/SEMAFORInformatik/femagtools/` where also many examples can be found in the examples directory. Contributions and feedback to this project are highly welcome.

The installation can be done in the usual ways with pip or conda.

For details see the documentation http://docs.semafor.ch/femagtools

Contents

• Material Handling
• Reading BCH/BATCH Files
• Model Creation and FEMAG Invocation
• Machine Characteristics
• Parameter Variation and Optimization

Modules and Scripts

The package provides following modules:

• mcv, tks, jhb, losscoeffs: handling magnetizing curves and iron losses
• erg, bch, isa7: read I7/ISA7, ERG, BCH/BATCH files created by FEMAG
• convert: convert I7/ISA7 to Gmsh mesh and other formats
• model, fsl: create machine and calculation models
• dxfsl: convert DXF to FSL
• femag: manage the FEMAG calculation
• airgap: read airgap induction file created by a previous calculation
• machine: analytical machine models
• grid: running parameter variations
• opt: running multi objective optimizations
• plot: creating plots
• amazon, google, condor, multiproc: engines for the calculation in Cloud and HTCondor environments or locally using multiple cores

The following modules can be executed as script:

• bch: print content in json format if invoked witha BCH/BATCH file as argument
• bchxml: produces an XML file when invoked with a BCH/BATCH file as argument
• plot: produces a graphical report of a BCH/BATCH file
• airgap: prints the base harmonic amplitude of the radial component of the airgap induction when invoked with the file name of an airgap induction file
• mcv: print content in json format if invoked with a MC/MCV file as argument
• dxfsl.conv: convert DXF to FSL

Example: create a plot af a BCH file:

In addition you will find command line tools:

• femagtools-plot
• femagtools-convert
• femagtools-bchxml
• femagtools-dxfsl

Usage

For simple applications it is sufficient to import femagtools:

The version can be checked with: