Advanced Photon Source at Argonne National Laboratory   APS USAXS instrument
USAXS instrument at the Advanced Photon Source,
X-ray science division, beamline 9ID-C

Advanced Photon Source

A U.S. Department of Energy, Office of Science,
Office of Basic Energy Sciences national synchrotron x-ray research facility

 
 
Argonne Home > Advanced Photon Source > USAXS >

Important links:

USAXS web page

Irena 2 (software for SAS modeling)

Nika 1 (software for SAS area detector  data reduction )

Irena 2 movies & Handouts

Nika movies & Handouts

Indra 2 (software for USAXS data reduction)

Some other useful code for Igor Pro I wrote:


Cromer-Lieberman code for IgorPro (ver. 4.0): AtomicFormFactors

Clementine, package for modeling decay kinetics

Other useful links…

Home page of Pete Jemian (more SAS)

APS SAS web page

"Nika" package of 2D -> 1D SAS data reduction macros for Igor Pro

 

Please use following citiation when using Nika package:

Jan Ilavsky, "Nika - software for 2D data reduction", J. Appl. Cryst. (2012), vol. 45, pp. 324-328. DOI:10.1107/S0021889812004037 .

Workshops on using Irena & Nika packages... since 2012 we organize at the APS ~ three sessions per year workshops on use of Irena and Nika packages. To request to be put on waiting list for next workshops send e-mail to Connie.

Nika is one of my projects, which can reduce area detector (e.g., CCD) data into 1D "lineouts" for SAXS ortt WAXS. Similarly to Irena package for 1D SAS data analysis and  USAXS data analysis Indra 2, this one is written for Igor Pro, version 6 from Wavemetrics, Inc.

Current version : 1.74 (6.3x and higher) released 6/28/2016.

Distribution:

Current version
1.74
released 6/28/2016
Installation method
Link for download
Use only one of these methods

Igor 7 (ONLY)
32bit or 64bit

Beta version !!!!

For Igor 7 only. Check Youtube channel for instructions. Uses Github to distribtue Irena, Nika, and Indra. Version is same in APS depository. If this does not work for you, see note below the table.

Igor 6
Igor 7 (32bit only)

Simple & easy. Uses Igor Pro itself to do all work :-)

For Igor 6.36 and 7.x (32bit version), Installs/updates/uninstalls Irena (+Nika, Indra, and 32 bit versions of xop), uses http to download the latest version from APS depository.

For 64 bit versions of xop, download: WIndows xops and OSX xops and copy 64 bit versions manually to User Procedures(64bit) in your Documents folder/Wavemetrics folder/Igor Pro 7 folder

 
If the above fails:
 
Igor - local copy

Universal Installer 1.31.pxp,
IgorCode.zip (~78Mb)

If you have bad network connection or need to install on many computers at once. Download both files, unzip the zip file and place in the same folder with the Universal Installer. Run the Universal installer and choose "use local copy". For Igor 6.3x and higher.

For 64 bit versions of xop, download: WIndows xops and OSX xops and copy 64 bit versions manually to User Procedures(64bit) in your Documents folder/Wavemetrics folder/Igor Pro 7 folder

java - http

For default installation of Igor Pro 6.3x with standard locations of Igor folders (Mac or Windows). Seem to fail on non-English versions of Windows! Uses http and can check available/installed versions, uninstall the packages, and install/update to the latest versions. Deprecated

Igor - http/ftp
Universal Installer

older version
Universal Installer 1.26.pxp

For Igor version 6.3x .
Universal Installer 1.19.pxp

Prior version for Igor 6.20: Universal Installer 1.14.pxp

 

Older versions of installer for older Igor Pro or in case of issues with current version.

Can uninstall, install, or update to latest relased version of Irena using Igor. Uses http, ftp, or local copy; prior versions use only ftp or local copy.

Manual methods (not recommended, unless above methods fail)
zip files
Download, unzip and install manually to proper places as indicated by folders in the zip file. Iinstall xop support manually (see below), including installing HDF5 support (provided by Wavemetrics, but not installed by default).
XOP zip files

WindowsXOPs,
MacXOPs.

Install when using zip file installlation. Please make sure you install the correct version for your platform.
Manual
Is included in the zip file.
Prior versions

Nika v 1.31, Nika_v1.60

1.18 is the last release for Igor 5.0: Nika_v_1.18

Mailing group for Nika users: If you want to be informed about Nika updates and possibly have place to inquire about data reduction problems, visit the page: http://www.aps.anl.gov/mailman/listinfo/nika_users where you can join this group.

>>> Igor 7 note: Current version of Irena is compatible with Igor 7, it has been extensively tested. Universal Installer 1.31.pxp is compatible with Igor Pro 7 (32 or 64bit) BUT it will install ONLY 32bit versions of exptensions (xops). It will install the Igor code correctly (that is same for 32 and 64 bit versions). You can use 32bit Igor 7 or manually install 64bit versions of the xops : Windows xops and OSX xops (these zip files contain both 32 and 64 bit versiosn). Proper version of the xops (Windows/OSX, 64bit/32bit) needs to be copied to User Procedures or User Procedures(64bit) in your Documents folder/Wavemetrics folder/Igor Pro 7 folder. Restart Igor Pro afterwards and all shoul work. Universal Installer 1.31.pxp (below) will not be updated to install 64bit xops.

