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.