 This tutorial teaches the basic methods to define problems, perform calculations and to get related results.  Pictures shown here are from calculations with version 3.0, but of course the tutorial can be used without any change in version 3.1  and 3.2 too. Tutorial 3.1  and 3.2 below are related to the new sorts of magnets and methods which have been introduced in those versions.

Circumferentially magnetized multipolar magnet with six poles

This tutorial shows the basic handling of the software as well as its basic characteristics. The problem which shall be teated here consists of a cylinder made of six homogenous segments of anisotropic ferrite, having a remanence induction of 0.40T each. The example below and similar problems ca be treated by use of the demo version of PS-PERMAG and for sure by the full versions 3.0 or 3.1. The additional features of both versions which are not shown here can also be learned easily by use of their extensive help system. The treatment of the new two pole sensormagnets of version 3.1 with enhanced geometric details can be studied in Tutorial 3.1

After starting PS-PERMAG a 3D model of an illustrative permanent magnet shows up on the screen. To define the above described magnet please click on the M symbol at the top symbol bar. M stands for circumferentially magnetized multipolar cylinders with homogenous magnetization in each pole. This opens an input dialog for the data input, see picture below. Here the basic data of the magnet have to be put in. Background for defining a cylindrical magnet is always a cylindrical coordinate system. This means e.g. that at half the axial length of the magnet there is always z=0. At zero angle phi=0 there always starts an outward oriented pole.

After you press OK the respective new 3D model shows up on the screen including the defined results path, see the picture below this text. You can zoom in or out of the model by using your mouse central wheel. By a left mouse click and simultaneous mouse movement one can turn the model around its x- or y-coordinate axis. By a right click together with a mouse movement the model can be moved horizontally or vertically. Simultaneous left click and use of the shift key on your keyboard will let you turn the assembly around the z-axis. A general method to increase or decrease the screen contents may also be the use of the + or - button in the second symbol bar. By pressing one of them them beside the 3D magnet model also all other contents of the screen can be changed by size. With the help of the neighbored SO symbol respective zoom factors for texts and diagrams can be stored as defaults for any new calculations. By this it is possible to adjust the software to the users screen resolution. The coordinate system symbol you can switch on and off by the respective button in the second symbol bar. Please push now the GO-button to start the field calculations. After a few seconds they should be completed. The progress will be shown by a respective progress bar. Please push then the button to show a diagram for the results of the radial field component as indicated in the picture below by the arrow. The button there shows the letters r and x. The three neighbored buttons to the right stand for the other two field components as well as for the absolute field value.
Now look onto your first results. These are the values of the radial field component as a function of the circular angle. Instead of using the full angular range it can be cut to a defined interval. To change the diagram please click on the respective button on the left side of the second row of symbols, see the picture below. By this an input dialog will open to let you change the start and stop angle. In case you want to return from the field diagram back to the 3D magnet model, please click the respective button in the right half of the second symbol bar. Right beside this button (here in grey) are three option buttons for the 3D model (Hide/Show coordinate triangle, Transparent magnet model, Default position).
The fields can also be presented as numerical listings, which can be opened by clicking on the respective bright gray buttons in the first symbol bar. The first of these buttons opens the listing of the radial component when cylindrical result coordinates are used. For systems needing cartesian coordinates this button shows the x-component. Generally for cylindrical magnets by default a cylindrical coordinate system for the resulting components is applied. But for all kinds of magnets also cartesian coordinates can be chosen for the output. By clicking the button with the two doted lines in the options bar (second symbol bar) one can change the total number of values which PS-PERMAG computes on a chosen path. To finalize such change the computation has to be repeated by using the GO button.
Additional calculations based on the single field components are e.g. Fourier series expansions. In case you would like to have an overview over the approximation of e.g. the radial field by such series, please click in the third bar (evaluation bar) and there on the first of the gray symbols in the last quad. Then the original curve together with its Fourier approximations up to specified grades are graphed. Below this is shown for the first two poles after having constricted the geometric diagram angle to 180deg. Which and how many grades are chosen for graphical depiction can be determined by clicking the first button of the second symbol bar. A listing of all numerical coefficients of the Fourier series can be shown for each single field component by clicking on the respective button with letter c in the third symbol bar, like shown below by the respective arrow. In addition the distribution of different wave orders can also be shown graphically by clicking the respective button in the second last quad of the third row of symbols.
Another sort of evaluations are field angles which are of importance e.g. in sensor technology. In the evaluation bar (third row) a click on the respective button of the second triplet reveals these angles graphically. Below the angle of the field projection in the r-phi plane is shown. The buttons of the first triplet provide the respective numerical listings of these angles. All angles are defined between -180deg and +180deg. Graph colours can be chosen generally in the options bar as being shown by the respective button and its dialog mask below.
For field evaluation beside circular paths for all kinds of magnets also straight lined paths can be defined. In addition all results on all sorts of paths can be shown in cylindrical as well as in cartesian coordinates. In the picture below the respective buttons for the change of path geometry and also for the choice of result coordinates are marked by respective arrows. By choosing the button for defining a magnet after having switched to a linear path, an input dialog as shown below will open. To display the 3D model as shown below again the switching button in the second symbol bar is to be used. The linear path is displayed by a green line. In the case below the linear path shall run 1mm above the center of the first pole, starting at a radius of 12mm and ending at 24mm. Due to the input dialog linear paths are always defined by their cartesian coordinates of start and end point locations. Because the center of the first pole is located at 30° here, and as the axial length of the magnet is defined as hm=6mm, the following coordinates for the start point location have to be put in: x=12*cos(30)=10.392, y=12*sin(30)=6.0,z=hm/2+1=4.0. The respective figures for the end of the linear path are: x=24*cos(30)=20.785, y=24*sin(30)=12.0, z=hm/2+1=4.0. After finishing the input dialog the computation has to be started by use of the Go button.
In the next screenshot we show the result of the x component of the field after a problem definition on a linear path like in the picture above. The result coordinate system has been switched to cartesian coordinates here. Because we have a straight line path the results are shown as a function of distance.

