haGSrSSKJr SSKJrJrJr SSKrSSK J r SSK J r SSK Jr SSKJrJrJrJrJr SSKJr SS KJrJrJr SS KJr SS KJrJ r SS K!J"r"J#r# S /r$"SS\ 5r%"SS \ 5r&g)aTransform classes for dropout-based augmentations. This module contains transform classes for various dropout techniques used in image augmentation. It provides the base dropout class and specialized implementations like PixelDropout. These transforms randomly remove or modify pixels, channels, or regions in images, which can help models become more robust to occlusions and missing information. ) annotations)AnyLiteralcastN)get_num_channels)Field) functional)cutoutcutout_on_volumecutout_on_volumesfilter_bboxes_by_holesfilter_keypoints_in_holes) BboxProcessordenormalize_bboxesnormalize_bboxes)KeypointsProcessor)BaseTransformInitSchema DualTransform) ALL_TARGETSTargets PixelDropoutc^\rSrSr%Sr\rS\S'"SS\5r SU4Sjjr SSjr SS jr SS jr SS jrSS jrSS jrSSjrSSjrSSjrSSjrSrU=r$) BaseDropout"a< Base class for dropout-style transformations. This class provides common functionality for various dropout techniques, including applying cutouts to images and masks. Args: fill (tuple[float, ...] | float | Literal["random", "random_uniform", "inpaint_telea", "inpaint_ns"]): Value to fill dropped regions. fill_mask (tuple[float, ...] | float | None): Value to fill dropped regions in the mask. If None, the mask is not modified. p (float): Probability of applying the transform. Targets: image, mask, bboxes, keypoints, volume, mask3d Image types: uint8, float32 Examples: >>> import numpy as np >>> import albumentations as A >>> >>> # Example of a custom dropout transform inheriting from BaseDropout >>> class CustomDropout(A.BaseDropout): ... def __init__(self, num_holes_range=(4, 8), hole_size_range=(10, 20), *args, **kwargs): ... super().__init__(*args, **kwargs) ... self.num_holes_range = num_holes_range ... self.hole_size_range = hole_size_range ... ... def get_params_dependent_on_data(self, params, data): ... img = data["image"] ... height, width = img.shape[:2] ... ... # Generate random holes ... num_holes = self.py_random.randint(*self.num_holes_range) ... hole_sizes = self.py_random.randint(*self.hole_size_range, size=num_holes) ... ... holes = [] ... for i in range(num_holes): ... # Random position for each hole ... x1 = self.py_random.randint(0, max(1, width - hole_sizes[i])) ... y1 = self.py_random.randint(0, max(1, height - hole_sizes[i])) ... x2 = min(width, x1 + hole_sizes[i]) ... y2 = min(height, y1 + hole_sizes[i]) ... holes.append([x1, y1, x2, y2]) ... ... # Return holes and random seed ... return { ... "holes": np.array(holes) if holes else np.empty((0, 4), dtype=np.int32), ... "seed": self.py_random.integers(0, 100000) ... } >>> >>> # Prepare sample data >>> image = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8) >>> mask = np.random.randint(0, 2, (100, 100), dtype=np.uint8) >>> bboxes = np.array([[0.1, 0.1, 0.4, 0.4], [0.6, 0.6, 0.9, 0.9]]) >>> >>> # Create a transform with custom dropout >>> transform = A.Compose([ ... CustomDropout( ... num_holes_range=(3, 6), # Generate 3-6 random holes ... hole_size_range=(5, 15), # Holes of size 5-15 pixels ... fill=0, # Fill holes with black ... fill_mask=1, # Fill mask holes with 1 ... p=1.0 # Always apply for this example ... ) ... ], bbox_params=A.BboxParams(format='yolo', min_visibility=0.3)) >>> >>> # Apply the transform >>> transformed = transform(image=image, mask=mask, bboxes=bboxes) >>> >>> # Get the transformed data >>> dropout_image = transformed["image"] # Image with random holes filled with 0 >>> dropout_mask = transformed["mask"] # Mask with same holes filled with 1 >>> dropout_bboxes = transformed["bboxes"] # Bboxes filtered by visibility threshold ztuple[Targets, ...] | Targets_targetsc*\rSrSr%S\S'S\S'Srg)BaseDropout.InitSchemas^tuple[float, ...] | float | Literal['random', 'random_uniform', 'inpaint_telea', 'inpaint_ns']fill tuple[float, ...] | float | None fill_maskN)__name__ __module__ __qualname____firstlineno____annotations____static_attributes__r#i/var/www/fran/franai/venv/lib/python3.13/site-packages/albumentations/augmentations/dropout/transforms.py InitSchemarssll33r*r,c8>[TU]US9 XlX lgN)p)super__init__r r")selfr r"r/ __class__s r+r1BaseDropout.__init__ws 1 "r*c URS:XaU$URS;a[U5nUS;a [S5e[ XUR[ R RU55$)Nr inpaint_ns inpaint_telea/Inpainting works only for 1 or 3 channel images)sizer r ValueErrorr nprandom default_rng)r2imgholesseedparams num_channelss r+applyBaseDropout.applys_ ::?J 997 7+C0L6) !RSSc$))RYY-B-B4-HIIr*c URS:XaU$URS;a2URS:XaURSOSnUS;a [ S5e[ XUR[ RRU55$)Nrr6r;r:r9r<) r=r ndimshaper>r r?r@rA)r2imagesrCrDrErFs r+apply_to_imagesBaseDropout.apply_to_imagessp ::?M 997 7.4kkQ.>6<<?AL6) !RSStyy")):O:OPT:UVVr*c *UR"XU40UD6$)N)rN)r2volumerCrDrEs r+apply_to_volumeBaseDropout.apply_to_volumes##F4B6BBr*c URS:XaU$URS;a2URS:XaURSOSnUS;a [ S5e[ XUR[ RRU55$)Nrr6rJr:r9r<) r=r rKrLr>r r?r@rA)r2volumesrCrDrErFs r+apply_to_volumesBaseDropout.apply_to_volumessq ::?N 997 7/6||q/@7==+aL6) !RSS BII >> !UZZ1_KT^^RYY=R=RSW=XYYr*c URbURS:XaU$[XUR[RR U55$rZ)r"r=r r?r@rAr[s r+apply_to_masks3dBaseDropout.apply_to_masks3ds> >> !UZZ1_K dnnbii>S>STX>YZZr*c URbURS:XaU$[XUR[RR U55$rZ)r"r=r r?r@rAr[s r+ apply_to_maskBaseDropout.apply_to_masks= >> !UZZ1_Kd4>>2993H3H3NOOr*c  URS:XaU$[SURS55nUcU$USSSn[X5n[ [ UUUUR RUR RS9U5$)NrrbboxesrL)min_areamin_visibility) r=r get_processorrrr rErhri)r2rfrCrE processor image_shapedenormalized_bboxess r+apply_to_bboxesBaseDropout.apply_to_bboxess ::?M$*<*>     r*c URS:XaU$[SURS55nUbURR(dU$[ X5$)Nrr keypoints)r=rrjrEremove_invisibler)r2rqrCrErks r+apply_to_keypointsBaseDropout.apply_to_keypointssR ::? -t/A/A+/NO  I$4$4$E$E (::r*c[S5e)Nz&Subclasses must implement this method.)NotImplementedError)r2rEdatas r+get_params_dependent_on_data(BaseDropout.get_params_dependent_on_datas!"JKKr*)r r")r rr"r!r/float) rB np.ndarrayrCr{rDintrErreturnr{) rMr{rCr{rDr|rErr}r{) rQr{rCr{rDr|rErr}r{) rVr{rCr{rDr|rErr}r{) r\r{rCr{rDr|rErr}r{)rfr{rCr{rErr}r{)rqr{rCr{rErr}r{rEdict[str, Any]rwrr}r)r$r%r&r'__doc__rrr(rr,r1rGrNrRrWr]r`rcrnrsrxr) __classcell__r3s@r+rr"sL\/:H+94,4#l#4#  #JWC YZ [ P        4 ; ; ; ;  ;LLr*rc^\rSrSrSr"SS\5r\rS S U4Sjjjr SSjr SSjr SSjr SS jr SS jrS rU=r$)raDrops random pixels from the image. This transform randomly sets pixels in the image to a specified value, effectively "dropping out" those pixels. It can be applied to both the image and its corresponding mask. Args: dropout_prob (float): Probability of dropping out each pixel. Should be in the range [0, 1]. Default: 0.01 per_channel (bool): If True, the dropout mask will be generated independently for each channel. If False, the same dropout mask will be applied to all channels. Default: False drop_value (float | tuple[float, ...] | None): Value to assign to the dropped pixels. If None, the value will be randomly sampled for each application: - For uint8 images: Random integer in [0, 255] - For float32 images: Random float in [0, 1] If a single number, that value will be used for all dropped pixels. If a sequence, it should contain one value per channel. Default: 0 mask_drop_value (float | tuple[float, ...] | None): Value to assign to dropped pixels in the mask. If None, the mask will remain unchanged. If a single number, that value will be used for all dropped pixels in the mask. If a sequence, it should contain one value per channel. Default: None p (float): Probability of applying the transform. Should be in the range [0, 1]. Default: 0.5 Targets: image, mask, bboxes, keypoints, volume, mask3d Image types: uint8, float32 Note: - When applied to bounding boxes, this transform may cause some boxes to have zero area if all pixels within the box are dropped. Such boxes will be removed. - When applied to keypoints, keypoints that fall on dropped pixels will be removed if the keypoint processor is configured to remove invisible keypoints. Examples: >>> import numpy as np >>> import albumentations as A >>> image = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8) >>> mask = np.random.randint(0, 2, (100, 100), dtype=np.uint8) >>> transform = A.PixelDropout(dropout_prob=0.1, per_channel=True, p=1.0) >>> result = transform(image=image, mask=mask) >>> dropped_image, dropped_mask = result['image'], result['mask'] cL\rSrSr%\"SSS9rS\S'S\S'S \S 'S \S 'S rg )PixelDropout.InitSchemairr:)gelerz dropout_probbool per_channelr! drop_valuemask_drop_valuer#N)r$r%r&r'rrr(r)r#r*r+r,rs%#qQ/ e/4499r*r,cP>[TU]US9 XlX lX0lX@lgr.)r0r1rrrr)r2rrrrr/r3s r+r1PixelDropout.__init__s, 1(&$.r*c 0[R"XU5$)aKApply pixel dropout to the image. Args: img (np.ndarray): The image to apply the transform to. drop_mask (np.ndarray): The dropout mask. drop_values (np.ndarray): The values to assign to the dropped pixels. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed image. )fpixel pixel_dropout)r2rB drop_mask drop_valuesrEs r+rGPixelDropout.apply*s&##CK@@r*c NURcU$[R"XU5$)atApply pixel dropout to the mask. Args: mask (np.ndarray): The mask to apply the transform to. mask_drop_mask (np.ndarray): The dropout mask for the mask. mask_drop_values (float | np.ndarray): The values to assign to the dropped pixels in the mask. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed mask. )rrr)r2r\mask_drop_maskmask_drop_valuesrEs r+rcPixelDropout.apply_to_mask?s)&    'K##D:JKKr*c *UbUR(aU$[SURS55nUcU$USSSn[X5nUR(ak[ UR 5S:aR[ R"X"R SS::aSOSS 9nURS :XaUR SS :XaUSnOUn[R"UUUURRURR5n[X5$) a=Apply pixel dropout to the bounding boxes. Args: bboxes (np.ndarray): The bounding boxes to apply the transform to. drop_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. NrrfrLrgrJr)axisr;r:)rrrjrlenrLr?anyrKfdropoutmask_dropout_bboxesrErhrir) r2rfrrErkrlrm combined_maskresults r+rnPixelDropout.apply_to_bboxesWs"   0 0M$*<*+>q+AQ+F -a 0 %M--       % %    + +   44r*c U$)zApply pixel dropout to the keypoints. Args: keypoints (np.ndarray): The keypoints to apply the transform to. **params (Any): Additional parameters for the transform. Returns: np.ndarray: The transformed keypoints. r#)r2rqrEs r+rsPixelDropout.apply_to_keypointss r*cVSU;aUSOUSSn[R"URURURUR 5n[R "UURUR 5nSnSn[R"U5nURbpUbm[R"URURURUR 5n[R "UURUR 5nUUUbUOSUbUS.$SS.$)zGenerate parameters for pixel dropout based on input data. Args: params (dict[str, Any]): Transform parameters data (dict[str, Any]): Input data dictionary Returns: dict[str, Any]: Dictionary of parameters for applying the transform imagerMrN)rrrr) r get_drop_maskrLrrrandom_generatorprepare_drop_valuesrget_mask_arrayr) r2rErwreference_arrayrrrrr\s r+rx)PixelDropout.get_params_dependent_on_datas8,3d?$w-Xq@Q((  ! !        ! !  00  OO  ! ! $$T*    +0@#11   !!%% N &99$$%%  #&0>0JnPT4D4P 0   W[   r*)rrrr)g{Gz?FrNg?) rrzrrrr!rr!r/rz) rBr{rr{rr{rErr}r{) r\r{rr{rzfloat | np.ndarrayrErr}r{)rfr{rznp.ndarray | NonerErr}r{)rqr{rErr}r{r~)r$r%r&r'rrr,rrr1rGrcrnrsrxr)rrs@r+rrsQ3j:,: H#!78<@ / / /5 / : /  / /A AA A  A  A*LL#L- L  L  L0/5/5%/5 /5  /5b  "4 4 4   4 4 r*)'r __future__rtypingrrrnumpyr?albucorerpydanticr$albumentations.augmentations.dropoutr r/albumentations.augmentations.dropout.functionalr r r r r"albumentations.augmentations.pixelralbumentations.core.bbox_utilsrrr#albumentations.core.keypoints_utilsr(albumentations.core.transforms_interfacerr$albumentations.core.type_definitionsrr__all__rrr#r*r+rsg#%%%GD^^B[E  yL-yLxo =o r*