Source code for medical_image.algorithms.breast_mask

# SPDX-License-Identifier: AGPL-3.0-only
#
# Copyright (C) 2024-2026 [YOUR NAME / ORGANIZATION]
#
# This file is part of medical-image-std.
#
# medical-image-std is free software: you can redistribute it and/or
# modify it under the terms of the GNU Affero General Public License
# as published by the Free Software Foundation, either version 3 of
# the License, or (at your option) any later version.
#
# medical-image-std is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with medical-image-std. If not, see
# <https://www.gnu.org/licenses/>.

"""
Breast Region Masking Algorithm.

Extracts the breast area from mammogram background using Otsu thresholding
followed by largest connected component selection.

Reference:
    Nguyen et al. (2025), "A Robust Approach for Breast Cancer Classification
    from DICOM Images," ETASR Vol. 15, No. 3.

Pipeline:
    1. Otsu threshold → binary mask.
    2. Largest connected component selection → breast region.
    3. Multiply mask with original image → masked output.

Example:
    >>> algo = BreastMaskAlgorithm(device="cpu")
    >>> output = image.clone()
    >>> algo(image, output)
"""

from medical_image.algorithms.algorithm import Algorithm
from medical_image.data.image import Image
from medical_image.process.mammography import MammographyPreprocessing


[docs] class BreastMaskAlgorithm(Algorithm): """ Breast region masking algorithm for mammograms. Uses Otsu thresholding + largest connected component to isolate the breast from the background, then applies the mask to the original image. Args: mask_only: If True, output contains the binary mask (0/1) instead of the masked image. Default False. device: Torch device (e.g. "cpu", "cuda:0"). """
[docs] def __init__(self, mask_only: bool = False, device: str = None): super().__init__(device=device) self.mask_only = mask_only self._breast_mask = lambda img, out: MammographyPreprocessing.breast_mask( image=img, output=out, device=self.device ) self._apply_mask = lambda img, out: MammographyPreprocessing.apply_breast_mask( image=img, output=out, device=self.device )
[docs] def apply(self, image: Image, output: Image) -> Image: """ Apply breast region masking. Args: image: Input mammogram. output: Output Image — will contain either the binary mask (if ``mask_only=True``) or the masked mammogram. Returns: The output Image. """ if self.mask_only: self._breast_mask(image, output) else: self._apply_mask(image, output) return output