Jan Ilavsky and Peter R. Jemian, “Irena: tool suite for modeling and analysis of small-angle scattering”, Journal of Applied Crystallography, vol. 42 (2009). Please e-mail me, if you need copy.

Manual 1.1.0 for Irena version 2.62 for Igor 7.x

Mar 18, 2017

Jan Ilavsky

Acknowledgement of authors for selected included methods:

  1. Least Squares Modeling & other methods – Jan Ilavsky
  2. Size distribution – Pete R. Jemian (Maximum entropy/regularization)
  3. Unified model – Greg Beaucage
  4. Gunier-Porod model - Bualem Hammouda
  5. Pair Distance Dist. Function – Jan Ilavsky, Pete Jemian (regularization)
  6. Fractals model – Andrew J. Allen
  7. Reflectivity (aka Parrat’s code) – Andrew Nelson
  8. Desmearing – Pete R. Jemian
  9. Ciccariello-Benedetti model - S. Ciccariello


These macros represent a collaborative work in progress and it is very likely that not all features are finished at any given time. Therefore, some features may not work fully or at all. Please note, while I try my best to verify the results, no guarantees can be made as to the reliability of these results. Please, verify results in some other way. Please report any bugs to me, I will do my best to fix them ASAP. I provide limited support for users of these macros. Limited means that my time available for this support is limited. If you need help, e-mail Igor file to me with data so I can work on your data.


The “Irena” package is a suite of Igor Pro (Wavemetrics, version Igor 7.x) macros for the evaluation of small-angle scattering data. It has been designed to use seamlessly data from APS USAXS instrument (currently beamline 9ID, Advanced Photon Source, Argonne, IL); reduced using “Indra” package. Further it can work easily with any SAS data, which have scattering vector (q), Intensity, and (optional) Intensity uncertainty (“error”). Latest releases can, in specific cases (only) use also q resolution. It can easily use “qrs” (or “qis”, NIST) naming system. It easily integrates with 2D (area detector) SAXS/WAXS data reduction package “Nika” which uses the qrs naming system. Its use for most other data is made easy by a customized import tool, which should be able to handle most “column-type” ASCII data from various SAS instruments.

Irena contains following parts:

  1. Size distribution – using Maximum Entropy, Total Non-negative least square (TNNLS) & Regularization methods for evaluation of small-angle scattering from scatterers represented by number of different form factors.
  2. Modeling (II) of SAS from up to 10 model “populations” (either Size distribution, Unified level, or diffraction peaks each) to up to 10 different data sets… VERY powerful tool. Number of form factors and structure factors.
  3. Unified fit model for fitting SAS data using up to 5 levels of combinations of Guinier and power law dependencies.
  4. Gunier-Porod model for fitting of SAS data using up to 5 “levels”
  5. Pair distance distribution function (PDDF, p(r)).
  6. Fractal model – combination of 2 mass and 2 surface fractals.
  7. Analytical models – tool with option for:
    • Debye-Bueche model for scattering from gels
    • Treubner_Strey model for small-angle diffraction
    • Cicarriello-Benedetti model for layer on smooth surfaces
  8. Small-angle diffraction tool to model diffraction in small-angle scattering area
  9. Powder diffraction fitting (WAXS) to fit peak positions for powder diffraction like data.
  10. X-ray & neutron reflectivity calculations using Parrat’s recursive method
  11. Scattering contrast calculator including anomalous effects
  12. Data import tools. Allows importing ASCII, HDF5 canSAS Nexus, or canSAS XML files. For ASCII SAS data need to be written in columns, separated by white space, tab or other separators. Allows creating user-friendly logical folder structure within Igor experiment.
  13. Data export tool – exports into ASCII, HDF5 canSAS Nexus, or canSAS XML files. For ASCII the data are written in columns, separated by white space, tab or other separators.
  14. Desmearing for finite-slit length smeared data
  15. Data manipulation tool. Allows merging, smoothing, adding together and subtracting of SAS data sets. These data sets do not have to necessarily use the same naming convention.
  16. Two plotting tools. This tool allows to generate various SAS plots (Porod, Guinier, Kratky, Zimm…) and do some basic fitting. Further the tool allows to save plot styles with various formatting parameters and then fast reapply these on other data sets, generating exactly same plots useable for publications. Plotting tool I can generate two types of 3D graphs - wire graph and “Gizmo” graph. It can also generate movies from the data.
  17. Data “mining” tool – allows searching for results (variables/strings/waves …) in the folders of Igor experiment with flexible output options.
  18. Scripting tool. Tool to run (Size distribution and Unified fit for now) tools on multiple data sets at once.
  19. Tool to create folder structure for unstructured QRS data. And few other tools…

Methods use as similar as reasonably possible. This should simplify learning curve for the users…

Name “Irena” of this package, for those really interested, is the name of my wife. All my packages have female names, for example “Nika” is the nickname of my daughter (Veronika), etc. As choice of names is more or less arbitrary, I felt that selecting the name of my wife for this large and important package will be one way to give her credit for all the time I spent working on this package and not with my family.