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] 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.