ImagePRO-Python 1.0.4__tar.gz → 1.1.0__tar.gz

{imagepro_python-1.0.4/src/ImagePRO_Python.egg-info → imagepro_python-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.0.4
+Version: 1.1.0
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -24,6 +24,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy<2.0,>=1.24
 Requires-Dist: opencv-python<5.0,>=4.8
+Requires-Dist: matplotlib<3.9.0,>=3.7.0
 Provides-Extra: yolo
 Requires-Dist: ultralytics<9.0,>=8.2.0; extra == "yolo"
 Provides-Extra: mediapipe

{imagepro_python-1.0.4 → imagepro_python-1.1.0}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "ImagePRO-Python"
-version = "1.0.4"
+version = "1.1.0"
 description = "Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration."
 readme = "README.md"
 requires-python = "==3.10.*"
@@ -30,6 +30,7 @@ classifiers = [
 dependencies = [
   "numpy>=1.24,<2.0",
   "opencv-python>=4.8,<5.0",
+  "matplotlib>=3.7.0,<3.9.0"
 ]
 
 [project.optional-dependencies]

imagepro_python-1.1.0/src/ImagePRO/pre_processing/histogram.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+import cv2
+import matplotlib.pyplot as plt
+
+from ImagePRO.utils.image import Image
+from ImagePRO.utils.result import Result
+
+def show_histogram(image: Image) -> Result:
+    """
+    Displays the histogram of an image with customizable options.
+    
+    This function visualizes the intensity distribution of an image. It handles both grayscale
+    and color images, with automatic detection of image type. For color images, it displays
+    histograms for each color channel (BGR or RGB) with appropriate colors.
+
+    Args:
+        image (Image):
+            Input image to convert. Must be BGR, RGB or Grayscale format.
+
+    Returns:
+        Result: Result object with histogram plot.
+            - image (np.ndarray): None
+            - data (None): matplotlib.pyplot object
+            - meta (dict): Contains source object and operation info
+
+    Raises:
+        TypeError: If image is not an Image instance
+        ValueError: If image colorspace is not defined.
+    """
+    if not isinstance(image, Image):
+        raise TypeError("'image' must be an Image instance.")
+
+    if image.colorspace == "BGR":
+        colors = ('blue', 'green', 'red')
+        plt.figure(figsize=(10, 6))
+
+        for i, color in enumerate(colors):
+            hist = cv2.calcHist([image._data], [i], None, [256], [0, 256])
+            plt.plot(hist, color=color)
+            plt.xlim([0, 256])
+            
+        
+        plt.title('Histogram of BGR Channels')
+        plt.xlabel('Pixel Intensity')
+        plt.ylabel('Frequency')
+        plt.legend(['Blue Channel', 'Green Channel', 'Red Channel'])
+           
+            
+    elif image.colorspace == "RGB":
+        colors = ('red', 'green', 'blue')
+        plt.figure(figsize=(10, 6))
+
+        for i, color in enumerate(colors):
+            hist = cv2.calcHist([image._data], [i], None, [256], [0, 256])
+            plt.plot(hist, color=color)
+            plt.xlim([0, 256])
+            
+        
+        plt.title('Histogram of RGB Channels')
+        plt.xlabel('Pixel Intensity')
+        plt.ylabel('Frequency')
+        plt.legend(['Red Channel', 'Green Channel', 'Blue Channel'])
+            
+            
+    elif image.colorspace == 'GRAY':
+        plt.figure(figsize=(10, 6))
+
+        hist = cv2.calcHist([image._data], [0], None, [256], [0, 256])
+        plt.plot(hist, color='black')
+        plt.xlim([0, 256])
+        
+    else:
+        return ValueError('Unknown colorspace')
+        
+
+    return Result(
+        image=None,
+        data=plt,
+        meta={
+            "source": image,
+            "operation": "show_histogram"
+        }
+    )

{imagepro_python-1.0.4 → imagepro_python-1.1.0}/src/ImagePRO/utils/image.py

@@ -33,7 +33,7 @@ class Image:
 
     Example:
         >>> # Load from file (default BGR)
-        >>> img = Image.from_path('input.jpg')
+        >>> img = Image.from_path('input.jpg', colorspace="BGR")
         >>> print(img.shape)  # (H, W, 3)
         >>> 
         >>> # Or wrap a NumPy array
@@ -46,13 +46,19 @@ class Image:
     source_type: SourceType = "array"
 
     @classmethod
-    def from_path(cls, path: str | Path) -> Image:
+    def from_path(
+        cls, 
+        path: str | Path,
+        colorspace: Colorspace = "BGR"
+    ) -> Image:
         """
         Create an Image instance from a file path.
 
         Args:
             path (str | Path):
                 Path to the image file.
+            colorspace (Colorspace, optional):
+                Colorspace of the image array in that path ("BGR", "RGB", or "GRAY"). Defaults to "BGR".
 
         Returns:
             Image: New Image instance loaded from disk.
@@ -60,13 +66,16 @@ class Image:
         Raises:
             TypeError: If path is not str or Path.
             ValueError: If image cannot be loaded.
+            ValueError: If colorspace is invalid.
         """
         if not isinstance(path, (str, Path)):
             raise TypeError("'path' must be a string or pathlib.Path.")
         np_image = cv2.imread(str(path))
         if np_image is None:
             raise ValueError(f"Failed to load image from {path}")
-        return cls(_data=np_image, path=Path(path), colorspace="BGR", source_type="path")
+        if colorspace not in ("BGR", "RGB", "GRAY"):
+            raise ValueError("'colorspace' must be one of 'BGR', 'RGB', 'GRAY'.")
+        return cls(_data=np_image, path=Path(path), colorspace=colorspace, source_type="path")
 
     @classmethod
     def from_array(

{imagepro_python-1.0.4 → imagepro_python-1.1.0/src/ImagePRO_Python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.0.4
+Version: 1.1.0
 Summary: Professional & modular image processing library with OpenCV, MediaPipe, and YOLO integration.
 Author-email: Parsa Safaie <parsasafaie.2568@proton.me>
 License: MIT
@@ -24,6 +24,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy<2.0,>=1.24
 Requires-Dist: opencv-python<5.0,>=4.8
+Requires-Dist: matplotlib<3.9.0,>=3.7.0
 Provides-Extra: yolo
 Requires-Dist: ultralytics<9.0,>=8.2.0; extra == "yolo"
 Provides-Extra: mediapipe

{imagepro_python-1.0.4 → imagepro_python-1.1.0}/src/ImagePRO_Python.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ src/ImagePRO/pre_processing/contrast.py
 src/ImagePRO/pre_processing/crop.py
 src/ImagePRO/pre_processing/dataset_generator.py
 src/ImagePRO/pre_processing/grayscale.py
+src/ImagePRO/pre_processing/histogram.py
 src/ImagePRO/pre_processing/resize.py
 src/ImagePRO/pre_processing/rotate.py
 src/ImagePRO/pre_processing/sharpen.py

{imagepro_python-1.0.4 → imagepro_python-1.1.0}/src/ImagePRO_Python.egg-info/requires.txt

@@ -1,5 +1,6 @@
 numpy<2.0,>=1.24
 opencv-python<5.0,>=4.8
+matplotlib<3.9.0,>=3.7.0
 
 [insightface]
 insightface<1.0,>=0.7