Welcome to McSAS: a tool for analysis of SAS patterns. This tool can extract form-free size distributions from small-angle scattering data using the Monte-Carlo method described in:

Brian R. Pauw, Jan Skov Pedersen, Samuel Tardif, Masaki Takata, and Bo B. Iversen. “Improvements and Considerations for Size Distribution Retrieval from Small-angle Scattering Data by Monte Carlo Methods.” Journal of Applied Crystallography 46, no. 2 (February 14, 2013 ). DOI:10.1107/S0021889813001295.

The GUI and latest improvements are described in: I. Breßler, B. R. Pauw, A. F. Thünemann, "McSAS: A package for extracting quantitative form-free distributions". Journal of Applied Crystallography 48: 962-969, DOI: 10.1107/S1600576715007347

Several form factors have been included in the package, including:

• Spheres

• Cylinders (spherically isotropic)

• Ellipsoids (spherically isotropic)

• Core-shell spheres and ellipsoids

• Gaussian chain

• Kholodenko worm

• Densely packed spheres (LMA-PY structure factor).

The package should run on a Python 3 installation, for example an Anaconda environment. Standalone packages are available for Windows, Linux and Mac OS X, make sure to get the latest release. A quick start guide and example data is included in the "doc"-directory that comes with the distribution.

To run McSAS from the source code repository (i.e. using a Python interpreter), the following items are required:

• Python 3, with the following packages:
• Numpy
• Scipy
• matplotlib
• PySide2

On Linux, there might also be the ImageTk module required. Install it like this on Debian/Ubuntu based systems:

sudo apt-get install python3-pil python3-pil.imagetk

For those unfamiliar with the Git versioning system, there is helpful reading material provided by GitHub and a somewhat easy to use graphical user interface GitHub Desktop along with extensive documentation about it. This is a GUI around the Git versioning system that simplifies the usage and allows you to get started quickly.

Use the green "Code" button in the top left area of this page to download a copy of the latest source code tree. Following this, McSAS can be started from a terminal window, as shown below:

1. Open a terminal window. Typically, it is opened in the current users home directory. You can change the current directory to another/path (which should exist) by entering

   cd another/path
   

2. Download a copy of the McSAS source code into the new directory McSAS using GIT:
   (on Windows, download & install GIT from here)

   $ git clone https://github.com/BAMresearch/McSAS.git
   

3. Change the current directory to the src subfolder:

   cd McSAS/src
   

4. Launch and start the McSAS GUI by calling it like a Python module:

   python3 -m mcsas
   

Alternatively, on Windows systems, double-clicking the "main.py" file should start McSAS with the primary Python interpreter as well.

Standalone packages are available in the Releases section of this page in the right pane. These are available for Mac OS X (tested on 10.6, 10.8 and 10.10), Windows and Linux. These do not require any additional software to be installed on the host computer.