Obtaining help:

  1. Read manual
  2. Need help and udnerstanding of Igor Pro? Check Wavemetrics youtube channel!
  3. Watch Help movies. Try my Youtube channel!
  4. Participate in one of the workshops
  5. Register for discussion group and ask author question there.
  6. E-mail author a question

BUGs can be expected, please, let me know if something is not right!

Extending the code capabilities beyond design.

 

Modification history:

1.74 6/28/2016
Due to some new features used, requires Igor 6.34 or higher
Added more lines to calibrants. Up to 10 diffraction lines re allowed and used if user selects.
Added control which sets default scaling for images when loaded, so user can set preferred scaling. Note: Igor does enforce maximum size of image and will not scale above screen size.

1.73 3/5/2016
Added Panel scaling to most large panels
Added option to provide string function which will create name for the data to enable fancy renaming of input data. Has help which pops up with example.
Moved the modification conditions for auto naming (based on 2D data name) to the tabs for sectors and lineouts, where it belongs.
Modified USAXS/SAXS/WAXS configurator for Pilatus 200kw and use of empty background subtraction (with the transmission diode measurement).

1.72 2/1/2016
Igor 7 compatibility release
Modified FITS loader to handle data from different sources, as long as we are looking for sufficiently large 2D image (either in primary or any extension).
Added small function in Menu which enables to set all paths for Nika to the same place (sample, empty, Calibration, mask…). Can be changed later, but helps to setup easily.
Modified check for updates macro to use http once, if it fails use ftp, if that fails also then bail out and give error. Should be much easier for users who are on systems without net connectivity.
Added time stamp to the Live processing print statements for user orientation.

1.70 10/30/2015
Verified to work on Igor 7 beta 1
Added Configuration manager - allows users to have multiple fully configured "versions" of Nika inside one experiment and switch between them for convenience. Great if you have two different sample-to-detector distances etc.
File import - modified Pilatus img file loader - sample which contained 4096 bytes header was provided by user, so I added code which checks for the header and if present, skips the header and stores the header in the wave note. Some minor changes to logic of all Pilatus file types, hopefully I did not break anything.
9ID/15ID normalization SAXS - minor fix. WAXS, well, it is still settling down, not sure what the right numbers are…

1.69 never released
Major addition - created new calculation of the Q resolution using integration width of pixel (that used to be there), beam size and pixel size. Added beam size controls. If set to 0, ignored.
Added some warning and better handling when preferences change uncertainty calculation method
9ID/15ID configuration - force SEM as uncertainty method for WAXS and pinSAXS (Pilatus) while Std. Dev for big SAXS (MarCCD).
Added ability to type in Q distance from center for line profile. Is rounded to nearest full pixel.

1.68 3/8/2015
Fixed Ag Behenate line 5 which had typo it the d spacing.
ADSC file format - finish, need dialog, for now added ADSC_A
Fixed Azimuthal data export ASCII export tool. Bug caused garbage production, data in Igor were correct.
Renamed Prev. tab into PolTran = Polra transform. Better term for what the procedure does.
Bug fix - Fixed calculation of one of the angles in GISAXS geometry (alpha-f), which was incorrect. This require adding two options for GISAXS geometries and adding new panel which provides user selection. It also requires extensive description in the manual. Read the manual for description.
Modified Instrument config for 9IDC USAXS/SAXS/WAXS (should work as well for 15IDD USAXS/SAXS/WAXS)

Note:

These macros MAY produce Huge files. In my testing I have seen files well beyond 1 Gb. Conversion of CCD images at 3.5k x 3.5k level (Mar Image plate) and beyond takes some time and requires major CPU power. Make sure your hardware is up to the challenge. Note, I do not yet include any pixle splitting and do not provide any "bin width" data for q space smearing...

Testing:

I have been testing this package against Fit2D package. In my test cases I have been able to reproduce same Intensity vs q dependence. Nika provides statistical errors calculated simply from statistics of pixles included in any given q bin...
 If you believe, the results are incorrect, let me know ASAP.

Registration/e-mail list:

Please, if you are using these macros let me know via e-mail. This will allow me to have some idea who is interested in these macros and how much of my time is worth to invest in further development. Also, please, indicate if you would like to be included on e-mail list I would like to maintain – I can then sent e-mail announcements when a new version is available. I will not misuse the e-mail list in any way…

 Quick disclaimer:

This set of macros is currently being developed for use on any SAS data. Their use by anyone for open science is free of charge. If you want to use them for proprietary work, please contact me, the author, Jan Ilavsky, for permission. There are no warrantees with respect to functionality of these macros, please, verify all results by independent methods.


        

Privacy & Security Notice  |   Contact Us    
This page last modified: 2016-11-28 11:22 AM