dicom-info 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

{dicom_info-0.1.0.dist-info → dicom_info-0.2.0.dist-info}/METADATA

@@ -1,11 +1,13 @@
 Metadata-Version: 2.4
 Name: dicom-info
-Version: 0.1.0
-Summary: Prints information about DIOCM files.
+Version: 0.2.0
+Summary: Prints information about DICOM files.
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pydicom>=3.0.1
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: numpy>=1.24.0
 Dynamic: license-file
 
 # dicom-info
@@ -14,12 +16,14 @@ A command-line tool for displaying DICOM file information.
 
 ## Description
 
-dicom-info is a simple Python utility that reads and displays information from DICOM (Digital Imaging and Communications in Medicine) files. It provides a straightforward way to inspect DICOM file metadata from the command line.
+dicom-info is a simple Python utility that reads and displays information from DICOM (Digital Imaging and Communications in Medicine) files. It provides a straightforward way to inspect DICOM file metadata from the command line, and can also display DICOM images interactively.
 
 ## Requirements
 
 - Python >= 3.13
 - pydicom >= 3.0.1
+- matplotlib >= 3.7.0 (for image display)
+- numpy >= 1.24.0 (for image display)
 
 ## Installation
 
@@ -43,20 +47,37 @@ The basic syntax is:
 dicom-info FILE [FILE ...]
 ```
 
-Example:
+### Displaying Metadata
 
-```
+To display DICOM file metadata:
+
+```bash
 dicom-info path/to/file.dcm
 dicom-info file1.dcm file2.dcm file3.dcm
 ```
 
 The tool will display information for each DICOM file, including all available metadata and attributes.
 
+### Displaying Images
+
+To display DICOM images interactively, use the `--display` or `-d` flag:
+
+```bash
+dicom-info --display path/to/file.dcm
+dicom-info -d file1.dcm file2.dcm file3.dcm
+```
+
+Image display features:
+- **2D images**: Displayed as grayscale plots with a colorbar
+- **3D images**: Displayed with an interactive slider to navigate through slices
+- **Multiple files**: Each image is shown in its own subplot with the filename as the title
+
 ## Error Handling
 
 The tool will exit with status code 1 if:
 - Files are not found
 - Files are not valid DICOM files
+- When using `--display`, if no files contain pixel data
 
 ## License
 

dicom_info-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+dicom_info-0.2.0.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+dicominfo/__init__.py,sha256=MwdwA_dnMxEdk8mNT8PHcKCQMIzkdwxLOvyC-Qf_CtQ,5670
+dicom_info-0.2.0.dist-info/METADATA,sha256=X-NKpFoNL6H08SPWBZ5OE_iFb6Ev3M-nrkopdkYPsco,2041
+dicom_info-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+dicom_info-0.2.0.dist-info/entry_points.txt,sha256=tCOO5Vkl04B0doIO8msDBl5suKLYAbQwjanb9XxtgKw,46
+dicom_info-0.2.0.dist-info/top_level.txt,sha256=Sb5T-FcQW-zE4FXaF23fa5YaZ1bVGFtaKGm-FT45rHs,10
+dicom_info-0.2.0.dist-info/RECORD,,

