D3 - The Spin Polarised Hot Neutron Beam Facility


CCSL is a library of subroutines for doing crystallographic and related calculations. It is designed not so much as a set of programs for determining and refining structures, for which several other systems are available, but as toolbox to allow the crystallography of non-trivial structures to be easily introduced into user programs.

The full documentation and download page can be found here.

The FullProf suite can be downloaded here.


A Matlab-based script is available on the instrument computer. All necessary steps are explained in the manual which can be downloaded here (pdf - 23 Mi)


Mag2Pol is a program for the analysis of single-crystal and powder diffraction data. Nuclear and magnetic structures can be refined from spherical polarimetry and flipping ratio data as well as from integrated intensities and powder patterns.  


(mp4 - 77 Mi)


Mag2Pol is distributed under the LGPLv3 (Lesser Gnu Public License version 3). A copy of the license text can be invoked from the About window within the program. The source code of the dynamically linked Qt libraries can be obtained here (zip - 1.52 Mi) (note that the original code was not modified). The QCustomPlot library can be downloaded here (zip - 225 Ki) or from The Eigen library was obtained here ( You can also consult the Privacy Policy (pdf - 34 Ki).

If this program was useful for analyzing and publishing your data, please cite it as J. Appl. Cryst. 52 175 (2019) 


    The first series of online introductory courses on Mag2Pol will take place in October 2022.
    The general use of the software as well as specific features and examples will be covered in 3 Zoom sessions of approximately 45-60 minutes (+ questions and discussion) each. Depending on eventual special requests a 4th session may be organised.

    Please subscribe to the newsletter in order to receive the Zoom links by email on the day of the respective course. Note that you need to sign in into your Zoom account in order to be able to join the courses.

    Here is the tentative programme:

    Session 1: General use and powder data analysis
    Monday, 10th October, 14:00

    • Basic features of the software
    • Setting up a (magnetic) structure model
    • Drawing bonds/polyhedra and exporting high-quality graphics
    • Generation of reflection lists, powder patterns and intensity maps
    • Setting up multiple phases
    • Treatment of powder patterns and Rietveld refinement 
    • Batch refinement

    Session 2: Magnetic structures and single-crystal data analysis 
    Monday, 17th October, 14:00

    • Describing magnetic structures using irreducible representations, magnetic space groups or magnetic superspace groups
    • Magnetic domains and structural twins
    • Modelling a single-crystal sample for absorption correction
    • Orientation matrix and 3D visualisation of a single-crystal sample in reflection condition
    • Refinement of single and multiple single-crystal data sets
    • Co-refinement of single-crystal and powder data

    Session 3: Polarised neutron techniques
    Monday, 24th October, 14:00 

    • Polarised neutron options
    • Calculation of flipping ratios and polarisation matrices
    • Simulation of magnetisation density maps
    • Multipole expansion and other magnetic form factor models
    • Correcting polarimetry data for spin-filter efficiency
    • Refinement of polarimetry data and co-refinement with integrated intensities

    Session 4: (to be confirmed)
    Monday, 31st October, 14:00 


    • intuitive GUI for setting up nuclear and magnetic structures
    • simple handling of magnetic domains
    • OpenGL widget for 3D view of structures including simple plot controls
    • calculation of structure factors (neutron or X-ray), flipping ratios and polarization matrices
    • refinement of nuclear and magnetic structures including the populations of unlimited magnetic domains and structural twins
    • correlated refinement using polarimetry data, integrated intensities and powder patterns with optional linear constraints
    • creation of reflection lists and intensity maps, powder patterns and magnetization density maps (also in 3D and for non-orthogonal systems)
    • supports 4-circle, normal-beam, minimum-tilt and cryocradle geometries
    • correction of polarization data for 3He spin-filter cell efficiency
    • simple creation of user-defined (magnetic) form factors as linear combinations of built-in ones
    • multipole expansion of magnetic form factors
    • absoprtion correction of integrated intensities for simple and arbitrary sample shapes
    • calculation of irreducible representations 
    • calculation of the spin-spin correlation function, the scattered intensity and the magnetic pair distribution function from an ordered magnetic structure or from a reverse Monte-Carlo simulation result from the Spinvert program
    • production of publication or poster quality figures
    • batch refinement of powder patterns with simple visualization of fit parameters as a function of temperature, composition or pattern number
    • pattern plotter (1D, 2D and 3D) also allowing simple manipulations of powder patterns (offsets, subtractions, etc...)


    Mag2Pol has been successfully tested and used on different data sets, see for example Qureshi et al., Phys. Rev. B97, 064404 (2018), the corresponding example files can be obtained here (zip - 10.83 Ki).
    The refinement on flipping ratios using a multipole expansion of the magnetic form factor has been tested on the data set from Aronica et al., Chem. Eur. J.13, 3666 (2007), the example files can be obtained here (zip - 7.36 Ki).

    Further examples:


    The program is certainly not 100% bug free. In order to improve it, please send bug reports by email.

    A manual (pdf - 9.77 Mi) is included in the packages and can be accessed via the menu Help. See also the demo videos at the bottom of this page.


    Mag2Pol can be downloaded for Windows (zip - 58 Mi), macOS (dmg - 51 Mi) and Linux [AppImage (appimage - 122 Mi) (only 64 bit) or Debian package (deb - 6.82 Mi) (only up to v3.0)].

    It is also available on the Mac App Store (...but the opening of files without a dialog is not yet functional due to the App Sandbox) .


    • Windows:
      execute vcredist_x64.exe (this will install the Visual Studio Redistributable packages, only necessary once)
launch Mag2Pol.exe (it has to stay in its folder with all necessary libraries)
    • macOS:
      open the dmg-file and drag the app to your Applications folder or wherever you want, right-click the app and click open
    • Linux:
      - AppImage (only 64 bit)
      Download and launch the AppImage.
      - Debian package (only up to v3.0)
      Download gdebi from a terminal: sudo apt-get install gdebi 
      Then install the debian package: sudo gdebi mag2pol_3.0.0-1_amd64.deb
      which will download the necessary libraries from the internet.
      Start the program by typing Mag2Pol


      If you want to be informed about future developments or bugfixes, you can subscribe to the Mag2Pol newsletter.

      v5.0 (June 2022)


      (mp4 - 58 Mi)

      • Time-of-flight Rietveld refinement
      • Site symmetry detection of anisotropic displacement parameters which internally sets the necessary constraints between the tensor entries
      • Propagation vector star and configuration domains allowing the analysis of all kinds of domain structures
      • Unlimited number of domains and twins for the analysis of the most complex problems
      • Further magnetic form factor models: sum of radial integrals and orbital expansion
      • Magnetic form factor plot comparing apherical and spherical models, revised magnetization density plot
      • Fit result visualization as function of sinth/lambda or peak #
      • Tabulated j2/j4/j6 magnetic form factor coefficients
      • Data reduction and export features for flipping ratio data
      • Improved constraints concerning twin and domain populations (possibility to constrain to the first domain/twin while asserting sum = 1)
      • Output of unit cell volume and normalized weight fraction in powder refinement
      • Improvement of stability and performance: more robust against model changes between refinement steps (insert/delete atom, domain, twin or whole mode), faster fitting especially for multipattern
      • Bugfixes: multiple split sites in the irreps attribution led to a crash; twin calculation was skipped when population of first twin was 0; locating powder pattern after load error could lead to truncated patterns; resolved crash when single-crystal data for multi-wavelength fit could not be opened
      • Bugfixes 13/07 (v5.0.1): resolves cif-opening bug introduced in v5.0, multi-phase cif files can now be opened (only 1st is read for the moment), fixes a crash when opening a new xml file and plotted domain number was > 1, fixes erroneous loading of user constraints for certain multi-phase xml files
      • Bugfix 18/07 (v5.0.2): propagation vector components 0.333 and 0.667 are now interpreted as 1/3 and 2/3 in the irreps calculation
      • Bugfixes 21/07 (v5.0.3): boundaries in intensity maps were not behaving correctly; spins were missing cones in the unit cell plot, if they were preceded by zero-valued spins in the list; split sites were in some cases scrambled in the unit cell plot
      • Bugfixes 31/07 (v5.0.4): fixed a crash when adding second INT data file and constraints are present under the 'Constraint' tab; improved data reduction for non-zero integer propagation vectors and centered cells; corrected small fit plot details
        • New features for the reduction of single-crystal data
        • Option to apply a transformation matrix to the (hkl) indices, e.g. for cell conversions
        • Added scattering angle and sorting capabilities to the (hkl) list
        • Search for a particular reflection using Ctrl/Cmd+Shift+F
        • Bugfix: calculated Rint was too small, when data contained unrepeated reflections without equivalents
        • Bugfix 17/02 (v4.5.1): disabled special positions were re-enabled after setting a simple constraint via a right-click context menu; bugfix in the 'all magnetic parameters' quick constraint; different magnetic ion on same atomic position is no longer excluded from the irreps calculation
        • Bugfix 21/02 (v4.5.2): powder pattern parameters were not updated in GUI after fit (bug introduced in v4.2); improved compatibility for ICSD and BCS cif/mcif files; data file strings were not displayed correctly in the different tabs of the fit window after delete/replace data; File->Reset action now closes all additionally opened windows and also clears the fit data file paths
        • Bugfixes 12/05 (v4.5.3): precision error bugfix when fitting atomic positions for (x 2x z) sites; error in constraints was in some cases wrongly signalled (e.g. 'define at least 2 parameters'); bugfix in the attribution of irreps when more than one split site is present; bugfix in the calculation of flipping ratios and polarization matrices for twins; fixes the wrong parameter attribution when an atom was switched from or to 'aniso' in the fit window; single integrated intensity data file was not correctly flagged as 'purely magnetic' after reloading in fit window; fixes the bug when fitting a magnetic model after going back from irreps basis vectors to xyz components; user-defined magnetic symmetry operators were overwritten when multiple magnetic phases were present; new feature: space groups by numbers, e.g. 139# for I4/mmm
          •     New option to export the powder pattern in the 'Pattern' tab of the fit window into an ASCII file. The calculated pattern is further separated into its different contributions, i.e. individual phases, nuclear scattering, magnetic scattering, background.
          •     New option to export the refined and plotted parameters of a batch refinement into an ASCII file.
          •     Bugfixes and improvements concerning intensity maps, both in 2D and 3D.
          •     Bugfix 29/09 (v4.1.1): the automatic check of constraints in the 'Constraints' tab led to a crash when fit flags were wrongly set and only powder data was loaded
          •     face culling is now turned on for transparent objects for improved aesthetics
          •     transparent bi-color bonds are now drawn correctly (colors were switched before)
          •     magnetic moments with amplitudes smaller than the cone length were pointing in the opposite direction in the unit cell plot
          •     bugfix in the absorption correction for spherical and cylindrical sample shapes (bug introduced in v3.0).
          •     new feature: treatment of X-ray data including atomic form factors for all elements and ions as well as wavelength-dependent anomalous dispersion part (see example), for individual calculations the source can be set in the settings menu
          •     new feature: treatment of multiple integrated intensity data sets, e.g. two neutron data sets taken with different wavelengths (see example)
          •     new feature: atomic positions, bond distances and angles as well as angles between spins can be obtained from the unit cell plot by clicking or shift-clicking the respective objects (see manual)
          •     bugfix: standard deviation was not correctly calculated for *.int-files containing structure factors and for *.sf-files
          •     bugfix in the calculation of flipping ratios for non-orthogonal systems
          •     nuclear structure parameters can now be refined against flipping ratio data
          •     fixed wrong sorting of reflections in reflection lists
          •     after the changes in description of magnetic domains in v2.3.3 the 'chiral' checkbox has been redefined to only complex-conjugate the Fourier coefficients and not to invert the phase
          •     improved undo-function, when different fits (fit matrices, fit intensities, fit both) are done
          •     bugfix: imaginary part of scattering lengths may not have been taken into account properly
          •     improved zoom and pan behaviour
          •     bugfix in the plot of ADP ellipsoids (zoom etc. not working)
          •     bugfix: fit flags for isotropic temperature factors were wrongly placed on the occupation factors
          •     bugfixes 16/07: twin and domain populations were not taken into account in FR calculation; labels in OpenGL widget were scrambled; constrained extinction parameters led to crash when fitting
          •     updates 17/07: improved load function for *cif files (basic parameters of files generated by ICSD and Vesta); option to include forbidden reflections in Rint calculation
          •     bugfix 20/07: atom and spin labels were not shown for positions, distances and angles after bugfix 16/07
          •     bugfixes 26/07: fit parameters were incorrectly saved/loaded in some cases; 'view data' button led to crash when no dataset was selected initially; Data reduction window is again shown on top, when opening the fit window with e.g. a *.col file
          •     inclusion of instrument definitions for generic angle calculations, especially for sample orientations with respect to absorption correction. Instrument angles are also shown for single calculations in the main window
          •     added xml-file support for more flexible loading/saving of parameters especially with respect to future compatiblity between versions
          •     bugfixes in absorption correction, the present version has been validated against AVEXAR of the CCSL (see Mag2Pol manual for comparison)
          •     distribution of integration points is now according to Gaussian integration procedure (see manual)
          •     added the scattering lengths of all isotopes including their incoherent scattering cross sections which is now included for the calculation of the linear absorption coefficient
          •     the crystal faces model can now be saved and loaded (only in xml format), the correct aspect ratio of the frame can be set by right-clicking the frame and selecting 'Adjust size'
          •     atoms in the 'Magnetic form factor list' can now be ordered alphabetically, by element name or by atomic number (by right-clicking the combo box)
          •     support for *.sf and *.bra files from ARRNGE and RETREAT outputs
          •     bugfix in the *.cif loading routine
          •     bugfix for some Linux systems where atoms would not be recognized
          •     Linux version is now also distributed as an AppImage, which should run on all Linux distributions (only 64 bit)
          •     shortcut to align magnetic moments along vertical instrument axis (by right-clicking the label 'z axis')
          •     flipping ratio *.fli files with 14 columns can now be opened as well
          •     maximum number of atoms increased to 40
          •     added anisotropic temperature factors (the possibility to refine and visualize them will shortly follow in v2.1)
          •     added plot controls in settings menu allowing to select which objects to draw
          •     local reference axes can be drawn, when using multipoles
          •     improved OpenGL rendering (especially for spherical harmonics)
          •     added all kinds of symmetry operators for the selection of magnetic domains (necessary when q=0 or the magnetic structure has high symmetry)
          •     all 4 SNP cross sections can now be read from the *.fli file (e.g. Pxx, Px-x, P-xx and P-x-x)
          •     bugfix in the constraint of Mr and Mi being perpendicular (when non-zero phase is defined)
          •     context menu allowing to choose between different irreducible representations now correctly opens for all magnetic sites
          •     bugfix in saving polarization matrices to a *.fli file (the flipping ratio R was not calculated and saved)
          •     bugfixes in the calculation of the magnetic form factor from multipole expansion
          •     much faster performance when refining multipoles
          •     corrected Cu form factors in the form factor table
          •     bugfix when basis vectors were used with two irreducible representations and more than one magnetic domain; furthermore, the variable switching between basis vectors and xyz components was eventually not initialized

              absorption correction of integrated intensities for spherical and cylindrical sample shapes
              introduction of user-defined basis vectors for the description of magnetic structures (for backward comptability add a line containing two zeros after '// Basis vectors ...' in the *.dat file)
              bugfix in the calculation of integrated intensities for non-orthogonal cells (polarization matrices were not affected)
              bugfix in the calculation of standard deviations of merged reflections during the data reduction of integrated intensities

          •     New phase transition tool: Define multiple phases and then plot integrated intensities or polarization matrix elements across the different phases. This is useful to explain an observed temperature/field/pressure dependence or to prepare an experiment.
          •     Option to export (magnetic) form factors into a pdf or ASCII file
          •     Customizable toolbar buttons
          •     Option to create a supercell from a structure given in P1 symmetry
          •     'Subtract dataset' option in data reduction window is now also possible for *.sf and *.bra files
          •     wavelength-dependent incoherent scattering cross section for hydrogen (see manual)
          •     Bugfixes: Setting constraints under the 'Constraint' tab does not update the model parameters anymore (avoids unwanted overwriting and eventual crashes); If integrated intensity data contains a zero-valued sigma, it is now automatically set to 1 in order to avoid divisions by 0
          •     Bugfix 19/01 (v4.4.1): Fixes a crash when re-loading saved crystal frames for absorption correction (and adds new 'Hide crystal model' option)
          •     Bugfix 26/01 (v4.4.2): Constraints with 'various' moment moduli were falsely detected as error

          (mp4 - 177 Mi)   

          • New Rietveld refinement feature: single or correlated refinement of x-ray and neutron powder patterns, possible co-refinement with integrated intensities and/or polarimetry data. Implemented presets allow to select appropriate starting values for different configurations of ILL diffractometers. The live update of the calculated pattern with any manual change of parameters allows to quickly adapt e.g. the scale factor or lattice constants before starting the refinement. Background points and excluded regions can conveniently be drawn and edited. Results have been validated against FullProf using numerous datasets.
          •     Batch fit of a series of powder patterns using one (magnetic) structure model. The observed and calculated patterns can be visualized by scrolling through the list of loaded files. A refined parameter can easily be plotted against temperature, composition or pattern number with a single click. Multiple parameters can be drawn against the left or right y-axes in the same plot.
          •     Pattern plotter for the visualization of powder data. Powder patterns can be offset, added or subtracted. A series of patterns can be plotted in 1D, 2D and even 3D, e.g. for the vizualization of thermodiffractograms.
          •     New weight triangle for the graphical selection of weight factors for correlated refinements
          •     Simple constraints between (sets of) parameters can now be set conveniently by evoking a context menu (right-click on the parameter label).
          •     Cones visualizing the spin envelope can now optionally be plotted for conical magnetic structures
          •     Improved calculation speed of error values
          •     Convergence criterium eps was changed from smallest relative parameter shift Delta to Delta/(eps*esd) < 1  (esd = estimated standard deviation); small corrections and better performance in the way standard deviations are calculated
          •     Improved ‘view results’ and ‘export results’ functions
          •     Option to convert a structure to P1
          •     Added the option not to merge Friedel pairs for non-centrosymmetric structures in the data reduction window
          •     Added magnetic form factors for rare-earth elements
          •     Possibility to hide the unit cell axes or to plot less than the 1st unit cell in order to focus e.g. on particular layers in a structure
          •     The tutorial videos at the bottom of this website are now linked to the enhanced manual.
          •     Bugfixes: the intensity of -q satellites for half-integer propagation vectors where +q is equivalent to -q was wrongly calculated; numerous GUI bug fixes related to multiphase xml files; plot of fit results with SNP data was sometimes erroneous; atom sizes of additional atoms in bonds and polyhedra were wrong; 180 degree angles between spins were sometimes shown as nan (after shift-clicking two spins); cross-section type and purely magnetic scattering was not set when integrated data was re-loaded; bug fix in the refinement of nuclear structure parameters together with SNP data; OpenGL contents were sometimes not drawn when first initialised (e.g. first drawing of unit cell, ADP ellipsoids); bug fixes related to constraints when various constraints and multiphase structures were involved; small corrections as to how the calculation of intensity maps is handled when multiple phases are present; anomalous dispersion parameters were not saved when form factor values were entered manually and not as a linear combination of implemented elements
          •     Bugfixes 02/09 (v4.0.1): new 'merge Friedel pairs' option for non-centrosymmetric space groups was not taken into account until it was re-checked or the space group was changed; upon changing a magnetic moment parameter in the fit window the powder pattern was not modified unless the magnetic structure was described using the irrep tool; lattice parameter c was not refinable for trigonal space groups in hexagonal setting when lattice constraints are active
          •     Bugfixes 10/09 (v4.0.2): mixed refinements including powder data followed by removing the powder data (either by setting the POW weight to 0 or deleting the pattern) led to a crash; domain and twin populations are now automatically unchecked and disabled when a powder-only refinement is done (like the scale and extinction parameters when no integrated intensity data is present)
          •     Bugfixes 15/09 (v4.0.3): fixes a bug in the Windows version where exported figures had a black background; fixes a problem with coordination polyhedra correctly shown in the main window but not in full-window, spin-correlation and multi-q mode; the deletion of a background point without modifying any parameter afterwards led to 'nAn' fit iterations; resolves a crash when the batch-fit window was opened after a standard fit procedure (i.e. in the same session)
          •     Bugfixes 20/09 (v4.0.4): fixes a crash when entering the fit window with more than one integrated intensity file (bug introduced in v4.0); fixes a crash when hovering the mouse over the peak labels in the pattern simulation window (bug introduced in v4.0); several GUI elements (e.g. domain window button, basis vectors button, box boundaries) are disabled at the start of the program to avoid crashes; single peak calculations could lead to a crash when at least one non-magnetic and at least one magnetic phase was present; constraints between different powder patterns are now deleted when the respective pattern file is deleted in the data tab of the fit window; if INT data is completely removed in the fit window it is now saved to the *.xml file

          (mp4 - 145 Mi)   

          • huge graphic update: significantly improved performance due to the use of vertex/fragment shaders and instancing, face culling, etc.; antialiasing through multisampling, correct transparencies due to back-to-front rendering,
          •     improved export of graphics allowing to create publication and poster quality figures
          •     new feature: generate and plot bonds and polyhedra and customize their appearance
          •     new coordinate axes instead of colored cell edges
          •     smart legend automatically showing the atoms or sites which are drawn in a different style
          •     spin envelopes can now be drawn with an envelope edge, split sites can optionally show the occupations by drawing atoms with two colors
          •     multiple cell edges can be drawn optionally and the plot automatically recenters, when the boundaries are changed
          •     light position can be adjusted by Alt-dragging the scene
          •     object resolution can be adjusted to either increase the rendering performance or the plot's details
          •     perspective shortcuts to view a structure along the direct or reciprocal axes; perspective and zoom as well as the cell boundaries are now saved in the xml file
          •     3D maps of the reciprocal space and magnetization density; this feature is particularly interesting for non-orthogonal systems
          •     support for all monoclinic setttings listed in the International Tables Vol. A; space groups with origin choices and trigonal space groups with rhombohedral or hexagonal axes settings will now open a combo box from which to choose
          •     improved click & select feature now highlights the selected object in a different color
          •     bugfix in saving the magnetic symmetry operator 'u-v'
          •     bugfix in re-saving loaded prefactors of basis vectors of the irreducible representations
          •     bugfix in the calculation of powder patterns: intensities of magnetic peaks were ignored, when the nuclear peak is forbidden and the propagation vector is 0
          •     bugfix in loading certain *.cif formats created by Vesta
          •     bugfix 03/11: axis labels were not exported in 3D maps
          •     bugfix 10/11: IN22 numors can now be converted into a fli file as well as 1-point scans (no background correction); matrix elements with negative incident polarisations had the wrong sign
          •     changes in the description of magnetic domains: Symmetry operators not in the little group will complex conjugate the Fourier coefficients and invert the phase in the magnetic domain. For an inversion domain (-x -y -z) the check box 'chiral' should therefore no longer be activated.
          •     added the 'minimum tilt' geometry as used e.g. on D10, added further 'blind reflection actions' and fixed a few bugs in the angle calculation concerning softlimits
          •     bugfix in the use of basis vectors, where the phase was not correctly applied
          •     bugfix in the load routine of xml files, where the refinement flags of twin and domain populations was not correctly read

              implementation of absorption correction for special sample shapes (see demo video below)
              crystal model utility for indexing limiting faces of the sample
              DPI scaling for Windows machines with high-resolution screens
              mouse sensitivity settings for OpenGL widgets
              adjustable font size
              constraints in the middle of the list can now be deleted by rightclicking the parameter to be constrained
              more decimals in constraint summand
              bugfix when viewing or exporting fit results of integrated intensities and flipping ratios
              bugfix in the plot of fit results (obs and cal axes were inverted)
              bugfix in determining if twin's (hkl) is integer +/- k

          •     added the option to refine on purely magnetic intensities (no changes are necessary in the description of the nuclerar/magnetic structure, the nuclear structure factor will simply be ignored)
          •     in the data reduction window it is now possible to subtract a second (high temperature) data set, missing reflections can either be ignored or set to zero (see manual)
          •     bugfix in the manual deletion of (hkl) reflections (view data table) in the case of integrated intensities
          •     bugfixes in the export to an *.int file from a *.col file
          •     user-defined form factors and scattering lengths are now saved before the Atoms section in the *.dat file (for backward compatibility modify the *.dat file manually)
          •     reflection lists are generated with a maximum Fn/Qm of 100 (instead of 10)
          •     bugfix for constraints, when various constraints are used with nuclear and magnetic refinement

          v4.3 (December 2021)

          •     New option to visualize the correlation matrix and the covariance matrix after the refinement process.
          •     Bugfixes: standard deviations between 0.5 and 1 were rounded to 1 by mistake; certain special sites in centered space groups were not recognized; stylesheet fix in 'view results' window

          v4.2 (December 2021)

          (mp4 - 106 Mi)

          •     Re-design of the app: custom designed GUI elements for a unified cross-platform appearance, color themes and dark mode
          •     UB matrix tool to refine the orientation matrix for any instrument configuration or to quickly calculate it from two vectors. A 3D model shows the sample orientation within the diffractometer and how it is rotated for a particular Bragg reflection.  
          •     On-the-fly absorption correction option allowing to refine the occupation of a strongly absorbing element while correcting absorption effects.
          •     3D guides to the eye (arrows, planes, boxes, labels, spirals, sine waves etc.) to highlight peculiarities of nuclear and magnetic structures
          •     Improved cif/mcif compatiblity and cif/mcif export
          •     Detection of site symmetries: optional warnings in the main window if an atomic position is too close to a special Wyckoff site; constraints for special Wyckoff sites are now automatically set, e.g. for sites like (x 2x z), (x x+1/2 z) etc.
          •     Automatic update check allowing to be notified of new Mag2Pol versions or bug fixes
          •     Optional atomic labels in the unit cell plot
          •     Shortcuts to quickly assign colors to the same kind of atoms
          •     'Replace data' option for *int files and powder patterns for a seamless workflow between different datasets using the same structure model
          •     Bugfixes: powder patterns with non-equal data steps are now treated correctly; crash fix for 2D plots in the pattern editor when no temperatures were read but manually modified; crash fix when modifying the appearance of a 3D map plot; empty-line bugfix in the loading routine of *.sf and *.fsq files; magnetic atom list in the 'Spins' tab was not shown correctly when switching between phases (although the unit cell plot and structure factors were correct); fixed a GUI problem when selecting polyhedra colors; removed isotope cations and anions from the list of available elements (can be defined by the user as a new element if necessary); corrected light reflection for transparent planes; first magnetic domain is now always considered in powder patterns even when its population is 0; bugfix when going from one space group with origin choice to another; wavelength and vertical direction are now re-read when clicking the 'Go' button (no need to re-generate the cell); the background of the OpenGL widget in the faces window is now visible when no frames are loaded (color can be changed as well)

          (mp4 - 61 Mi)   

          • New spin-correlation tool which calculates the spin-spin correlation function, the scattered intensity and the magnetic pair distribution function of either an ordered magnetic structure or a reverse Monte Carlo simulation result from the Spinvert program. The spin correlations can be viewed interactively between the linked 2D and 3D plots.
          •     Possibility to visualize multi-q structures, e.g. conical or fan-like structures
          •     Copy nuclear or magnetic structure tables (among others) to the clipboard and paste them in LaTeX format
          •     Re-design of the app: new toolbars with concise icons for more rapid access to the most important menu entries as well as dockable widgets for a customizable main window, new splash screen and app icon
          •     Customizable appearance of coordinate axes and legend
          •     Standard deviations from fit results are now saved in the xml file. The fit results can also be viewed in the ’Sample info’ tool.
          •     New ‘Open recent’ menu
          •     Bugfixes in the simulation of powder patterns of multi-q magnetic structures
          •     Bugfix 21/01 (v3.3.1): fixes a problem with the 'Open recent' menu
          •     Bugfixes 02/02 (v3.3.2): fixes loading of multi-wavelength files; deleting/adding magnetic atoms sorted in between nuclear atoms in the atom list caused problems (also when transferring irreps form the irrep window); fit flags are now reset when the number of (magnetic) atoms is changed in order to prevent crashes; bugfix in splitting sites in irreps calculation; split sites are now drawn with bonds and polyhedra if enabled; domain symmetry was not taken into account when using irreps; the parameter names in 'Pick various' were wrong when basis vectors are used; bugfix in loading fit results (Iy was not recognized)
          •     new feature: calculation of irreducible representations for an easy setup of magnetic structure models. The results have been validated against BasIreps and REPRES (note that the definition of the magnetic phase and the translation part of symmetry operators is not identical)
          •     new feature: generation of powder patterns for x-rays or neutrons with plotting of total, nuclear or magnetic contribution individually (see demo video below)
          •     new feature: generation of magnetization density maps. Projections, cuts and slices can be shown in different planes of the unit cell and compared between calculated models and oberved flipping ratios
          •     new feature: handling of multiple phases, e.g. for co-existing magnetic phases or powder patterns
          •     new feature: TAS data converter to condense 3-point Q scans with multiple polarization channels into a single *.fli file (contributions from A. Stunault)
          •     new feature: calculation of Schwinger flipping ratios resulting from the neutron-spin neutron-orbit interaction for non-centrosymmetric crystal structures. See our recent article for more information about Schwinger scattering for the determination of absolute crystal chiralities.
          •     further new features: constrained lattice parameters depending on the space group; 1st twin/domain population is automatically updated; more aesthetic output text in the main and fit window which is better structured and therefore easier to read; possibility to show the polarization matrix of the currently selected magnetic domain
          •     minor bugfix in the handling of twin populations
          •     bugfix 24/08: accepting changes in the 'Phases, domains and twins' window was overwriting structural paramaters of one phase
          •     bugfix 27/08: standard deviations of constrained parameters were overestimated

          v2.3.2 (March 2019)

          •     fixes a bug introduced in v2.3 where the calculation of the local coordination system was changed in order to visualize it correctly (in the previous versions the axes of the last twin were shown together with the unit cell of the first twin)
          •     possibility to specify the azimuth angle for single calculations in 4-circle geometry  
          •     (hkl) indices can be calculated from given angles by right-clicking any angle value

          v2.3.1 (March 2019)

          •     Bugfix in the xml file loading routine (magnetic moments were not correctly loaded for magnetic atoms listed after non-magnetic ones)

              visualization and fitting of anisotropic displacement parameters
              COLL5 output *.fsq files are now supported for integrated intensity data
              check all / uncheck all option for refinement flags of atomic parameters (right-click on checkbox)
              blanks in file names for automatic data loading are now supported
              bugfix for non-initialized fit parameters (randomly checked boxes in fit window)
              bugfix for undo function
              when nuclear and magnetic structures were refined simultaneously the phase of the last magnetic atom was not taken into account correctly

          v1.5.2 (June 2018)

          •     fixed a bug which showed the Multipoles tab in the Fit window without having loaded a *.fli file
          •     added the magnetic phase to the fit output text
          •     correctly removes nuclear parameters in the constrained parameters list, when unchecking 'refine nuclear structure'

          v1.5.1 (June 2018)

          •     fixed a bug which led to a crash, when saving the *.dat file on Windows and Linux machines

          v1.5 (June 2018)

          •     improved constraints for complex magnetic structures: Mr1 can be constrained to Mi2 for example, real and imaginary parts are constrained to be perpendicular if non-zero and non-parallel, etc...
          •     introduction of an 'Undo' button in the fitting routine, which permits to go back step by step when the refinement diverges or becomes worse
          •     bugfix in the generation of reflection lists in cryocradle geometry
          •     bugfix in the generation of intensity maps concerning the vertical component of the propagation vector

          Demo Videos

          The screenshot videos to the right demonstrate the main procedures used in Mag2Pol, from setting up a structure model to applying absorption corrections and refining two data sets simultaneously.


          The input and data files for the video tutorials can be downloaded here below.