ImagePRO-Python 1.0.5__py3-none-any.whl → 1.1.0__py3-none-any.whl

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.5.dist-info → imagepro_python-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ImagePRO-Python
-Version: 1.0.5
+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.5.dist-info → imagepro_python-1.1.0.dist-info}/RECORD

@@ -17,14 +17,15 @@ ImagePRO/pre_processing/contrast.py,sha256=64PL626Gxe_y8ZK1vKH7WQXfr0dW2bTNTAOHT
 ImagePRO/pre_processing/crop.py,sha256=qrx-Kl5LO3udGrZaAlNVaR-MuCXpsMZfR1pTSOOMbjk,2184
 ImagePRO/pre_processing/dataset_generator.py,sha256=kvu0m71HHOEqviQ6tDpKK3lVCBORUUa6cHl7Bsitih8,6391
 ImagePRO/pre_processing/grayscale.py,sha256=IjMCvH7z4q1NCS8pm7S8A4hVigbLQbsjwvjfDQWmthY,1522
+ImagePRO/pre_processing/histogram.py,sha256=NyP9d8OV2q7s67x4oeb-T4UthICCImpRpEKLm32wUoM,2629
 ImagePRO/pre_processing/resize.py,sha256=BGGLGao_1uc8B1kZFa5MVYcTzaeeP1qkjFei6M_eIZc,1501
 ImagePRO/pre_processing/rotate.py,sha256=kdauqCpn71Yube351o1tmQFyxcj2cjTs0ZJflxsoet8,3926
 ImagePRO/pre_processing/sharpen.py,sha256=kW9KVXvQ77qezBfUWH7loqstQqJ2QvK7s0gtwoxR4EI,3285
 ImagePRO/utils/__init__.py,sha256=McVd-o9KtKOpAVYbLi19KxsatPPFFF-Qbt0gdgY3Ln8,170
 ImagePRO/utils/image.py,sha256=x93cBNycNOgET20a__TxZ9ZQo_2G84uB7QjXjBo9f8M,3973
 ImagePRO/utils/result.py,sha256=DAFaFZ5jZZ7C2YrhRs6h2PAei6Mbv1Mu8xX_2NQ7c6Y,5605
-imagepro_python-1.0.5.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
-imagepro_python-1.0.5.dist-info/METADATA,sha256=Qgg5IKxIMyNAbMJ8JBzB5UHx-YPVo-Ibox93zXZFxvE,1618
-imagepro_python-1.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-imagepro_python-1.0.5.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
-imagepro_python-1.0.5.dist-info/RECORD,,
+imagepro_python-1.1.0.dist-info/licenses/LICENSE,sha256=sehkHN7dbe5umrINZJyJjIf9VTemZSgTfJlq6iIsbJQ,1069
+imagepro_python-1.1.0.dist-info/METADATA,sha256=DEzqs1EVVnaE4V5UmzrOkwZIYY3WJMw03nAd957i4yA,1658
+imagepro_python-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+imagepro_python-1.1.0.dist-info/top_level.txt,sha256=UOuPzsoWrVKXgUupOSI96shJ6wE8Fhz-8bm8oMlLC3s,9
+imagepro_python-1.1.0.dist-info/RECORD,,