OOF2: The Manual

`OrientMapReader`
	6.5.1. Base RegisteredClasses

Name

OrientMapReader — Methods for reading orientation maps.

Subclasses

Subclasses are listed as they appear in the GUI and (in parentheses) as they appear in scripts.

Generic (GenericReader) — Generic EBSD data reader.
TSL (TSLreader) — TSL .ang file (old format)
TSL2 (TSLreader2) — TSL .ang file with phase id in column 8
HKL (HKLreader) — HKL channel text file

Description

OrientMapReaders read orientation maps in various formats.

Maps of different origins have different formats, which are generally poorly documented. The vendor-specific subclasses defined here have worked at some time in the past, but are not guaranteed to work now. The GenericReader lets you enter information about the format and hopefully will work on any file not covered by the specific readers.

Warning

	Warning
There are a lot of assumptions that go into reading a orientation map, and no real guarantee that the OOF2 authors have made the correct ones. These assumptions include The definition of the x and y axes. Does y increase from top to bottom or from bottom to top on the screen? The definition of the Euler angles. Which convention is being used? The reference orientation in lab space. Which orientation is the unrotated one? The reference orientation in crystal space. Which crystal axes are aligned with the unrotated x, y, and z axes? The safest procedure is to test your assumptions. Create an artificial orientation map for a simple `Microstructure` with anistropic `Properties`, rotate the material by a known angle, apply boundary conditions or external forces, and make sure that the `Microstructure` responds in the way that you expect it to. If you get results that you don't expect, see if changing settings when reading the orientation map leads to better results. In that case, the `GenericReader` gives you the most options. If OOF2 can't read your orientation map file, please contact the developers at `<[email protected]>`. We may be able to help.

There are a lot of assumptions that go into reading a orientation map, and no real guarantee that the OOF2 authors have made the correct ones. These assumptions include

The definition of the x and y axes. Does y increase from top to bottom or from bottom to top on the screen?
The definition of the Euler angles. Which convention is being used?
The reference orientation in lab space. Which orientation is the unrotated one?
The reference orientation in crystal space. Which crystal axes are aligned with the unrotated x, y, and z axes?

The safest procedure is to test your assumptions. Create an artificial orientation map for a simple Microstructure with anistropic Properties, rotate the material by a known angle, apply boundary conditions or external forces, and make sure that the Microstructure responds in the way that you expect it to. If you get results that you don't expect, see if changing settings when reading the orientation map leads to better results. In that case, the GenericReader gives you the most options.

If OOF2 can't read your orientation map file, please contact the developers at <[email protected]>. We may be able to help.


`OpaqueColor`		`Orientation`

OOF2: The Manual

Name

Subclasses

Description

See Also