^j*dZddlmZddlmZmZmZddlZddlZ ddl m cm cm ZddlmZmZmZddlmZddlmZddlmZmZdd lmZd gZGd d eZy) aImplementation of mask-based dropout augmentation. This module provides the MaskDropout transform, which identifies objects in a segmentation mask and drops out random objects completely. This augmentation is particularly useful for instance segmentation and object detection tasks, as it simulates occlusions or missing objects in a semantically meaningful way, rather than dropping out random pixels or regions. ) annotations)AnyLiteralcastN) BboxProcessordenormalize_bboxesnormalize_bboxes)KeypointsProcessor)OnePlusIntRangeType)BaseTransformInitSchema DualTransform) ALL_TARGETS MaskDropoutceZdZdZeZGddeZ d d fd Ze d dZ ddZ ddZ ddZ dd Zdd ZxZS)raApply dropout to random objects in a mask, zeroing out the corresponding regions in both the image and mask. This transform identifies objects in the mask (where each unique non-zero value represents a distinct object), randomly selects a number of these objects, and sets their corresponding regions to zero in both the image and mask. It can also handle bounding boxes and keypoints, removing or adjusting them based on the dropout regions. Args: max_objects (int | tuple[int, int]): Maximum number of objects to dropout. If a single int is provided, it's treated as the upper bound. If a tuple of two ints is provided, it's treated as a range [min, max]. fill (float | Literal["inpaint_telea", "inpaint_ns"]): Value to fill dropped out regions in the image. Can be one of: - float: Constant value to fill the regions (e.g., 0 for black, 255 for white) - "inpaint_telea": Use Telea inpainting algorithm (for 3-channel images only) - "inpaint_ns": Use Navier-Stokes inpainting algorithm (for 3-channel images only) fill_mask (float): Value to fill the dropped out regions in the mask. min_area (float): Minimum area (in pixels) of a bounding box that must remain visible after dropout to be kept. Only applicable if bounding box augmentation is enabled. Default: 0.0 min_visibility (float): Minimum visibility ratio (visible area / total area) of a bounding box after dropout to be kept. Only applicable if bounding box augmentation is enabled. Default: 0.0 p (float): Probability of applying the transform. Default: 0.5. Targets: image, mask, bboxes, keypoints, volume, mask3d Image types: uint8, float32 Note: - The mask should be a single-channel image where 0 represents the background and non-zero values represent different object instances. - For bounding box and keypoint augmentation, make sure to set up the corresponding processors in the pipeline. Examples: >>> import numpy as np >>> import albumentations as A >>> >>> # Prepare sample data >>> image = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8) >>> mask = np.zeros((100, 100), dtype=np.uint8) >>> mask[20:40, 20:40] = 1 # Object 1 >>> mask[60:80, 60:80] = 2 # Object 2 >>> bboxes = np.array([[20, 20, 40, 40], [60, 60, 80, 80]], dtype=np.float32) >>> bbox_labels = [1, 2] >>> keypoints = np.array([[30, 30], [70, 70]], dtype=np.float32) >>> keypoint_labels = [0, 1] >>> >>> # Define the transform with tuple for max_objects >>> transform = A.Compose( ... transforms=[ ... A.MaskDropout( ... max_objects=(1, 2), # Using tuple to specify min and max objects to drop ... fill=0, # Fill value for dropped regions in image ... fill_mask=0, # Fill value for dropped regions in mask ... p=1.0 ... ), ... ], ... bbox_params=A.BboxParams( ... format='pascal_voc', ... label_fields=['bbox_labels'], ... min_area=1, ... min_visibility=0.1 ... ), ... keypoint_params=A.KeypointParams( ... format='xy', ... label_fields=['keypoint_labels'], ... remove_invisible=True ... ) ... ) >>> >>> # Apply the transform >>> transformed = transform( ... image=image, ... mask=mask, ... bboxes=bboxes, ... bbox_labels=bbox_labels, ... keypoints=keypoints, ... keypoint_labels=keypoint_labels ... ) >>> >>> # Get the transformed data >>> transformed_image = transformed['image'] # Image with dropped out regions >>> transformed_mask = transformed['mask'] # Mask with dropped out regions >>> transformed_bboxes = transformed['bboxes'] # Remaining bboxes after dropout >>> transformed_bbox_labels = transformed['bbox_labels'] # Labels for remaining bboxes >>> transformed_keypoints = transformed['keypoints'] # Remaining keypoints after dropout >>> transformed_keypoint_labels = transformed['keypoint_labels'] # Labels for remaining keypoints c,eZdZUded<ded<ded<y)MaskDropout.InitSchemar max_objects.float | Literal['inpaint_telea', 'inpaint_ns']fillfloat fill_maskN)__name__ __module__ __qualname____annotations__|/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/albumentations/augmentations/dropout/mask_dropout.py InitSchemarvs((<<rrcdt||td||_||_||_y)N)pztuple[int, int])super__init__rrrr)selfrrrr! __class__s rr#zMaskDropout.__init__|s3 1 1;? "rcdgS)zlGet targets as parameters. Returns: list[str]: List of targets as parameters. maskr)r$s rtargets_as_paramszMaskDropout.targets_as_paramss xrc|d}tj|d\}}|dk(rd}d |iS|jj|j}t ||}||k(r |dkD}d |iS|jj td|dz|}tj|jddt}|D] } ||| k(z} d |iS) a!Get parameters dependent on the data. Args: params (dict[str, Any]): Dictionary containing parameters. data (dict[str, Any]): Dictionary containing data. Returns: dict[str, Any]: Dictionary with parameters for transformation. r'T) return_numrN)dtype dropout_mask) fdropoutlabel py_randomrandintrminsamplerangenpzerosshapebool) r$paramsdatar' label_image num_labelsr.objects_to_drop labels_index label_indexs rget_params_dependent_on_dataz(MaskDropout.get_params_dependent_on_datasF|"*..$"G Z ?L --5dnn44d6F6FGO!*o>O*,#ax  -- $~~44U1j1n5M_ !xx 2AdC #/?K K;$>>L? --rc d||S|jdvr~|jtj}t j |\}}}}t dt||dz}t j|||td|jS|j}|j||<|S)aKApply dropout to the image. Args: img (np.ndarray): The image to apply the transform to. dropout_mask (np.ndarray | None): The dropout mask for the image. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed image. > inpaint_ns inpaint_telear,z&Literal['inpaint_telea', 'inpaint_ns']) rastyper6uint8cv2 boundingRectr3maxinpaintrcopy)r$imgr.r:_widthheightradiuss rapplyzMaskDropout.applys  J 997 7'..rxx8L"%"2"2<"@ Aq%Cv.!34F;;sL&$?gimirir:st thhj IIL rc d| |j|S|j}|j||<|S)aHApply dropout to the mask. Args: mask (np.ndarray): The mask to apply the transform to. dropout_mask (np.ndarray | None): The dropout mask for the mask. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed mask. )rrL)r$r'r.r:s r apply_to_maskzMaskDropout.apply_to_masks6  4>>#9Kyy{!^^\ rc  ||Std|jd}||S|ddd}t||}tj||||j j |j j}t||S)anApply dropout to bounding boxes. Args: bboxes (np.ndarray): The bounding boxes to apply the transform to. dropout_mask (np.ndarray | None): The dropout mask for the bounding boxes. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed bounding boxes. Nrbboxesr8r,) r get_processorrr/mask_dropout_bboxesr:min_areamin_visibilityr )r$rVr.r: processor image_shapedenormalized_bboxesresults rapply_to_bboxeszMaskDropout.apply_to_bboxess  M$*<*4&5BHr)ri __future__rtypingrrrrHnumpyr6/albumentations.augmentations.dropout.functional augmentationsdropout functionalr/albumentations.core.bbox_utilsrrr #albumentations.core.keypoints_utilsr albumentations.core.pydanticr (albumentations.core.transforms_interfacer r $albumentations.core.type_definitionsr__all__rrrrrzsJ#%% BB^^B<[< /xH-xHr