file_writer

orix.io.plugins.ang.file_writer(filename: str, xmap: CrystalMap, index: int | None = None, image_quality_prop: str | None = None, confidence_index_prop: str | None = None, detector_signal_prop: str | None = None, pattern_fit_prop: str | None = None, extra_prop: str | List[str] | None = None)

Write a crystal map to an .ang file readable by MTEX and EDAX TSL OIM Analysis v7.

The columns are phi1, Phi, phi2, x, y, image_quality, confidence_index, phase_id, detector_signal, and pattern_fit.

Parameters in masked out or non-indexed points are set to:

• euler angles = 4 * pi

• image quality = 0

• confidence index = -1

• phase ID = 0 if single phase or -1 if multi phase

• pattern fit = 180

• detector signal = 0

• extra properties = 0

Parameters:

filename

File name with an ".ang" file extension to write to.

xmap

Crystal map to write to file.

index

If the crystal map has more than one rotation/match and phase ID per point, this index can be set to write that “layer” of data to the file. For properties to be written as well, these must also have multiple values per point. To get the best match at every point, use None (default).

image_quality_prop

Which map property to use as the image quality. If not given (default), "iq" or "imagequality", if present, is used, otherwise just zeros. If the property has more than one value per point and index is not given, only the first value is used.

confidence_index_prop

Which map property to use as the confidence index. If not given (default), "ci", "confidenceindex", "scores", or "correlation", if present, is used, otherwise just zeros. If the property has more than one value per point and index is not given, only the first value is used.

detector_signal_prop

Which map property to use as the detector signal. If not given (default), "ds", or "detector_signal", if present, is used, otherwise just zeros. If the property has more than one value per point and index is not given, only the first value is used.

pattern_fit_prop

Which map property to use as the pattern fit. If not given (default), "fit" or "patternfit", if present, is used, otherwise just zeros. If the property has more than one value per point and index is not given, only the first value is used.

extra_prop

One or multiple properties to add as extra columns in the .ang file, as a string or a list of strings. If not given (default), no extra properties are added. If a property has more than one value per point and index is not given, only the first value is used.