get_rgb_image#

VirtualBSEImager.get_rgb_image(r: Union[BaseInteractiveROI, Tuple, List[BaseInteractiveROI], List[Tuple]], g: Union[BaseInteractiveROI, Tuple, List[BaseInteractiveROI], List[Tuple]], b: Union[BaseInteractiveROI, Tuple, List[BaseInteractiveROI], List[Tuple]], percentiles: Optional[Tuple] = None, normalize: bool = True, alpha: Union[None, ndarray, VirtualBSEImage] = None, dtype_out: Union[str, dtype, type] = 'uint8', add_bright: int = 0, contrast: float = 1.0) → VirtualBSEImage[source]#

Return an in-memory RGB virtual BSE image from three regions of interest (ROIs) on the EBSD detector, with a potential “alpha channel” in which all three arrays are multiplied by a fourth.

Parameters:

r: One ROI or a list of ROIs, or one tuple or a list of tuples with detector grid indices specifying one or more ROI(s). Intensities within the specified ROI(s) are summed up to form the red color channel.
g: One ROI or a list of ROIs, or one tuple or a list of tuples with detector grid indices specifying one or more ROI(s). Intensities within the specified ROI(s) are summed up to form the green color channel.
b: One ROI or a list of ROIs, or one tuple or a list of tuples with detector grid indices specifying one or more ROI(s). Intensities within the specified ROI(s) are summed up to form the blue color channel.
percentiles: Whether to apply contrast stretching with a given percentile tuple with percentages, e.g. (0.5, 99.5), after creating the RGB image. If not given (default), no contrast stretching is performed.
normalize: Whether to normalize the individual images (channels) before RGB image creation.
alpha: “Alpha channel”. If not given (default), no “alpha channel” is added to the image.
dtype_out: Output data type, either "uint8" (default) or "uint16".
add_bright: Brightness offset to for each array. Default is 0.
contrast: Contrast factor for each array. Default is 1.0.

Returns:

vbse_rgb_image: Virtual RGB image in memory.

Notes

HyperSpy only allows for RGB signal dimensions with data types unsigned 8 or 16 bit.