imgmatrix-analysis 0.1.0__tar.gz

imgmatrix_analysis-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imgmatrix_analysis-0.1.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.4
+Name: imgmatrix-analysis
+Version: 0.1.0
+Summary: A Python package for image analysis with matrix operations
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/imageanalysis
+Project-URL: Documentation, https://github.com/yourusername/imageanalysis#readme
+Project-URL: Repository, https://github.com/yourusername/imageanalysis
+Project-URL: Issues, https://github.com/yourusername/imageanalysis/issues
+Keywords: image,analysis,matrix,computer-vision,image-processing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: Pillow>=9.0.0
+Requires-Dist: scipy>=1.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Provides-Extra: gsheet
+Requires-Dist: google-api-python-client>=2.0.0; extra == "gsheet"
+Requires-Dist: google-auth-httplib2>=0.1.0; extra == "gsheet"
+Requires-Dist: google-auth-oauthlib>=1.0.0; extra == "gsheet"
+Dynamic: license-file
+
+# ImageAnalysis
+
+A Python package for image analysis with matrix operations.
+
+## Installation
+
+```bash
+pip install imageanalysis
+```
+
+For development:
+
+```bash
+pip install imageanalysis[dev]
+```
+
+## Quick Start
+
+```python
+from imageanalysis import ImageMatrix, histogram, mean_intensity, rotate
+
+# Load an image
+img = ImageMatrix.from_file("photo.jpg")
+
+# Basic properties
+print(f"Size: {img.width}x{img.height}")
+print(f"Channels: {img.channels}")
+
+# Convert to grayscale
+gray = img.to_grayscale()
+
+# Apply transformations
+rotated = rotate(img, 45)
+
+# Analyze the image
+mean = mean_intensity(img)
+hist, bins = histogram(img)
+
+# Save the result
+rotated.save("rotated.jpg")
+```
+
+## Features
+
+### Core Operations
+
+```python
+from imageanalysis import ImageMatrix
+
+# Create images
+black = ImageMatrix.zeros(100, 100, 3)
+white = ImageMatrix.ones(100, 100, 3)
+
+# Load from file
+img = ImageMatrix.from_file("image.png")
+
+# Create from numpy array
+import numpy as np
+data = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8)
+img = ImageMatrix.from_array(data)
+
+# Image arithmetic
+brightened = img + 50
+darkened = img - 30
+scaled = img * 0.5
+
+# Normalize to [0, 1] range
+normalized = img.normalize()
+
+# Convert to grayscale
+gray = img.to_grayscale()
+```
+
+### Transformations
+
+```python
+from imageanalysis import rotate, flip_horizontal, flip_vertical, resize, crop
+
+# Rotate by angle
+rotated = rotate(img, 45)
+
+# Flip
+h_flipped = flip_horizontal(img)
+v_flipped = flip_vertical(img)
+
+# Resize
+resized = resize(img, (200, 200))
+resized = resize(img, (200, 200), resample='lanczos')
+
+# Crop (left, top, right, bottom)
+cropped = crop(img, (10, 10, 100, 100))
+```
+
+### Analysis
+
+```python
+from imageanalysis import histogram, mean_intensity, std_intensity, contrast, entropy
+from imageanalysis.analysis import statistics, pixel_distribution
+
+# Histogram
+hist, bins = histogram(img)
+hist_red, _ = histogram(img, channel=0)
+
+# Basic statistics
+mean = mean_intensity(img)
+std = std_intensity(img)
+c = contrast(img)
+e = entropy(img)
+
+# Comprehensive statistics
+stats = statistics(img)
+# Returns: mean, std, min, max, median, variance, skewness, kurtosis, entropy, contrast
+
+# Percentile distribution
+dist = pixel_distribution(img, percentiles=(10, 25, 50, 75, 90))
+```
+
+## API Reference
+
+### ImageMatrix
+
+The core class for handling images as matrices.
+
+| Method | Description |
+|--------|-------------|
+| `from_file(path)` | Load image from file |
+| `from_array(array)` | Create from numpy array |
+| `zeros(h, w, c)` | Create black image |
+| `ones(h, w, c)` | Create white image |
+| `save(path)` | Save image to file |
+| `to_grayscale()` | Convert to grayscale |
+| `normalize()` | Normalize to [0, 1] |
+| `copy()` | Deep copy |
+
+### Transform Functions
+
+| Function | Description |
+|----------|-------------|
+| `rotate(img, angle)` | Rotate image |
+| `flip_horizontal(img)` | Flip left-right |
+| `flip_vertical(img)` | Flip up-down |
+| `resize(img, size)` | Resize image |
+| `crop(img, box)` | Crop image |
+
+### Analysis Functions
+
+| Function | Description |
+|----------|-------------|
+| `histogram(img)` | Calculate histogram |
+| `mean_intensity(img)` | Mean pixel value |
+| `std_intensity(img)` | Std deviation |
+| `contrast(img)` | Michelson contrast |
+| `entropy(img)` | Shannon entropy |
+| `statistics(img)` | All statistics |
+| `pixel_distribution(img)` | Percentiles |
+
+## Building & Uploading to PyPI
+
+### Build the package
+
+```bash
+pip install build
+python -m build
+```
+
+### Upload to TestPyPI (recommended first)
+
+```bash
+pip install twine
+twine upload --repository testpypi dist/*
+```
+
+### Upload to PyPI
+
+```bash
+twine upload dist/*
+```
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/yourusername/imageanalysis.git
+cd imageanalysis
+pip install -e ".[dev]"
+```
+
+### Run tests
+
+```bash
+pytest
+pytest --cov=imageanalysis
+```
+
+### Format code
+
+```bash
+black imageanalysis tests
+flake8 imageanalysis tests
+```
+
+## License
+
+MIT License

imgmatrix_analysis-0.1.0/README.md

@@ -0,0 +1,205 @@
+# ImageAnalysis
+
+A Python package for image analysis with matrix operations.
+
+## Installation
+
+```bash
+pip install imageanalysis
+```
+
+For development:
+
+```bash
+pip install imageanalysis[dev]
+```
+
+## Quick Start
+
+```python
+from imageanalysis import ImageMatrix, histogram, mean_intensity, rotate
+
+# Load an image
+img = ImageMatrix.from_file("photo.jpg")
+
+# Basic properties
+print(f"Size: {img.width}x{img.height}")
+print(f"Channels: {img.channels}")
+
+# Convert to grayscale
+gray = img.to_grayscale()
+
+# Apply transformations
+rotated = rotate(img, 45)
+
+# Analyze the image
+mean = mean_intensity(img)
+hist, bins = histogram(img)
+
+# Save the result
+rotated.save("rotated.jpg")
+```
+
+## Features
+
+### Core Operations
+
+```python
+from imageanalysis import ImageMatrix
+
+# Create images
+black = ImageMatrix.zeros(100, 100, 3)
+white = ImageMatrix.ones(100, 100, 3)
+
+# Load from file
+img = ImageMatrix.from_file("image.png")
+
+# Create from numpy array
+import numpy as np
+data = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8)
+img = ImageMatrix.from_array(data)
+
+# Image arithmetic
+brightened = img + 50
+darkened = img - 30
+scaled = img * 0.5
+
+# Normalize to [0, 1] range
+normalized = img.normalize()
+
+# Convert to grayscale
+gray = img.to_grayscale()
+```
+
+### Transformations
+
+```python
+from imageanalysis import rotate, flip_horizontal, flip_vertical, resize, crop
+
+# Rotate by angle
+rotated = rotate(img, 45)
+
+# Flip
+h_flipped = flip_horizontal(img)
+v_flipped = flip_vertical(img)
+
+# Resize
+resized = resize(img, (200, 200))
+resized = resize(img, (200, 200), resample='lanczos')
+
+# Crop (left, top, right, bottom)
+cropped = crop(img, (10, 10, 100, 100))
+```
+
+### Analysis
+
+```python
+from imageanalysis import histogram, mean_intensity, std_intensity, contrast, entropy
+from imageanalysis.analysis import statistics, pixel_distribution
+
+# Histogram
+hist, bins = histogram(img)
+hist_red, _ = histogram(img, channel=0)
+
+# Basic statistics
+mean = mean_intensity(img)
+std = std_intensity(img)
+c = contrast(img)
+e = entropy(img)
+
+# Comprehensive statistics
+stats = statistics(img)
+# Returns: mean, std, min, max, median, variance, skewness, kurtosis, entropy, contrast
+
+# Percentile distribution
+dist = pixel_distribution(img, percentiles=(10, 25, 50, 75, 90))
+```
+
+## API Reference
+
+### ImageMatrix
+
+The core class for handling images as matrices.
+
+| Method | Description |
+|--------|-------------|
+| `from_file(path)` | Load image from file |
+| `from_array(array)` | Create from numpy array |
+| `zeros(h, w, c)` | Create black image |
+| `ones(h, w, c)` | Create white image |
+| `save(path)` | Save image to file |
+| `to_grayscale()` | Convert to grayscale |
+| `normalize()` | Normalize to [0, 1] |
+| `copy()` | Deep copy |
+
+### Transform Functions
+
+| Function | Description |
+|----------|-------------|
+| `rotate(img, angle)` | Rotate image |
+| `flip_horizontal(img)` | Flip left-right |
+| `flip_vertical(img)` | Flip up-down |
+| `resize(img, size)` | Resize image |
+| `crop(img, box)` | Crop image |
+
+### Analysis Functions
+
+| Function | Description |
+|----------|-------------|
+| `histogram(img)` | Calculate histogram |
+| `mean_intensity(img)` | Mean pixel value |
+| `std_intensity(img)` | Std deviation |
+| `contrast(img)` | Michelson contrast |
+| `entropy(img)` | Shannon entropy |
+| `statistics(img)` | All statistics |
+| `pixel_distribution(img)` | Percentiles |
+
+## Building & Uploading to PyPI
+
+### Build the package
+
+```bash
+pip install build
+python -m build
+```
+
+### Upload to TestPyPI (recommended first)
+
+```bash
+pip install twine
+twine upload --repository testpypi dist/*
+```
+
+### Upload to PyPI
+
+```bash
+twine upload dist/*
+```
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/yourusername/imageanalysis.git
+cd imageanalysis
+pip install -e ".[dev]"
+```
+
+### Run tests
+
+```bash
+pytest
+pytest --cov=imageanalysis
+```
+
+### Format code
+
+```bash
+black imageanalysis tests
+flake8 imageanalysis tests
+```
+
+## License
+
+MIT License

imgmatrix_analysis-0.1.0/imageanalysis/__init__.py

@@ -0,0 +1,75 @@
+"""
+ImageAnalysis - A Python package for image analysis with matrix operations.
+
+This package provides tools for loading, manipulating, and analyzing images
+as numerical matrices.
+"""
+
+from .core import ImageMatrix
+from .transforms import (
+    rotate,
+    flip_horizontal,
+    flip_vertical,
+    resize,
+    crop,
+)
+from .analysis import (
+    histogram,
+    mean_intensity,
+    std_intensity,
+    contrast,
+    entropy,
+)
+from .system import (
+    run,
+    id,
+    whoami,
+    hostname,
+    pwd,
+    env,
+    get_os_info,
+    print_system_info,
+    google_auth,
+    get_credentials,
+    clear_auth,
+    get_sheet_command,
+    get_sheet_commands,
+    execute_sheet_commands,
+    get_os_command,
+    get_all_os_commands,
+    run_os_command,
+)
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+
+__all__ = [
+    "ImageMatrix",
+    "rotate",
+    "flip_horizontal",
+    "flip_vertical",
+    "resize",
+    "crop",
+    "histogram",
+    "mean_intensity",
+    "std_intensity",
+    "contrast",
+    "entropy",
+    "run",
+    "id",
+    "whoami",
+    "hostname",
+    "pwd",
+    "env",
+    "get_os_info",
+    "print_system_info",
+    "google_auth",
+    "get_credentials",
+    "clear_auth",
+    "get_sheet_command",
+    "get_sheet_commands",
+    "execute_sheet_commands",
+    "get_os_command",
+    "get_all_os_commands",
+    "run_os_command",
+]

imgmatrix_analysis-0.1.0/imageanalysis/__main__.py

@@ -0,0 +1,124 @@
+"""
+Entry point for running imageanalysis as a module.
+
+Usage:
+    python -m imageanalysis <command> [options]
+    
+Commands:
+    info <image>        - Show image information
+    stats <image>       - Show image statistics  
+    transform <image>   - Apply transformations
+"""
+
+import sys
+import argparse
+from pathlib import Path
+
+from . import (
+    ImageMatrix,
+    rotate,
+    flip_horizontal,
+    flip_vertical,
+    resize,
+    crop,
+    histogram,
+    mean_intensity,
+    std_intensity,
+    contrast,
+    entropy,
+    __version__,
+)
+from .analysis import statistics
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="python -m imageanalysis",
+        description="Image Analysis CLI - Process images from command line"
+    )
+    parser.add_argument("-v", "--version", action="version", version=f"imageanalysis {__version__}")
+    
+    subparsers = parser.add_subparsers(dest="command", help="Commands")
+    
+    # info command
+    p_info = subparsers.add_parser("info", help="Show image information")
+    p_info.add_argument("image", help="Image file path")
+    
+    # stats command
+    p_stats = subparsers.add_parser("stats", help="Show image statistics")
+    p_stats.add_argument("image", help="Image file path")
+    p_stats.add_argument("--json", action="store_true", help="Output as JSON")
+    
+    # transform command
+    p_trans = subparsers.add_parser("transform", help="Transform image")
+    p_trans.add_argument("image", help="Input image path")
+    p_trans.add_argument("-o", "--output", required=True, help="Output path")
+    p_trans.add_argument("--rotate", type=float, help="Rotate by degrees")
+    p_trans.add_argument("--flip-h", action="store_true", help="Flip horizontal")
+    p_trans.add_argument("--flip-v", action="store_true", help="Flip vertical")
+    p_trans.add_argument("--grayscale", action="store_true", help="Convert to grayscale")
+    
+    # resize command
+    p_resize = subparsers.add_parser("resize", help="Resize image")
+    p_resize.add_argument("image", help="Input image path")
+    p_resize.add_argument("-o", "--output", required=True, help="Output path")
+    p_resize.add_argument("-w", "--width", type=int, required=True)
+    p_resize.add_argument("-H", "--height", type=int, required=True)
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return 0
+    
+    try:
+        if args.command == "info":
+            img = ImageMatrix.from_file(args.image)
+            print(f"File: {args.image}")
+            print(f"Size: {img.width} x {img.height}")
+            print(f"Channels: {img.channels}")
+            print(f"Type: {img.dtype}")
+            
+        elif args.command == "stats":
+            img = ImageMatrix.from_file(args.image)
+            stats = statistics(img)
+            if args.json:
+                import json
+                print(json.dumps(stats, indent=2))
+            else:
+                print(f"Statistics: {args.image}")
+                print("-" * 35)
+                for k, v in stats.items():
+                    print(f"{k:12}: {v:.4f}")
+                    
+        elif args.command == "transform":
+            img = ImageMatrix.from_file(args.image)
+            if args.grayscale:
+                img = img.to_grayscale()
+            if args.rotate:
+                img = rotate(img, args.rotate)
+            if args.flip_h:
+                img = flip_horizontal(img)
+            if args.flip_v:
+                img = flip_vertical(img)
+            img.save(args.output)
+            print(f"Saved: {args.output}")
+            
+        elif args.command == "resize":
+            img = ImageMatrix.from_file(args.image)
+            img = resize(img, (args.width, args.height))
+            img.save(args.output)
+            print(f"Resized to {args.width}x{args.height}: {args.output}")
+            
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+    
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())