{dicom_info-0.1.0.dist-info → dicom_info-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

dicominfo/__init__.py

@@ -4,12 +4,30 @@
 
 from __future__ import annotations
 
+# Typing
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from matplotlib.axes import Axes
+    from matplotlib.image import AxesImage
+    from numpy import ndarray
+
+
 # Python imports
 import argparse
+import logging
 import sys
+from pathlib import Path
+from typing import Callable
 
 # Module imports
+import matplotlib.pyplot as plt
 import pydicom
+import pydicom.errors
+from matplotlib.widgets import Slider
+from mpl_toolkits.axes_grid1 import make_axes_locatable
+
+logger = logging.getLogger(__name__)
 
 
 def print_stats(files: list[str]) -> None:
@@ -26,6 +44,120 @@ def print_stats(files: list[str]) -> None:
         print(banner, dcm, sep="\n")
 
 
+def display_images(
+    files: list[str],
+    max_cols: int | None = None,
+) -> None:
+    """Display DICOM images with interactive controls."""
+    try:
+        dcms = [pydicom.dcmread(f) for f in files]
+
+    except (FileNotFoundError, pydicom.errors.InvalidDicomError) as err:
+        print(f"Files could not be read due to {err}")
+        sys.exit(1)
+
+    # Check if any files have pixel data
+    files_with_pixels = [
+        (f, dcm) for f, dcm in zip(files, dcms, strict=True)
+        if hasattr(dcm, "pixel_array")
+    ]
+
+    if not files_with_pixels:
+        print("No DICOM files with pixel data found.")
+        sys.exit(1)
+
+    # Create figure with subplots for each image
+    num_images = len(files_with_pixels)
+    max_cols = int(num_images ** .5) if max_cols is None else max_cols
+    cols = min(num_images, max_cols)
+    rows = (num_images - 1) // cols + 1
+    fig = plt.figure(figsize=(5 * cols, 4 * rows))
+
+    # Store references to manage 3D sliders
+    sliders = []
+    axes_images: list[
+        tuple[Axes, AxesImage, Slider | None, ndarray | None]
+    ] = []
+
+    for idx, (filepath, dcm) in enumerate(files_with_pixels, start=1):
+        pixel_array = dcm.pixel_array
+        filename = Path(filepath).name
+
+        # Determine if 2D or 3D
+        if len(pixel_array.shape) == 2: # noqa: PLR2004
+            # 2D image - simple display
+            ax = fig.add_subplot(rows, cols, idx)
+            im = ax.imshow(pixel_array, cmap="gray")
+            ax.set_title(filename)
+            ax.axis("off")
+            plt.colorbar(im, ax=ax, fraction=0.046, pad=0.04)
+            axes_images.append((ax, im, None, None))
+
+        elif len(pixel_array.shape) == 3: # noqa: PLR2004
+            # 3D image - display with slider
+            ax = fig.add_subplot(rows, cols, idx)
+
+            # Start with the first slice
+            initial_slice = 0
+            im = ax.imshow(pixel_array[initial_slice], cmap="gray")
+            ax.set_title(
+                f"{filename}\nSlice {initial_slice + 1}/{pixel_array.shape[0]}",
+            )
+            ax.axis("off")
+
+            # Create slider axes to the right of the image
+            divider = make_axes_locatable(ax)
+            slider_ax = divider.append_axes("right", size="5%", pad=0.1)
+            slider = Slider(
+                slider_ax,
+                "Slice",
+                0,
+                pixel_array.shape[0] - 1,
+                valinit=initial_slice,
+                valstep=1,
+                orientation="vertical",
+            )
+
+            # Update function for slider
+            def make_update(
+                image_obj: AxesImage,
+                axis: Axes,
+                data: ndarray,
+                fname: str,
+                sldr: Slider,
+            ) -> Callable[[float], None]:
+                def update(val: float) -> None:
+                    slice_idx = int(sldr.val)
+                    image_obj.set_data(data[slice_idx])
+                    axis.set_title(
+                        f"{fname}\nSlice {slice_idx + 1}/{data.shape[0]}",
+                    )
+                    fig.canvas.draw_idle()
+                    logger.debug("Slider at slice %f for %s", val, fname)
+
+                return update
+
+            slider.on_changed(
+                make_update(im, ax, pixel_array, filename, slider),
+            )
+            sliders.append(slider)
+            axes_images.append((ax, im, slider, pixel_array))
+
+        else:
+            logger.warning(
+                "%s has unsupported dimensions: %s",
+                filename,
+                pixel_array.shape,
+            )
+
+    plt.tight_layout()
+    if len(files_with_pixels) == 1 and axes_images[0][2] is not None:
+        # Adjust layout for single 3D image with slider
+        plt.subplots_adjust(bottom=0.15)
+
+    plt.show()
+
+
 def main() -> None:
     """Entry point for the CLI."""
     parser = argparse.ArgumentParser(
@@ -39,11 +171,29 @@ def main() -> None:
         type=str,
     )
 
+    parser.add_argument(
+        "-d",
+        "--display",
+        help="Display DICOM images instead of printing metadata.",
+        action="store_true",
+    )
+
+    parser.add_argument(
+        "-c",
+        "--columns",
+        help="Maximum number of columns for image display.",
+        type=int,
+        default=None,
+    )
+
     args = parser.parse_args()
 
-    # Print dicom info
     print_stats(args.file)
 
+    # Display images
+    if args.display:
+        display_images(args.file, max_cols=args.columns)
+
 
 if __name__ == "__main__":
     main()

dicom_info-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-dicom_info-0.1.0.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
-dicominfo/__init__.py,sha256=d4lS1hVqMRghlmhuzgi743x1pMDyNgQVEcEsXw4pPWc,1024
-dicom_info-0.1.0.dist-info/METADATA,sha256=74grN25OiNkTQ2n3QylEclvKDQBwFcewWNr8FyhYDJA,1289
-dicom_info-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-dicom_info-0.1.0.dist-info/entry_points.txt,sha256=tCOO5Vkl04B0doIO8msDBl5suKLYAbQwjanb9XxtgKw,46
-dicom_info-0.1.0.dist-info/top_level.txt,sha256=Sb5T-FcQW-zE4FXaF23fa5YaZ1bVGFtaKGm-FT45rHs,10
-dicom_info-0.1.0.dist-info/RECORD,,