class_docstr: Add gaussian noise to a batch of multi-dimensional images.
  
  .. image:: _static/img/RandomPlasmaShadow.png
  
  This is based on the original paper: TorMentor: Deterministic dynamic-path, data augmentations with fractals.
  See: :cite:`tormentor` for more details.
  
  .. note::
      This function internally uses :func:`kornia.contrib.diamond_square`.
  
  Args:
      roughness: value to scale during the recursion in the generation of the fractal map.
      shade_intensity: value that scales the intensity values of the generated maps.
      shade_quantity: value to select the pixels to mask.
      same_on_batch: apply the same transformation across the batch.
      p: probability of applying the transformation.
      keepdim: whether to keep the output shape the same as input (True) or broadcast it
               to the batch form (False).
  
  Examples:
      >>> rng = torch.manual_seed(0)
      >>> img = torch.ones(1, 1, 3, 4)
      >>> RandomPlasmaShadow(roughness=(0.1, 0.7), p=1.)(img)
      tensor([[[[0.7682, 1.0000, 1.0000, 1.0000],
                [1.0000, 1.0000, 1.0000, 1.0000],
                [1.0000, 1.0000, 1.0000, 1.0000]]]])
class_docstr_tok: ["Add","gaussian","noise","to","a","batch","of","multi-dimensional","images",".","..","image",":",":","_static\/img\/RandomPlasmaShadow.png","This","is","based","on","the","original","paper",":","TorMentor",":","Deterministic","dynamic-path",",","data","augmentations","with","fractals",".","See",":",":","cite",":","`","tormentor","`","for","more","details",".","..","note",":",":","This","function","internally","uses",":","func",":","`","kornia.contrib.diamond_square","`",".","Args",":","roughness",":","value","to","scale","during","the","recursion","in","the","generation","of","the","fractal","map",".","shade_intensity",":","value","that","scales","the","intensity","values","of","the","generated","maps",".","shade_quantity",":","value","to","select","the","pixels","to","mask",".","same_on_batch",":","apply","the","same","transformation","across","the","batch",".","p",":","probability","of","applying","the","transformation",".","keepdim",":","whether","to","keep","the","output","shape","the","same","as","input","(","True",")","or","broadcast","it","to","the","batch","form","(","False",")",".","Examples",":",">",">",">","rng","=","torch.manual_seed","(","0",")",">",">",">","img","=","torch.ones","(","1",",","1",",","3",",","4",")",">",">",">","RandomPlasmaShadow","(","roughness=","(","0.1",",","0.7",")",",","p=1",".",")","(","img",")","tensor","(","[","[","[","[","0.7682",",","1.0000",",","1.0000",",","1.0000","]",",","[","1.0000",",","1.0000",",","1.0000",",","1.0000","]",",","[","1.0000",",","1.0000",",","1.0000",",","1.0000","]","]","]","]",")"]
code: def __init__(
      self,
      roughness: Tuple[float, float] = (0.1, 0.7),
      shade_intensity: Tuple[float, float] = (-1.0, 0.0),
      shade_quantity: Tuple[float, float] = (0.0, 1.0),
      same_on_batch: bool = False,
      p: float = 0.5,
      keepdim: bool = False,
  ) -> None:
      super().__init__(
          p=p, same_on_batch=same_on_batch, p_batch=1.0, keepdim=keepdim
      )
      self._param_generator = rg.PlainUniformGenerator(
          (roughness, "roughness", None, None),
          (shade_intensity, "shade_intensity", None, None),
          (shade_quantity, "shade_quantity", None, None),
      )
  
file_path: kornia/kornia/augmentation/_2d/intensity/plasma.py
imports: from typing import Any, Dict, Optional, Tuple
  from kornia.augmentation import random_generator
  from kornia.augmentation._2d.intensity.base import IntensityAugmentationBase2D
  from kornia.contrib import diamond_square
  from kornia.core import Tensor
label_desc: Use image node_id 1 to create a new RandomPlasmaShadow object from inherited base classes: IntensityAugmentationBase2D with example: obj = RandomPlasmaShadow(roughness, shade_intensity, shade_quantity, same_on_batch, p, keepdim)