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 but it is optional. You can download it for free here. Be sure to download the corresponding version to your system architecture. It is strongly recommended that you install the xraylib package.

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.

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.

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

* opencv-python

* psutil

* pywin32 (for 32-bit system builds)

* matplotlib

Optional: xraylib v 3.3.0

XISMuS uses xraylib version 3.3.0 but it is optional. You can download it for free here. Be sure to download the corresponding version to your system architecture. Note: It is strongly recommended that you install the xraylib package.

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.