Contents || Index

FINI Button

The FINI Tools are for generating K-Ratio images from a Spectrum Image (data cube) or from elemental images.

FINI stands for "Frame Initialization", where "Frame" is a NIST program (Bob Myklebust and Dale Newbury) used to quantify X-ray maps.

The FINI Button is in the Periodic Table Tool, bottom row.:

New FINI Documentation

Old FINI Documentation

Sample FINI files.


The FINI button replaces the old K-ratio Tool.  It is used for generating K-ratio maps from raw elemental maps or spectrum images.

.This button is in the lower left corner of the PPP Tool:


FINI menu:

  • Shows this html page.
  • Attach an open data cube in single pixel mode, before using this menu.  Saves raw maps. (Note 1)
  • Make k-ratio maps from previously saved raw maps.  (Note 2)
  • ---
  • Searches a directory tree, lists the FINI files.
  • Makes new FINI from old FINI and regions selected manually with PPP Tool.
  • Load background regions only.
  • ---
  • Display copy of open K-ratio images using the log-3-band color scale.
  • Show HTML documentation of log-3-band color scale.

Note 1:  Lispix will mark any spectrum plot with a FINI file (use the "set xray lines from FINI file" menu), but  for calculating sum images and generating K-ratio images, Lispix needs an open data cube (e.g. File / Open in the Lispix Menu Bar) that has already been attached to the PPP Tool using Open / attach cube - Single pixel mode (upper left button of the PPP Tool.) Also needs a FINI file, which you select when asked.  Select the text FINI file (not the Excel version of the FINI file).  Lispix will then set up the x-ray regions for elements and background, and ask if you wish to save the raw maps (which are used for displaying k-ratio maps) and then calculate and display (but not save) the k-ratio maps.  The k-ratio maps can be saved conveniently as TIFF or RAW files using File / Select & save as... in the Lispix menu bar.

Note 2: Displays k-ratio maps.  Needs a FINI file and previously saved raw maps.  Raw maps may be directly from your instrument, or made from a previous use of the above menu 1) and a data cube, and FINI file.  Remember that the file names for the xray line and background maps must match the names in the FINI file.


Generating Raw Maps of Elemental and Background Regsions from a Data Cube

These raw maps are the same as generated using PPP Tool / Cube / of Elemental regions, etc. except rather than being displayed in a data cube, they are not displayed but saved as individual TIFF files with names given by the FINI file.

Quick Instructions

  1. Load the data cube;  File / Open / select file.
  2. Open the PPP Tool:  TOOLS / PPP
  3. Attach the cube to the PPP Tool:  PPP Tool / Open / Attach cube - single pixel mode. The spectrum window and plot window should open, the cube moved to the upper right on the screen, and the PPP Tool moved to the upper left of the screen.
  4. Set the regions in the Plot window and select option to write the TIFF files:  PPP Tool / FINI / 1) Setup xray regions from FINI. Select the FINI file.  (Answer YES to "Save elemental and background sum images for k-ratios?"   This will over write old sum images with the same names.)
  5. Generate the k-ratio images:  PPP Tool / FINI / 2) Display k-ratio maps.  Select the same FINI that you choose in the last step.
  6. Colorize the k-ratio images:  PPP Tool / FINI / Display using log 3-band scale.