## Tutorial 3.1

### Learn here to handle the new features of version 3.1. New two pole sensor magnets with ledges and depressions

Input of an axially magnetized two pole sensormagnet with depressions and ledges

This tutorial shows the geometry input of the new sorts of two pole sensormagnets with depression and ledges, which have been added in PS-PERMAG version 3.1. The basic use of PS-PERMAG can be studied in Tutorial 3.0.

The following treats a two pole, axially magnetized sensormagnet. The geometry input of the other two new sorts of magnets, i.e. two pole diametrical and two pole axial-lateral, has to be done by the same way. First there has to be defined a basic cylinder. Depressions and ledges will be subtracted from this basic cylinder by up to four additional help volumes.

A depression on the magnets top face can be defined by the input of radius and height of help volume V1, which will be subtracted from the basic cylinder, see next picture.
If a ledge on the outside of the top face is needed, help volume V2 can be used. The radius r2 here stands for the radial depth of the ledge beginning at the outside of the basic cylinder, see the next picture.
If at the bottom face another circular depression is needed this can be modeled with the help of volume V3. See next picture
Finally another ledge can be built also at the bottom face, here with volume V4. The radius again stands for the radial length starting at the outer circumference of the basic cylinder.

# Tutorial 3.2

In this tutorial we explain three new features of verion 3.2. These are the rotatable result coordinates, the cuboit-kit system as well as the feature of axial magnetic bearings.

Rotatable Result-Coordinates
In version 3.2 for all sorts of magnets rotatable result coordinates were introduced. With this feature the respective coordinate system can be rotated about its own axes so that new coordinate systems result. Amongst others this is of importance for magnetic sensors. In such systems marginal tolerances  during their assemby or inside the sensorchips of a few 0.01mm can lead to serious lacks of positional accuracy. With the new feature of rotatable coordinate systems the impact of related effects can be studied. In the picture below the tilt of a sensor by 5deg around its cylindrical r-axis is being defined as an example.
Is the sensor by system tolerances 1mm radially remote from the center of rotation, a tilt of the sensor by e.g. those 5deg can lead to serious increases of angular inaccuracy, as can be seen in the listing of field angles below. Here deviations of a few degrees can be observed as shown e.g. at the marked locations..
Cuboid-Kit
By the cuboid-kit assemblies of blocks of different position, size,  different strength and direction of magnetization can be defined. The following picture shows an example with a linear field path.
The following shows an input dialog typical for cuboid-kits. The single blocks are defined by their lower left position in the Cartesian coordinate system. Their extension is defined in x-, y- and z-direction by respective figures for lengths. The direction of magnetization has to be defined by the polar angle with the  z-axis (0 to 180deg) and by the azimuth angle (0 to 360deg).
The following is another example for a cuboit-kit in its 3D view. As for this kind of problems random orientations of magnetization can be defined, directions of magnetization can be vizualized here when setting the 3D view to transparency. The arrows can be switched on and off by the respeictive symbol in the options bar. If it interferes with the 3D symbol of the coordinate system, switch it off with the button left to the transparency button. The arrows show the direction of polarization inside the single cuboids, but do not indicate the strength of magnetization.
Axial Magnetic Bearings
Axial magnetic bearings with arbitrary number of poles can be defined by a new feature of the axially multipolar magnet cylinders. In the input dialog one now has the choice of defining a magnet in front of a soft magnetic plate or of defining the magnet in front of a twin magnet with opposite direction of magnetization. The following screenshot provides a magnetic bearing with four poles per magnet. Here in the input dialog a mutual distance of 5mm was chosen. The software calculates the repulsive force independently from the chosen field path.