XISMuS

X-Ray fluorescence Imaging Software for Multiple Samples

This software is distributed with a MIT license. Further details can be found here

XISMuS is a dedicated imaging software for X-Ray Fluorescence data (MA-XRF) for Windows OS. The software has been tested on Windows 7 (Ultimate 32-Bit and 64-Bit and Home Premium 64-Bit) and Windows 10. Windows XP is not supported. Be sure to have the latest Visual C++ Redistributable Package when running on Windows 7. It can be downloaded directly from Microsoft webpage here



XISMuS most recent distribution packages can be found here 32-Bit and here 64-Bit.

A comprehensive User Guide PDF is provided in this link.

Installation

To install XISMuS, simply double-click the executable downloaded from one of the links above (32- or 64-bit depending on your system), carefully read the license agreement and follow the instructions on screen.


Note: XISMuS uses xraylib version 3.3.0. You can download it for free here. Be sure to download the corresponding version to your system architecture.Note: If XISMuS fails to launch due to missing DLL's, please install xraylib.

If xraylib is not installed, the program may still run, but auto-wizard imaging method will not be available.

Xraylib is used to ensure more precise experimental X-rays data are used. Its absence will cause XISMuS to use its internal database, which may be outdated and may be missing information for low-Z or high-Z elements.

From Source

If you rather run it from the source, on your local Python environment interpreter, simply fork or clone the repository.



git clone https://github.com/linssab/XISMuS



Be sure to have all the required Python modules installed! They are listed in the section below.

You will have to compile the Cython code, by typing in the following command on your terminal:



python .\setup_cy.py build_ext --inplace



You must have a GNU compiler to do so, as stupy_cy.py will compile the python code in cy_funcs.pyx into native C code.

Finally, add My Documents content inside your user documents folder.

Dependencies

To run it within a Python interpreter, we recommend you have Python 3.7 installed and the following packages:

The packages whose versions are mentioned are the stable versions working with XISMuS. Numba, for example, has versions that may raise issues with opencv and cause JIT funtions to malfunction.

* numpy v 1.18.1

* numba v 0.45.1

* llvmlite v 0.31

* cython (to run setup_cy.py)

* opencv-python

* SciPy
* psutil

* pywin32 (for 32-bit system builds)

* matplotlib

xraylib v 3.3.0

XISMuS uses xraylib version 3.3.0. You can download it for free here. Be sure to download the corresponding version to your system architecture. Note: If XISMuS fails to launch due to missing DLL's, please install xraylib.

If xraylib is not installed, the program will still run, but chemical mapping will be limited to few elements.

Xraylib is used to ensure more precise experimental X-rays data are used. Its absence will cause XISMuS to use its internal database, which may be outdated and may be missing information for low-Z or high-Z elements.

Funding

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under the Marie-Skłodowska Curie Innovative Training Networks (MSCA-ITN) grant agreement No 766311.