OOF2: The Manual
Name
TSL2 (TSLreader2) — TSL .ang file with phase id in column 8
Synopsis
TSLreader2(flip_x, flip_y, angle_offset)
Details
-
Base class:
OrientMapReader -
Parameters:
flip_x- Flip data, swapping x and -x. Type: Boolean: True or False.
flip_y- Flip data, swapping y and -y. Type: Boolean: True or False.
angle_offset- Subtract this angle (in degrees) from phi1. Type: A real number.
Description
This OrientMapReader reads data
files produced by TSL (now ESAX)[47] EBSD devices. There is no guarantee that it is up to
date. It was written to read files that were provided to us as
examples 10 or more years ago, and is not based on any formal file
specification. The TSLreader
reader is based on an older example file. If the
TSL readers do not work, try using GenericReader instead.
OOF2 expects the data file to start with some number of header
lines that begin with #. The content of these lines
is ignored, except that if one of them begins with # GRID:
HexGrid the data will be assumed to lie on a hexagonal grid.
After the header comes a table of data, with one line for each data
point (pixel). There must be at least 5 columns of data. The first
three are Bunge angles, and the
next two are x and y coordinates. OOF2 ignores any additional
columns, except for the 8th, which can
contain the name of a phase. Pixels with the same phase name will
be placed into a pixel
group with that name.
OOF2 only works on rectangular grids pixels. If the x values of
the first two rows of data are not the same, or if
HexGrid was found in the header, OOF2 assumes that
the data file contains a hexagonal grid, and converts it to a
rectangular grid by discarding every other row.
The parameters flip_x, flip_y,
and angle_offset provide some flexibility in
interpreting the data file.
![]() |
Warning |
|---|---|
|
Please see the warning about how orientation data is interpreted. |
[47] This interface between TSL files and OOF2 was created at the request of OOF2 users and does not represent an endorsement of TSL or ESAX by NIST.


![[Warning]](IMAGES/warning.png)

