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
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
- 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.
- Searches a directory tree, lists the FINI files.
- Makes new FINI from old FINI and regions selected manually with
- Load background regions only.
- Display copy of open K-ratio images using the log-3-band color
- Show HTML documentation of log-3-band
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
- Load the data cube; File / Open / select file.
- Open the PPP Tool: TOOLS / PPP
- 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.
- 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.)
- Generate the k-ratio images: PPP Tool / FINI / 2) Display
k-ratio maps. Select the same FINI that you choose in the last
- Colorize the k-ratio images: PPP Tool / FINI / Display using
log 3-band scale.
- Steps 3 and 4 are for inspecting regions before maps are made. The
channels can be calibrated for energy (default is 10 ev / chan and 0 offset)
after step 3.
The k-ratio images and their colorized counterparts
are stacked directly on top of each other. To tile them without
moving the large spectrum image or the data cube, use Window /
select image & .. / tile and select only those images
you want to tile.
- The FINI file need not have FINI in the name, but FINI / search for fini
will find all text files in any folder that do have fini in the name.
- The data cube, fini file, elemental maps and background maps should all
be in the same folder.