OOF2: The Manual

OOF.OrientationMap.Convert_to_Image
	6.2. Menus

Name

OOF.OrientationMap.Convert_to_Image — Convert an Orientation Map into an Image, so that pixel selection tools will work on it.

Synopsis

OOF.OrientationMap.Convert_to_Image(microstructure, imagename, colorscheme)

Details

Parent Menu: OOF.OrientationMap
Callback: function _imageFromOrientationMap in module ooflib.orientationmap.orientmapmenu
Parameters:

microstructure

Convert the Orientation Map in this Microstructure Type: The path to an existing Microstructure object.

imagename

Name to give to the new Image. Type: A character string containing no colons (:), or the value automatic.

colorscheme

How to convert angles to colors. Type: An object of the Angle2Color class.

Description

This command converts an Orientation Map into an Image, and loads the Image into the map's Microstructure. This is useful if you'd like to view the map in a graphics window or use color-dependent pixel selection tools on the data in the map. Those tools only work on Images.

The microstructure parameter specifies which Orientation Map to convert. Microstructures can contain only one Orientation Map, so specifying the Microstructure name is sufficient.

The imagename parameter holds the name that will be assigned to the new Image. If the name is not unique, <x> will be appended to it, where x is a suitable integer.

The colorscheme parameter governs how orientations in the map will be converted to pixels in the Image. If most of the orientations in the Orientation Map are similar, the resulting Image will have very low contrast. It may be useful to use image modification tools, especially OOF.Image.Modify.Equalize, to enhance the contrast.

	Note
	There is no 100% satisfactory way of converting orientations to colors. The topology of orientation space is different from the topology of color space so the conversion is either discontinuous or not one-to-one.


OOF.NodeSelection.Unselect_Group		OOF.OrientationMap.Delete