bl-ipf

Igor Pro procedure files that help a user handle two-dimensional (2D) data arrays whose rows represent time or scan steps and columns represent data channels.

The script was originally developed for SPring-8 Kyoto University beamline users to handle spec data files. However, it can be applicable for data analysis of other multi-channel data.

Features

• Supported formats:
  • spec standard data file format (.spec, .dat): scan data created by spec software
  • text-based 1D diffraction/scattering profile (.dat, .txt): files created by dipolar.py, a Python script that creates a 1D profiles from a two-dimensional detector image.
• Main features:
  • Load files in the above-mentioned formats as two-dimensional (2D) waves.
  • Display a graph for waves selected in the data browser.
  • Combine multiple 2D waves.
  • Extract specified rows of multiple 2D waves.

How to load the procedures

1. Put bl-ipf folder, which contains the procedure files, in Igor Pro's User Procedures folder.
2. Open the procedure window (Win: Ctrl+M, Mac: Cmd+M), type #include "SPEC" and compile it.
3. Then several handy actions are available from "Macros" menu in the menubar. One can drag and drop a SPEC scan file (.spec) into Igor Pro window or app icons. Most functions work on selected waves in Data Browser. Data browser can be opened from "Data / Data Browser" menubar item (Win: Ctrl+B, Mac: Cmd+B).

A loaded wave by this scripts is 2D and its first column and last columns are by default treated as x-axis and y-axis, respectively. This behavior can be changed from "Macros" menu.

Tips

This script loads and handles a a set of data as a 2D wave. It may be a bit more difficult for Igor Pro beginners to use a 2D wave than a conventional 1D wave. For their convenience, a few pieces of commands that handle 2D waves are written below.

// Draw graph from 2D wave manually
Display file_000[][DimSize(file_000, 1) - 1] vs file_000[][0]


// Extract a column and convert it to a normal one-dimensional wave.
// There are several methods to do so. Below two of thems are shown.

// Method 1: extract 0-th column of 2D wave `file_000` as `file_000_col0`
Duplicate/O/R=[][0]  file_000, file_000_col0
Redimension/N=-1 file_000_col0

// Method 2: extract 0-th column of 2D wave `file_000` as W_ExtractedRow
ImageTransform/G=0 getRow file_000