Skip to content

Pixel Manipulation

Source

Pixel manipulation methods.

Pixel manipulation is used in N2V and similar algorithm to replace the value of masked pixels.

median_manipulate(patch, mask_pixel_percentage, subpatch_size=11, struct_params=None, rng=None)

Manipulate pixels by replacing them with the median of their surrounding subpatch.

N2V2 version, manipulated pixels are selected randomly away from a grid with an approximate uniform probability to be selected across the whole patch.

If struct_params is not None, an additional structN2V mask is applied to the data, replacing the pixels in the mask with random values (excluding the pixel already manipulated).

Parameters:

  • patch (ndarray) –

    Image patch, 2D or 3D, shape (y, x) or (z, y, x).

  • mask_pixel_percentage (floar) –

    Approximate percentage of pixels to be masked.

  • subpatch_size (int, default: 11 ) –

    Size of the subpatch the new pixel value is sampled from, by default 11.

  • struct_params (StructMaskParameters or None, default: None ) –

    Parameters for the structN2V mask (axis and span).

  • rng (Generator or None, default: None ) –

    Random number generato, by default None.

Returns:

  • tuple[ndarray] –

    tuple containing the manipulated patch, the original patch and the mask.

uniform_manipulate(patch, mask_pixel_percentage, subpatch_size=11, remove_center=True, struct_params=None, rng=None)

Manipulate pixels by replacing them with a neighbor values.

Manipulated pixels are selected unformly selected in a subpatch, away from a grid with an approximate uniform probability to be selected across the whole patch. If struct_params is not None, an additional structN2V mask is applied to the data, replacing the pixels in the mask with random values (excluding the pixel already manipulated).

Parameters:

  • patch (ndarray) –

    Image patch, 2D or 3D, shape (y, x) or (z, y, x).

  • mask_pixel_percentage (float) –

    Approximate percentage of pixels to be masked.

  • subpatch_size (int, default: 11 ) –

    Size of the subpatch the new pixel value is sampled from, by default 11.

  • remove_center (bool, default: True ) –

    Whether to remove the center pixel from the subpatch, by default False.

  • struct_params (StructMaskParameters or None, default: None ) –

    Parameters for the structN2V mask (axis and span).

  • rng (Generator or None, default: None ) –

    Random number generator.

Returns:

  • tuple[ndarray] –

    tuple containing the manipulated patch and the corresponding mask.